A cross-DAW MIDI-effect plugin that plays two-hand piano and organ
in the style of the greats — locked to your transport.
PianoMuse plugin interface
User Manual  ·  Version 1.0.0
VST3 · Audio Unit  |  Windows & macOS
© Simply Bass Productions

Contents

  1. 1What PianoMuse is
  2. 2Installing
  3. 3Quick start (3 steps)
  4. 4The interface at a glance
  5. 5Source modes
  6. 6Building a song
  7. 7The chord selector
  8. 8Styles & the feel knobs
  9. 9Two hands, voicings & pedal
  10. 10Drag-MIDI — export & import
  11. 11Sharing: styles, songs, bundles
  12. 12Using PianoMuse in your DAW
  13. 13Pro Tools
  14. 14Troubleshooting
  15. 15Appendix & reference

1   What PianoMuse is

PianoMuse is a MIDI-effect plugin. It reads MIDI (chords) and writes MIDI (a part). It makes no sound of its own — its output feeds an instrument of your choice. In every host the job is the same:

chords  →  PianoMuse  →  an instrument

You give PianoMuse a chord progression — typed into its built-in grid, or played live into its MIDI input — pick a style, and it generates a musical part that stays locked to the host tempo and transport.

Two ways to drive it

Deterministic engine. The same progression, style and seed always produce the same notes — so a part you like is reproducible, and you can nudge the Seed to roll a fresh variation.

What's in the box

2   Installing

Windows

  1. Run PianoMuse-1.0.0-Setup.exe.
  2. It installs the VST3 to C:\Program Files\Common Files\VST3\PianoMuse.vst3 — the folder every DAW scans.
  3. Accept the license agreement, then continue.
  4. Launch your DAW and rescan plug-ins if it doesn't appear automatically.

macOS

  1. Open PianoMuse-1.0.0.pkg, accept the license agreement, and follow the installer.
  2. It installs both formats system-wide:
    • VST3 → /Library/Audio/Plug-Ins/VST3/PianoMuse.vst3
    • Audio Unit → /Library/Audio/Plug-Ins/Components/PianoMuse.component
  3. Logic Pro and Luna use the AU; most other Mac DAWs can use either.
Unsigned build note. Until code-signing certificates are added, Windows SmartScreen may show “unknown publisher” (choose More info → Run anyway) and macOS Gatekeeper may need right-click → Open the first time. This is expected and does not affect the plugin.

Formats by DAW

FormatHosts
VST3Reaper, Bitwig, Cubase, Studio One, FL Studio, Cakewalk Sonar, Mixbus, Digital Performer, Fender Studio Pro
Audio UnitLogic Pro, UAD Luna, and other AU hosts (macOS)
AAXNot yet — see §13 for Pro Tools workflows today

3   Quick start (3 steps)

The fastest way to hear PianoMuse, using Song mode:

  1. Insert PianoMuse before an instrument. Put PianoMuse and an instrument in the same signal path so PianoMuse's MIDI reaches the instrument. (Exactly how depends on your DAW — see §12. In Logic: PianoMuse in the track's MIDI FX slot. In Reaper: PianoMuse then the instrument in one FX chain.)
  2. Type a progression. In PianoMuse's Arrangement grid, click a chord cell and enter chords (e.g. C, Am, F, G) — or use the chord selector (§7).
  3. Pick a style and press Play. Choose a style from the dropdown, set Source = Song (grid), and start the host transport. PianoMuse plays the part through your instrument, in time.
No routing handy? Use Drag-MIDI (§10): drag the finished part straight onto a track as a MIDI clip — works in every DAW with zero setup.

To play along live instead

Set Source = Follow MIDI and send chords into PianoMuse's MIDI input (from a MIDI clip, a keyboard, or your DAW's chord track). PianoMuse plays under whatever chords it hears.

4   The interface at a glance

The editor is one window, top to bottom:

Top row — global controls

ControlWhat it does
SourceSong (grid) · Follow MIDI · Demo progression (§5)
KeyKey: Auto (detected from your chords) or force a major/minor key
Host BPMRead-out of the host tempo PianoMuse is locked to
FileSave / Load Song, Save / Load Bundle, Build arrangement, Clear Song, Follow section on play (§6, §11)
ReportSend a bug, idea or question to the feedback board (§14)
BypassSilences PianoMuse's output while it stays in the chain — a "mute" for the plugin. Saved with the song.
SeedRe-rolls the part; same seed = same notes
OctaveGlobal transpose in octaves
DrumDrum-lock amount, 0→1 (§9)

Selected Section — per-section settings

ControlWhat it does
NameLabel for the section (Verse, Chorus, …)
MeterTime signature for this section (4/4, 3/4, 5/4, …)
StyleWhich style plays this section
Density · Complexity · Swing · Humanize · Ghost · Legato The section's feel knobs (§8). Picking a style loads its default feel; adjust from there.

Arrangement — the chord grid

Styles & export

5   Source modes

The Source dropdown decides where PianoMuse gets its chords.

Song (grid)

Plays the arrangement you built in the grid — every section, its meter, style, feel and chords, in order, locked to the transport. This is the main mode for writing a part into a song.

Follow MIDI

Ignores the grid and plays under chords arriving at PianoMuse's MIDI input in real time. Hold a chord on a keyboard or feed a MIDI clip / chord track and PianoMuse follows it, using the first section's style and feel. The arrangement grid hides in this mode to keep the window compact.

Demo progression

A built-in looping progression so you can audition a style instantly without building anything. Great for comparing styles.

Tip. Style and feel in Follow and Demo modes come from Section 1 of your arrangement — set that section's style/knobs to shape the live sound.

6   Building a song

Sections

A song is a list of sections. Each section has its own time signature, style, feel, and bars — so a 4/4 Motown verse can be followed by a 3/4 prog bridge in a different style. Use + Section / − Section to add and remove them, and click a section band to select and edit it. A song always keeps at least one section, so − Section won't remove the last one (it flashes to say so). To wipe everything and start over, use File → Clear Song.

Quick song builder

File → Build arrangement… scaffolds a whole multi-section song in one step. Type a structure as Name:Bars tokens —

Verse:8 Prechorus:4 Chorus:8 Turn:4 Verse:8 Chorus:8

— or click a template (Pop, Verse/Chorus, AABA, 12-bar blues). PianoMuse creates all the named sections with those bar counts; new sections inherit the currently-selected section's meter, style and feel, and repeated names are auto-numbered (Verse 1, Verse 2). Choose Append to add to the current song, or Replace to clear it first — and Save current song… backs up the existing arrangement before you replace it.

Copy, paste & insert sections

Right-click a section band for the full set of actions:

Keyboard shortcuts (when the editor has focus): Ctrl/Cmd+C copy, Ctrl/Cmd+X cut, Ctrl/Cmd+V paste after, Ctrl/Cmd+D duplicate.

Bars & chords

Add bars with + Bar. Click any chord cell and type a chord symbol. PianoMuse understands a wide vocabulary:

More than one chord per bar

Set Grid to 1/8 or 1/16 and place chords on sub-beats. Each chord holds until the next; an empty cell holds the previous chord. In text form a bar looks like F@0 G@2 (F on beat 1, G on beat 3) or Am@0 Dm7@1.5 (change on the “and of 2”).

Style overrides — a different player per bar or chord

By default every bar plays in its section's style. You can override that for a single bar or even a single chord, so one passage takes a different voice while the rest of the section keeps its groove. The section's feel (density, swing, ghost, legato, …) still applies — only the style changes.

Overrides are saved with the song and travel in shared .pmsong files; if a recipient doesn't have that exact style, the bar falls back to the section style.

Silence — drop out a section or a bar

Sometimes the part should lay out — a rest bar, or a whole section that drops before a big return. You can silence either without deleting anything:

Silencing only affects output: the section keeps its place in time (the loop length and playhead are unchanged), and its chords, style and feel are all kept — so un-muting restores exactly what was there. A chord held into a muted bar simply resumes after it, and a note ringing into a drop is trimmed so the silence is clean. Mute is saved with the song, and both live playback and Drag MIDI to your DAW honour it. (Silencing an individual beat is planned for a later release.)

Keep the lead-out fill. A muted region's menu also has Keep fill when muted: turn it on and the part still plays that region's transition fill — the pickup run that leads into the next chord or section — while everything before it stays silent. It's the classic "drop, then a fill back in." The region dims a little lighter and reads MUTED (fill) (and keeps its F badge) so you can see the fill survives. Off by default, so a plain mute is complete silence; it only has an effect where a fill is actually defined (a section's last bar, or a bar with a Fill marker).

Key

Leave Key on Auto and PianoMuse detects the key from your chords (shown as “Key: C major”). Override it if you want a specific tonal centre — approach notes and walking lines respect the key.

Seed, octave & range

Seed rolls a new variation while keeping everything else fixed — click the dice button beside it to jump to a random seed, or the button to pick from the last 10 seeds you used (saved with the song). Octave transposes the whole part. Range (Low / High notes) folds every generated note by octaves to stay inside your instrument's playable window — handy when a sampled instrument has a limited range. All three are global to the song.

Live variation trigger

The Seed re-rolls the whole song between takes. The variation trigger does it live and per section: a MIDI note you choose re-rolls the pattern for whichever section the playhead is in, while the song plays — a "variation pad" for performing. The rest of the arrangement is untouched, and the new pattern lands cleanly on the next downbeat, never mid-bar.

Set it up under File → Variation trigger:

During playback, each tap steps to the next variation. It's deterministic: the same taps reproduce the same part, and the underlying song seed is untouched. The section's band flashes when a variation fires, and stays marked with a small ▲N badge for as long as it's on a variation — N is how many times you've re-rolled it, so you can see at a glance which sections are running a variation versus their base seed. Found one you love? File → Variation trigger → Bake current variations into song folds it into the saved song so it survives edits, saves and reloads (and clears the badges, since the variation becomes the section's seed). (Works in Song (grid) mode, where PianoMuse owns the sections.)

Browsing & reproducing variations. Hover a section's band to read out its effective seed and how it breaks down — base seed + baked bump + variation offset — so when a re-roll sounds great you can write the numbers down and get it back later. Two buttons by the arrangement, and , step the selected section back and forth through the variations you've stacked up, so you can audition them and settle on one before baking. Prefer to keep your hands on the controller? File → Variation trigger → Learn step-back note assigns an optional MIDI note that steps a variation back — the companion to the trigger that steps forward.

Keep it on its own track. The trigger note reaches the plugin through its MIDI input, so don't chain PianoMuse in series behind another MIDI-generating plugin (for example BassMuse, or a second PianoMuse). Each of these plugins replaces its MIDI output with the part it generates, so anything placed after it receives those notes instead of your controller — the trigger note (and live chords) never arrive and the tap does nothing. Give each plugin its own track fed straight from your controller, or route the controller to both in parallel rather than one into the other.

7   The chord selector

Instead of typing, click a chord cell to open the circle-of-fifths chord selector — a visual way to pick chords that stay in key.

Works in every host. The selector is drawn inside the plugin window (not a floating OS window), so it behaves correctly in Logic Pro and other AU hosts that confine plug-in windows.

8   Styles & the feel knobs

A style models a player's characteristics — register, rhythmic feel, harmonic vocabulary and articulation — rather than any copyrighted transcription.

Twenty piano and organ styles are built in. Each models a different keyboard player's approach — which hand does what, how the chord is voiced, the rhythmic feel and the touch on the pedal (see §9 for the two-hand engine behind them):

Style (dropdown label)Character
Prog Organ (Keys Emberson)Aggressive Hammond/Moog — hammering octave left hand, cluster voicings, fast scalar runs
Symphonic Prog (The Caped Wakesman)Cascading broken arpeggios, classical flourishes, open voicings, heavy pedal
Psych Organ (The Doorman)Combo organ with a left-hand keyboard-bass ostinato under bluesy quartal figures (no bassist)
Hard-Rock Organ (His Lordship)Distorted power-fifths, octave riffs, pounding left-hand octaves, no pedal
Space Rock (Rich Wrightly)Held, wide-spread ninth washes, pedal down, an open-tenth left hand
Synth-Pop (Smidge Allure)Machine-tight sequencer arpeggios over cold triads, octave bass, almost no jitter
Gothic Rock (Allen Lanyard)Moody and sparse — a held low root under open comping chords
Ambient Texture (Ricky Barberry)Barely any notes — slow rolled quartal washes, pedal permanently down, no left hand
Pomp Rock (Jeff Downstage)Bright octave-doubled block-chord stabs, anthemic, squarely on the grid, octave bass
Arena Metal (The Angel of Keys)Theatrical orchestral block chords, dramatic runs and rolled entrances, heavy octave bass
Rock Piano (Sir Elton Jaunt)Gospel-flavoured stabs with an octave-doubled top, grace notes, a solid root-fifth left hand
Piano Pop (Billy Joule)Broken-chord right hand over a rolling left hand, doo-wop changes, heavy pedal
Theatrical Rock (Freddy Mercuric)Grand rolled entrances, wide open voicings, operatic dynamics, chromatic flourishes
Soul-Funk Keys (Stevie Wander)Rootless upper-structure voicings, syncopated sixteenths, a jazz shell left hand, ghost notes
Gospel Blues (Ray Charlton)Hard shuffle, a stride left hand, triads with crushed blue notes, laid back
Melodic Pop Piano (Macca at the Keys)Singable triads with a countermelody top voice, a bouncing root-fifth left hand, gentle shuffle
Pop Soul Keys (Chrissy MacVine)Restrained electric-piano comping — everything held, the low root left to ring
Americana Piano (Randy Newmarch)Rolling broken triads, second-line shuffle, grace notes and rolled chords
Songwriter Rock (Donn Hensley)Deliberately plain — sparse open chords over a sustained root, sitting behind the vocal
Swamp Gospel (Leon Rustle)Heavy octave left hand, church chords, blues triplets, deep behind the beat, half pedal

The feel knobs

Each section has seven knobs. Picking a style loads its default feel; tweak to taste. They're per-section, so each part of the song can breathe differently.

KnobEffect
DensityHow busy the part is — more notes vs. more space
ComplexityChromaticism, walking and approach notes
SwingDelays the off-beat for a shuffle feel (0–0.5)
HumanizeLoosens timing and velocity so it feels played, not typed
GhostHow often notes drop to quiet ghost notes (0–1)
LegatoNote length within the beat — from short and detached to smooth and connected
FlowConnectedness — ties each note toward the next one across empty beats so the part holds and flows instead of leaving gaps (0 = detached, 1 = fully connected). Great for sparse or low-Density parts. Stops at chord changes. Each style sets its own default.
FillTransition fills — a short directional run into the end of the section, landing on the approach to the next chord. 0 = off, 1 = a busy run up to a full bar long; the run grows longer and busier as you raise it. By default it fires only on the last bar of each section (mid-section chord changes stay clean). Each style sets its own default.

Per-bar Fill markers. Want a fill somewhere other than the section end — say bar 4 and bar 8 of an eight-bar verse? Right-click any bar → Fill and pick Light, Medium or Heavy to force a fill there, or No fill here to suppress one the style would add. Choose Auto to hand the bar back to the style default. Each bar shows a small F badge that tells you what it will do at a glance: a solid amber F means the bar fills (brighter with the amount), a faint hollow F means it won't. Per-bar markers travel with the song — they're saved in your .pmsong and DAW session.

Fill direction. A fill can run up or down into the change. The Fill picker on the section row sets the direction for the whole section: Auto heads the shortest way toward the next chord (the default), Up always ascends, and Down always descends — the run still lands on the same approach note either way. Each style carries its own default direction, and you can override a single bar from its right-click Fill direction menu (Follow style hands the bar back to the section setting).

Tip. Hover any knob, button or menu for a one-line reminder of what it does. Prefer a cleaner view? Turn the hints off with File → Show tooltips.
Updates. PianoMuse checks for a newer release on load and shows an amber Update to v… button in the header when one is out. To help test prereleases, tick File → Get beta updates and it will follow the beta channel (the button reads … (beta)); leave it off to track stable releases only.

You can also make your own styles as plain-text .pmstyle files — see §11 and the Appendix.

9   Two hands, voicings & pedal

PianoMuse is a two-hand engine. It generates a left hand and a right hand as two independent note streams and merges them into one MIDI output, so a style is really two performers working together — a bass/comping left hand and a melodic/chordal right hand. Each style picks a left-hand mode, a right-hand mode, a voicing and a register for each hand.

Left-hand modes

The left hand is an instrument of its own: it can hold a root, walk a bass line, stride, or carry the whole bottom end when the band has no bassist. Whichever mode a style uses is realised against the current chord, so the harmony always stays correct.

ModeWhat it plays
NoneSilent — right hand only
Sustain rootOne held root per chord (ballad / pad)
Root–fifthAlternating root and fifth
OctavesRoot doubled in octaves (rock / pomp)
ShellRoot + seventh (or third) — a jazz shell
StrideBass note on 1 & 3, a left-hand chord on 2 & 4
Walking bassA quarter-note walking line
OstinatoA repeating riff figure built from chord tones
Broken arpeggioA rolling broken arpeggio (gospel / Americana)
PadSustained low fifths and tenths

Right-hand modes

ModeWhat it plays
CompRhythmic chord stabs on the cell onsets
BlockFull block chords, the top voice moving melodically
ArpeggioOne voice at a time, cycling through the voicing
OstinatoA fixed short figure from the voicing, repeated
RunsMostly single-note scalar / arpeggio flourishes
PadOne sustained voicing per chord
RiffA unison / octave riff line on chord tones

Register windows

Each hand has its own register — a low / centre / high window in MIDI note numbers — nested inside the style's overall range. The defaults are a left hand around E1–B3 (centre ~G2) and a right hand around G3–G6 (centre ~E4); every style shifts these to taste (a pomp-rock style pushes the right hand up, an ambient style spreads both wide). Generated notes fold by octaves into their hand's window, so the two hands keep out of each other's way and the voicing sits where the player would put it.

Flow ties within a hand

The Flow knob (§8) ties each note toward the next attack across empty beats so a line holds instead of leaving gaps. In PianoMuse that tying happens within a hand: the left hand flows to the left hand's next note and the right hand to the right hand's, never across from one hand to the other, and — as with the bass — it stops at chord changes. So a sustained left-hand root can ring under a detached, articulated right hand, and each hand keeps its own sense of legato.

Voicings

The voicing decides how the right hand stacks the chord. Each style picks one; the same progression sounds completely different through close triads than through rootless upper structures.

VoicingHow the chord is stacked
CloseTones packed inside one octave
OpenDrop-2 — the second voice from the top dropped an octave
Rootless3-5-7-9 with no root (the left hand has it)
QuartalStacked fourths (modal / psychedelic organ)
ShellJust the third and seventh
TriadA plain three-note triad
FifthsRoot + fifth power voicing (hard-rock organ)
ClusterAdjacent seconds (aggressive prog)
SpreadWide — each voice in its own register

A style also sets how many notes a right-hand chord holds (a min and a max) and a spread chance that a voicing opens out on any given hit.

Voice-leading

Chord to chord, PianoMuse leads the voices smoothly rather than jumping to a fresh root-position shape each time. It octave-shifts the new voicing toward the previous one so the voices move the shortest distance, and it chooses an inversion that gives the top voice the melodic motion the style wants — the top-motion amount, set per style, controls how much that top line moves from one chord to the next (low for a static pad, high for a singing countermelody). The result is a connected part where the top voice reads as a melody and the inner voices barely budge.

Sustain pedal (CC64)

PianoMuse plays the sustain pedal for real, emitting MIDI CC64 alongside the notes, so a piano or Rhodes instrument that responds to the pedal rings and blurs the way it should. Each style carries a pedal amount — from never (dry, staccato organ and synth patches) up to repedal on every chord change (lush ballads and gospel). On a change the pedal lifts and re-presses cleanly, so held voicings sustain within a chord without smearing across the harmony. Point PianoMuse at an instrument with pedal response to hear it; a patch that ignores CC64 simply plays the notes.

Drum Lock (left hand)

The Drum slider biases the left hand's onsets onto your kick pattern, so the bottom of the keyboard locks up with the drums while the right hand keeps its own comping. At 0 the left hand plays its natural style groove; toward 1 it progressively lands on the kicks. Feed GM kick notes 35 / 36 on MIDI channel 10 into PianoMuse's MIDI input (chord-follow ignores channel 10, so live chords and kicks can share the input), then raise the slider. It reacts to MIDI kicks, not an audio drum track.

10   Drag-MIDI — export & import

The Drag MIDI to your DAW strip prints your whole arrangement to a standard .mid file. Press and drag it straight onto a track in your DAW (or into a folder) and drop — you get a MIDI clip of the part.

This is the universal fallback: it works in every DAW with no routing and no format concerns, and it bounces down perfectly since it's just MIDI on a track. Use it whenever live routing is awkward, or for Pro Tools (§13).

Reproducible. Because the engine is deterministic, the dragged-out MIDI is exactly what you heard — same seed, same notes.

Drag Chords — a chord track for piano/pad

Beside it, the Drag Chords to your DAW strip prints the arranger chords as sustained block-chord MIDI — drag it onto a piano, pad or synth track to comp under the part. It voices the full chord (extensions and all), spread across the mid register.

File → Chord drag: omit low root (on by default) leaves the low end to the part; turn it off to add a low root that anchors the chords on their own. The choice is saved with the song.

Just the selected section

The Selected section only toggle by the drag strips scopes both the Part and Chords drag-outs to the currently-selected section, rebased to start at bar 1 — the strip labels show the section name so you know what you'll drop. Turn it off to export the whole song as before.

Generate chords from dropped MIDI

The strips work the other way too: drag a MIDI clip out of your DAW and drop it on the arranger to turn it into chords. PianoMuse reads the harmony (from the most chordal track, so a single-note line playing alongside the chords doesn't throw it off), samples at the current Grid, collapses repeats, and writes the progression into the grid — so you don't retype chords you already have.

When you drop, a menu asks where the chords should land:

For a section or a from-measure target, if the clip is longer than the space it has, PianoMuse asks whether to clip it to fit (drop the extra bars) or extend — grow the section to hold the whole clip. Whole song and new-section grow to fit on their own, and PianoMuse still asks first before replacing chords that are already there.

Capture chords live from MIDI

Some DAWs won't let you drag a MIDI clip onto a plugin. For those, PianoMuse can read the chords as you play them instead. Turn on File → Capture chords from MIDI to arm capture, route a chord track (or your keyboard) into PianoMuse's MIDI input, and play. Each chord is timestamped against the transport; stop, and PianoMuse writes what you played into the grid — the same result as a drop, without the drag. The drum channel (10) and your variation-trigger note are ignored, so they never turn up as chords, and PianoMuse still asks before replacing chords that are already there.

11   Sharing: styles, songs, bundles

Everything PianoMuse saves is plain text — no packs, no samples, no recompiling. Three file types:

FileContainsSave / load with
.pmstyleOne styleImport Style / Export Style
.pmsongA whole arrangement (sections, meters, chords, styles by id)File ▸ Save / Load Song
.pmbundleA song plus every style it uses — fully self-containedFile ▸ Save / Load Bundle

Cross-product songs. File ▸ Load Song also opens BassMuse song files. The arrangement transfers — sections, chords, time signatures, per-bar fills and mutes — and PianoMuse applies its own styles, since the two plugins share one song format.

Where files live

Portability. Songs reference styles by id, so they stay small and shareable. If a recipient is missing a custom style, that section falls back to the first style — chords, meter and feel are unaffected. Send a bundle to guarantee they get everything in one file.

Rolling your own style

A .pmstyle is key = value lines with rhythm cell figures. You control register, swing, note-choice weights, velocity, articulation and feel. See the Appendix for the key list.

12   Using PianoMuse in your DAW

PianoMuse's Follow-MIDI code is the same everywhere — only the host routing differs. There are three patterns:

DAWFormatModelRouting in a nutshell
ReaperVST3 / AUAPianoMuse, then the instrument, in one track FX chain
BitwigVST3APianoMuse before the instrument in the device chain
Logic ProAUAPianoMuse in the track's MIDI FX slot
Mixbus 11VST3 / AUAPianoMuse then the instrument in the processor box
FL Studio 2024VST3AWire chords → PianoMuse → synth inside Patcher
Waveform 14 (Tracktion)VST3 / AUAPianoMuse then the instrument in one track's plugin chain
Cubase 15VST3BInstrument + MIDI-out route (no VST3 MIDI-insert)
Cakewalk SonarVST3BEnable plugin MIDI-out, MIDI track → instrument
Studio One 7VST3BTrack B Instrument Input = PianoMuse ⚠ real-time export
Fender Studio Pro 8VST3BTrack B Instrument Input = PianoMuse ⚠ real-time export
Digital PerformerVST3 / AUBPianoMuse instrument → MIDI out to a 2nd instrument track
UAD Luna ProAUBInstrument track MIDI-out → instrument track
Pro ToolsAAX ✗CImport the .mid, or a VST→AAX bridge (§13)
Model-B export caveat. In Studio One and Fender Studio, routed MIDI is dropped on an offline bounce and adds a little latency. Export with Real-Time Processing on, or just use Drag-MIDI.
Cubase. Cubase won't list a JUCE VST3 MIDI-effect as a MIDI Insert (a host/JUCE limitation, not a setting). Use Model B: load PianoMuse as an instrument, enable its MIDI out, and route into the instrument. Cubase's Chord Track is excellent for feeding Follow mode.
Chord Tracks & Follow mode. Cubase can route its Chord Track as MIDI directly into PianoMuse's Follow input. Studio One and Fender Studio's Chord Track is a Follow Chords reference — it re-pitches events on tracks that follow it, and does not emit a routable chord stream. So there, either feed PianoMuse real chord MIDI (a clip or live playing on the track routed into it), or put chords on a track with Follow Chords enabled and route that track into PianoMuse. Song mode (PianoMuse's own grid) sidesteps the issue entirely.

Waveform 14 (Tracktion) — step by step

Waveform runs a left-to-right plugin chain per track and passes MIDI down it, so PianoMuse and the instrument live on one track (Model A). The signal path is chords → PianoMuse → instrument.

  1. Add a track — a normal track.
  2. Drop PianoMuse (VST3) into the track's plugin chain.
  3. Add an instrument to the right of PianoMuse in the same chain — Waveform's Collective or 4OSC, or any VSTi. Order matters: PianoMuse must sit before (left of) the instrument so its MIDI reaches it.
  4. Set your chords. Song mode (PianoMuse's own grid) is simplest and needs no routing. For Follow mode, put a chord MIDI clip on the same track ahead of PianoMuse in the chain, or play chords live into the track.
  5. Press Play. PianoMuse locks to Waveform's transport and plays the part through the instrument, in time.
  6. Optional — if nothing plays: drop a MIDI clip on the track spanning your arrangement. An empty clip is enough to keep the plugin chain processing.

Simplest alternative: skip the routing — use Drag-MIDI (§10) to drag PianoMuse's part straight onto the instrument's track, then press Play.

Cakewalk Sonar — step by step

PianoMuse and the instrument are two separate tracks — PianoMuse emits MIDI, the instrument makes the sound.

Pitfall. Do not drop the instrument into PianoMuse's FX bin — that bin is for audio inserts, and PianoMuse's audio output is silent by design, so an instrument placed there gets nothing. Likewise, dragging the MIDI onto PianoMuse's own track feeds it into PianoMuse, not the instrument.
  1. Instrument track — insert your instrument as its own Instrument track; confirm it makes sound when you play notes on it.
  2. PianoMuse track — insert PianoMuse as an instrument. In Views ▸ Synth Rack, right-click PianoMuse ▸ Enable MIDI Output.
  3. MIDI relay track — add a MIDI track; set Input = PianoMuse (MIDI Output) and Output = the instrument.
  4. Turn on that MIDI track's Input Echo so MIDI passes through live.
  5. Press Play. In Song/Demo source PianoMuse generates on its own; in Follow source, feed chords to PianoMuse's track (Sonar's Chord dock works).

Simplest alternative: skip the routing — drag PianoMuse's MIDI straight onto the instrument's track (not PianoMuse's) and press Play.

13   Pro Tools

Pro Tools speaks AAX only and won't show PianoMuse's VST3 or AU yet. Two workflows cover Pro Tools today:

Path 1 — import the MIDI (most reliable, no purchase)

  1. Produce a .mid: use Drag-MIDI (or Save) from PianoMuse in any other DAW you own.
  2. In Pro Tools: File ▸ Import ▸ MIDI… (or drag the file in) onto an Instrument track that has an instrument.
  3. Native playback and mixdown — no routing, no bridge.

Path 2 — VST→AAX bridge (real-time)

  1. Insert a bridge such as Blue Cat PatchWork (AAX) or DDMF Metaplugin on a Pro Tools Instrument track.
  2. Inside it, load PianoMuse (VST3) then an instrument (VSTi).
  3. Route PianoMuse's MIDI out → the instrument's MIDI in.
  4. Feed chords to the track; Follow mode and Song mode both play.

A native AAX build (listed directly in Pro Tools) is planned for a future release.

14   Troubleshooting

SymptomFix
Plugin doesn't appearRescan plug-ins in the DAW. Confirm it installed to the system VST3 / Components folder (§2). On Mac, Logic/Luna need the AU.
No soundPianoMuse makes no audio itself — its MIDI must reach an instrument. Check the routing for your DAW (§12).
Part doesn't move / nothing playsIn Song mode add chords to the grid. In Follow mode make sure chords actually reach PianoMuse's MIDI input.
Not in timePianoMuse locks to the host transport — press Play in the DAW; check Host BPM reads your tempo.
Drum-lock does nothingSend kick MIDI on channel 10 (notes 35/36) into PianoMuse and raise the Drum slider (§9). Audio drums won't drive it.
Bounce is silent / late (Studio One, Fender Studio)Export with Real-Time Processing on, or use Drag-MIDI (§10).
“Unknown publisher” warningExpected on unsigned builds: Windows More info → Run anyway; macOS right-click → Open (§2).
Shared song missing a styleThat section falls back to the first style. Ask for a bundle (§11), which includes every style.

Report a problem or request a feature

Click Report in the plugin header — it opens a short form and auto-fills your PianoMuse version, OS and DAW — or visit the feedback page. Your bug, idea or question goes on the feedback board, where other owners can upvote it.

You'll be kept in the loop. When we update the status of something you submitted — Planned, In progress, Fixed, Declined, or No action required — PianoMuse emails you at your account address, so you don't have to keep checking back.

15   Appendix & reference

File locations

ItemPath
VST3 (Windows)C:\Program Files\Common Files\VST3\PianoMuse.vst3
VST3 (macOS)/Library/Audio/Plug-Ins/VST3/PianoMuse.vst3
AU (macOS)/Library/Audio/Plug-Ins/Components/PianoMuse.component
User stylesDocuments/PianoMuse/Styles/*.pmstyle
User songsDocuments/PianoMuse/Songs/*.pmsong

.pmstyle keys — the full dial reference

Every dial a style can set, with its range and built-in default. A PianoMuse style describes both hands, the voicing and the pedal. Eight are live controls in the plugin — the knobs Density, Complexity, Swing, Humanize, Ghost, Legato, Flow and Fill (all marked ); the rest are set only in the .pmstyle file. Export Style writes all of them, so exporting a built-in player gives you a complete, editable template. Unknown keys are ignored, so the format is forward-compatible.

KeyRange · defaultWhat it does
Identity
idtextUnique id a song uses to reference the style
nametextLabel shown in the Style dropdown
Register (MIDI note numbers) — overall, then per hand
centerPitch0–127 · 60Home register for the whole performance
lowPitch0–127 · 36Lowest note allowed overall
highPitch0–127 · 88Highest note allowed overall
lhLow / lhCenter / lhHigh0–127 · 28 / 43 / 59Left-hand register window (low, home, high)
rhLow / rhCenter / rhHigh0–127 · 55 / 64 / 91Right-hand register window (low, home, high)
Hands & voicing
leftHandname · rootfifthLeft-hand mode: none · sustainroot · rootfifth · octaves · shell · stride · walking · ostinato · arpbroken · pad
rightHandname · compRight-hand mode: comp · block · arpeggio · ostinato · runs · pad · riff
voicingname · closeChord stacking: close · open · rootless · quartal · shell · triad · fifths · cluster · spread
voicesMin≥1 · 3Fewest notes in a right-hand chord
voicesMax≥1 · 4Most notes in a right-hand chord
spreadProb0–1 · 0.15Chance a voicing opens out (drop-2)
topMotion0–1 · 0.35How much the top voice moves chord to chord (the melodic top line)
Rhythm & density
density0–1.5 · 1.0Baseline busyness (also the Density knob)
lhDensity<0 or 0–1.5 · -1Left-hand busyness; < 0 follows the global density
swing0–0.5 · 0Delays the off-beat within a beat (also the Swing knob)
restProb0–1 · 0.05Chance any non-anchor onset is dropped (space)
ghostProb0–1 · 0Chance a note becomes a quiet ghost note (the Ghost knob)
cell = <onsets> | <weight>repeatableOne-beat right-hand rhythm figure + likelihood (see below)
lhcell = <onsets> | <weight>repeatableOne-beat left-hand rhythm figure (empty ⇒ derive from cell)
Feel (loaded into the knobs when the style is picked)
complexity0–1 · 0.5Chromaticism / passing tones / runs (Complexity knob)
humanize0–1 · 0.6Overall timing + velocity looseness (Humanize knob)
flow0–1 · 0.0Note connectedness — ties notes toward the next attack within a hand, stopping at chord changes (the Flow knob)
fill0–1 · 0.0Transition fill — a run into the section's last bar, landing on the approach to the next chord (the Fill knob). Per-bar markers override it.
filldir0/1/2 · 0Fill run direction: 0 = Auto, 1 = Up, 2 = Down
Note-choice weights (walking / riff lines & the moving top voice)
wRoot≥0 · 3.0Pull toward the chord root
wFifth≥0 · 1.5Pull toward the fifth
wOctave≥0 · 1.0Pull toward the octave
wThird≥0 · 0.8Pull toward the third
wSeventh≥0 · 0.6Pull toward the seventh
wApproach≥0 · 1.0Chromatic/scale approach into the next chord
wChromatic≥0 · 0.4Chromatic passing tone off the previous note
wScaleWalk≥0 · 0.8Step through the chord scale (walking)
octaveJumpProb0–1 · 0.10Chance of leaping an octave
approachOnChangeProb0–1 · 0.50Chance of aiming at the next root on a chord change
Pianistic gestures
rollProb0–1 · 0.0Chance a chord is rolled (arpeggiated on entry)
rollSpreadbeats · 0.06Time between voices of a rolled chord
graceProb0–1 · 0.0Chance of a crushed grace note a semitone under a chord tone
octaveDoubleProb0–1 · 0.0Chance the top voice is doubled an octave up
runProb0–1 · 0.0Chance a beat becomes a scalar/arpeggio flourish
runRatenotes/beat · 4.0Speed of notes inside a run (4 = sixteenths)
tremoloProb0–1 · 0.0Chance of a fast repeated/alternating figure
pedal0–1 · 0.0Sustain pedal (CC64): 0 = never, 1 = repedal on every chord change
Articulation
baseVelocity1–127 · 92Loudness centre
velRange≥0 · 14± velocity humanisation
lhVelscale · 0.95Left-hand velocity relative to baseVelocity
rhVelscale · 1.00Right-hand velocity relative to baseVelocity
staccato0–1 · 0.80Note length within the beat, as a fraction of its slot (the Legato knob)
accent = a b c dper beat · 6 0 2 0Velocity added on each beat of the bar
Micro-timing
timingJitterbeats · 0.010Random timing spread per note
behindBeatbeats · 0.000Constant push; positive = laid back, negative = on top

Rhythm cells

Each cell (right hand) or lhcell (left hand) is one beat wide; onsets are fractions of the beat in [0,1), and the weight after | is its relative likelihood:

cell   = 0                | 1     # a quarter note
cell   = 0 0.5            | 3     # two eighths, weight 3
cell   = 0 0.25 0.5 0.75  | 2     # four sixteenths
lhcell = 0                | 2     # left hand on the beat
lhcell =                  | 1     # a whole-beat rest (space)

Chord symbols PianoMuse understands

Roots A–G with #/b; qualities incl. m, 7, maj7, m7, m7b5, dim, aug, sus2/4; extensions 9 / 11 / 13; slash bass C/E. In text songs a chord may be positioned in the bar with SYM@beat (e.g. G@2).

PianoMuse v1.0.0  ·  VST3 & Audio Unit  ·  Windows & macOS. Styles model stylistic characteristics, not copyrighted transcriptions of any specific recording or performer.