Keys BuddyReturn to site

Desktop manual

Rack up, then play.

Keys Buddy is a live keys rack: SoundFonts and plugins layered across one keyboard, saved as a rack, recalled in a press. Here is the whole thing, in the order you will need it.

Install. Connect. Make sound.

The desktop edition runs on macOS and Windows. Choose your download from the website, then keep the app and its resources together.

macOS
Download the Apple silicon or Intel DMG for your Mac. Open it, drag Keys Buddy into Applications, then launch the app from Applications. The desktop Mac release supports macOS 13 or later.
Windows
Download the 64-bit Windows ZIP, extract the entire archive to a folder, and open Keys Buddy.exe from that folder. Keep its DLLs, resources and other extracted files together; the executable needs them beside it.
Connect audio and MIDI
Connect your keyboard and audio interface before opening the set. In Settings → Audio & MIDI, choose your output and enable the keyboard's input. Play a note and check the MIDI indicator before loading your sounds.
Save your work
Save Rack in Live saves the current rack; Racks → Store As creates a named copy. Command-S on macOS or Ctrl-S on Windows saves the rack. Save Snap updates a snap inside the current rack; save the rack afterwards to keep that change on disk.

Six steps to a rack that plays.

Start to finish in about five minutes, assuming you already have a SoundFont on the machine. Everything after this section is reference.

  1. Step 01

    Give it sounds

    Open Sounds and choose Import SoundFont to copy an .sf2 or .sf3 into the managed library, or Add source folder to index a folder where it already lives. Importing is the safer default: the file stays put and stays findable.

  2. Step 02

    Start a rack

    A rack is one saved rig: every track, sound, effect, split and snapshot in one file. Go to Racks and press New, then move to Live and press + Add track.

  3. Step 03

    Fill the track

    Click the track’s instrument area to pick a SoundFont preset or a VST3 instrument (Audio Units are also available on macOS). Open MIDI FX for an arpeggiator, step sequencer, octave-up or Easy Chord, and Inserts for effects after the instrument.

  4. Step 04

    Split the keyboard

    In Layers, drag either end of a track’s bar to set its key range, or set the low and high notes from the two dropdowns. Track Transpose shifts one track in semitones; the Transpose control in the header moves everything at once.

  5. Step 05

    Set your snapshots

    Back in Live, balance the faders for a section of the song, then press + to capture a new snap. Use Save Snap to update the selected snap. Up to six snaps per rack, each holding volume, pan, mute, solo and sends. Selecting one fades the mixer across instead of jumping.

  6. Step 06

    Save and map

    Racks → Store As names the rack; Save overwrites it from then on. Then press the keyboard icon in the header for MIDI Learn and put the controls you need on the hardware in front of you.

The header runs the set. The sidebar builds it.

Keys Buddy running a Sunday rack with Intro, Verse, Chorus, Bridge, Piano and Ambient snaps; Ambient is selected, four of five tracks are visible, and the master strip and ambient pads sit beside and below the mixer
The running desktop app with the Sunday rack loaded: six snaps, five tracks reached by the pager, and Ambient selected. The sidebar opens Live, Racks, Sounds, Layers, Output and Settings.
Transpose
Moves every track up or down in semitones, without touching each track's own transpose.
Tempo and Tap
One shared BPM for arpeggiators and step sequencers. Tap it in if you do not know the number.
Status line
What just happened: the rack that loaded and how long it took, the SoundFont count, the last delete.
Audio and load
The active output device, CPU use, SoundFont memory, and how many of the 16 track slots are filled.
MIDI CC readout
The last controller message received, so you can confirm a knob is actually reaching the app.
MIDI Learn
The keyboard icon. Turns on learn mode, where clicking a highlighted control arms it for mapping.
Settings
The gear: audio device, MIDI inputs, plugin scanning, saved mappings, fade times and licence.
Panic
Kills every stuck note and voice. Reachable at all times, and mappable to a footswitch.

Find your way around.

Use Live for the set, Racks and Sounds for your libraries, Layers for the keyboard, Output for the final mix and shared effects, and Settings for your devices and preferences.

Racks

Your library of saved rigs, and everything you do to them between sets.

New and Store As
New clears the rack. Store As saves the current one under a name; Save overwrites it afterwards. Keys Buddy warns before replacing a rack that has unsaved changes.
Load Rack
Loads the selected rack. Sounds and instruments come back first so the rack is playable before the effects finish restoring.
Search and Favorites
Search by name, or tap the heart and filter to Favorites. The list shows saved tempo and when each rack was last touched.
Duplicate, Rename, Delete
Duplicate before you experiment on a rack that already works.
Share
Writes a portable .kbpatch you can send to another player. It carries the settings, never the SoundFont files.
Import
Brings a .kbpreset or .kbpatch into the library. You can also drag either file straight onto the window, or open it from Finder or Explorer.

Sounds

Every SoundFont Keys Buddy knows about, indexed once and remembered.

Import SoundFont
Copies the file into Keys Buddy's own managed library. Recommended: managed files stay organised and are easy to relink later.
Add source folder
Indexes a folder in place, for libraries too large to copy or shared with other software. Folders are scanned in the background.
Search
Searches SoundFonts, folders and cached presets. Preset names are cached the first time a file loads, so later searches never reopen it.
All, Favorites, Missing
Missing filters to files that have moved or gone offline.
Find Missing in Folder
Points Keys Buddy at a folder and searches it and every subfolder. Locate Selected File relinks one exact file. Favorites and cached presets survive either.
First preset
Pick a preset from the dropdown to load it straight into a new track, without building the track first.

Live

The mixer, the snapshots and the pads. This is the page you leave open on stage.

Snapshots
Up to six per rack, across the top. + captures the current mixer; Save Snap updates the selected one. Set the transition speed under Settings → Performance → Snapshot fader speed.
Rename or delete a snap
Right-click the snap you want to change, or use the … button for the selected snap. Choose Rename Snap, type a non-empty name, then press Rename or Enter. Escape or Cancel leaves it unchanged. Delete Snap is available while more than one snap remains.
Track strips
Each strip shows the sound, MIDI FX, Inserts and Sends, plus pan, level, meter, Mute and Solo. The track-page buttons above the mixer reach tracks that do not fit in the current view. Up to four MIDI effects and four inserts per track.
Inserts
Open Inserts to add installed plugin effects to that track. Audio passes through the inserts in order. Open a slot to edit it, or bypass, reorder and remove effects from the chain. For built-in effects, use Sends to route the track to Bus 1–4, then choose the effect under Output.
Sends
Open Sends, assign a slot to Bus 1–4, and set its level. Post fader follows the track level; Pre fader takes the signal before the fader. Enable the send and configure its destination under Output. Each track has four send slots.
Add track
Up to 16 tracks in a rack. Dropping SoundFont files on the window creates a track for each, up to the free slots.
Master strip
The fader, meter and Mute at the right of Live control the whole rack. Open Output in the sidebar for master inserts and the shared effect buses.
Live pads
Folder points at a folder of key-named recordings. Choose a key, choose a version, set the level, press Play. Loops seamlessly and crossfades when you change key.
Show Keys
Shows or hides the piano, pitch bend and mod wheel under the mixer, for when you want the screen back.

Layers

Where every track sits on the keyboard, seen all at once.

Key range
Each track is a bar over the keyboard below. Drag either end, or set the low and high note from the dropdowns. Reset All Key Range puts everything back to full range.
Track Transpose
Shifts one track in semitones, so a bass patch can sit an octave down under the same hand.
The keyboard
Click it to audition a sound with no hardware connected, and watch played notes light up while you rehearse. Both behaviours can be switched off in Settings.

Output

The output stage, kept separate from the per-track work.

Master inserts
Effects across the whole rack, in the order you place them. Bypass, reorder, edit or remove without losing their saved state.
Output controls
Master volume, pan, mute and mono, with metering. Mono is there for the times the house takes one input.
Shared effect buses
Four buses receive the track sends. Each has a return level, meter, mute and four effect slots in series. Choose built-in effects such as Ambient, Stereo Delay, Parametric EQ, Compressor, Room Reverb, Hall Reverb, Chorus, Tremolo, Rotary Speaker, Shimmer Reverb or Ping-Pong Delay. The return feeds the master output.
Bus controls
Choose an effect, adjust its named parameters and Mix, and use bypass to compare it with the untreated signal. Scroll the Output page to reach all four buses. Save the rack to retain bus settings.

Settings

Audio, MIDI, performance preferences and support tools.

Audio & MIDI
Select the audio output, sample rate and buffer size, enable your MIDI inputs, scan plugins and manage MIDI mappings. On Windows, choose your interface's ASIO driver when available in the build.
Performance
Set Snapshot fader speed and Live pad fade in / out. Show played keys controls note highlighting; the clickable-keyboard option controls whether clicking the piano sends notes.
Appearance
Choose a theme or adjust the app colours.
Privacy and Account
Privacy controls optional usage analytics and links to legal information. Account shows the desktop edition and account state.
About & diagnostics
Check the app version, open the third-party licences, and review a diagnostic report. Copy or save the reviewed report when contacting support.

What matters once the room is full.

The parts of Keys Buddy worth learning before a set rather than during one.

Map it once

Press the keyboard icon in the header. Mappable controls highlight; click one, then move a knob or press a note. The header tells you what it is waiting for. Track and master levels, mutes, solos, snaps, pads, transpose, tempo and Panic can all be learned. Review or clear mappings under Settings.

Change the whole rig at once

Snaps are the fastest thing in the app. Build one per section, map them to buttons, and a verse-to-chorus change is one press instead of four fader moves. Continuous controls fade rather than jump, so the change lands under the music.

Keep a floor under the room

Point the pads at a folder of key-named loops and Keys Buddy sorts them by key for you. Name each file with its key: C, Db, F#. Add a number for alternate takes, like C 2. Sharps, flats and the ♯ / ♭ symbols are all understood.

When a note sticks

Panic sits in the top right and silences every voice. A dropped MIDI cable or a sustain pedal pulled mid-note is the usual cause. Map it to a footswitch before you need it.

Send a rack to another player

Share writes a .kbpatch. It records which SoundFonts the rack needs by name, size and hash, so the receiving copy of Keys Buddy matches them against sounds already imported and asks only about the ones it cannot find.

Before the first set

Set the audio device and buffer size under Settings, scan plugins there once so a bad plugin cannot take the app down mid-scan, and load your rack early: the status line reports the load time so you know what to expect at soundcheck.

Get back to playing.

Start with the MIDI indicator and audio output, then work through the signal path.

No MIDI activity
Check the keyboard's connection and power, then enable its input in Settings → Audio & MIDI. The MIDI indicator should react to notes or controllers. A MIDI mapping uses the device and message it learned; learn it again if your controller changed.
MIDI arrives, but no sound
Check the selected audio output, master and track Mute, Solo, and levels. Confirm the track has a loaded sound and that its Layers key range includes the notes you are playing. A missing SoundFont needs relinking from Sounds.
Crackles or delayed notes
In Audio & MIDI, adjust the buffer size for your interface: a larger buffer can reduce dropouts, while a smaller one reduces playing delay. Watch CPU usage and bypass demanding effects to isolate a problem.
A send has no effect
Assign the send to a bus, enable it and raise its level. In Output, check that bus's return level and mute, then choose an effect in one of its slots. Use Post fader when you want the effect level to follow the track fader.
A plugin is missing
Scan plugins in Settings → Audio & MIDI and check that the plugin is installed for this platform. macOS Audio Units do not load on Windows. Sharing a rack carries plugin settings, not the plugin installers.
A note will not stop
Press Panic to silence the voices, then check sustain and the MIDI connection. You can MIDI-learn Panic to a hardware control before the set.
Report a problem
Open Settings → About & diagnostics, review the diagnostic report, then copy or save it. Email support@joshaquino.com with what you were doing, your app version and the reviewed report.

Files and limits.

Rack files
Racks saved in the library are .kbpreset. Racks shared with other players are .kbpatch. Both can be dragged onto the window or opened from the desktop.
What a shared rack carries
Tracks, mixer state, MIDI settings, effects and their parameters, tempo, transpose and snaps. It never bundles the SoundFonts, and third-party instruments and effects must already be installed on the receiving machine.
Missing files
A rack with a missing SoundFont still opens. Relink the file and everything else stays exactly as it was.
Sound formats
SoundFonts: .sf2 and .sf3. Pads: WAV, AIFF, FLAC, Ogg, MP3 and the other formats the audio engine supports.
Instruments and effects
VST3 on macOS and Windows, Audio Units on macOS. Plugins are scanned outside the main process, so a plugin that fails to scan does not take Keys Buddy with it.
Audio
CoreAudio on macOS. WASAPI and DirectSound on Windows, with ASIO available in builds made against the Steinberg SDK. Device, sample rate and buffer size are all selectable.
16tracks per rack
6snapshots per rack
4insert effects per track
4MIDI effects per track
4send slots per track