Box Of Synths manual

Box Of Synths manualReference

Keys, clicks and gestures

Every keyboard shortcut, the keys that play notes from your computer keyboard, and every mouse gesture, with the Mac and Windows forms.

This page lists every key and mouse gesture that does something in the app. Where a key differs between systems, both forms are given: Cmd on a Mac is Ctrl on Windows, and Option on a Mac is Alt on Windows. For how dials and sliders move, see How dials, sliders and keys behave.

Keys that work anywhere

These work while the window has focus. A box you are typing in uses its own keys first, so Cmd+Z inside the chat box undoes your typing, not the sound.

Mac Windows What it does
Cmd+Z Ctrl+Z Undo the last change to the sound.
Cmd+Shift+Z or Cmd+Y Ctrl+Shift+Z or Ctrl+Y Redo.
Cmd+S Ctrl+S Opens a small dialog called Save this rack with the name of the sound filled in. Press Return to save it to your library, or Esc to cancel. Saving versions of a sound is automatic, so you do not need this to keep your work.
Cmd+K Ctrl+K Opens or closes the on-screen keyboard. It does nothing if Show the keyboard is off in Settings: Appearance and themes.
Space Space Plays or stops the preview pattern. It works unless the chat box has focus, where it types a space. See Browser: Preview.
Cmd+Return Ctrl+Return While the chat box does not have focus, opens the History tab with the cursor in its search box. It does not send a design.
Esc Esc Steps back out of whatever is open, one thing at a time. See the list below.

What Esc does

Esc does the first of these that applies.

  1. While a confirmation card is open, it cancels the card.
  2. While you are picking a dial to link an LFO to, it cancels the pick.
  3. It closes an open effect panel or macro detail.
  4. While the design sheet is up, it cancels the design if it is still working. Every other key is ignored until you press BACK.
  5. It closes Settings.
  6. It ends an effects-only request that you started from the effects.
  7. On a new, empty chat, it leaves that page and goes back to your synth.
  8. It closes the Preview tab.
  9. It leaves a full-window chat.

In the chat box

Key What it does
Return Sends your words. It sends with Cmd, Ctrl or Alt held as well.
Shift+Return Starts a new line.
Esc Does the same as above. On a new chat, it leaves that page.
Cmd/Ctrl+Z, X, C, V, A Undo typing, cut, copy, paste and select all inside the box.

In small boxes

Where Keys
The name, tags and family boxes on the header Return keeps what you typed. Esc cancels. Clicking anywhere else keeps it too.
The box that opens when you double-click a dial Only digits, a point, a minus sign and %, up to 12 characters. Return or a click away sets it. Esc cancels.
System dialogs such as Rename, Save this rack and Load from a URL Return is the main button. Esc is Cancel.
Confirmation cards Return is the main button. Esc, or a click outside the card, cancels.
Settings Esc closes the sheet. Text boxes save when you press Return or click away.

On a dial

Click a dial once so it has focus, then use the arrow keys.

Key What it does
Up or Right Raises the value by one step, which is one percent of the range or one notch on a stepped dial.
Down or Left Lowers it by one step.

Each press is one undo step.

Playing notes from your computer keyboard

Click one key of the on-screen keyboard first, so the keyboard has focus. Open the keyboard with Cmd/Ctrl+K or by clicking the thin strip. See The keyboard.

Keys Notes
A W S E D F T G Y H U J K O L P ; The notes from the key labelled C4 up to E5, in order: A is C, W is C sharp, S is D, E is D sharp, D is E, F is F, T is F sharp, G is G, Y is G sharp, H is A, U is A sharp, J is B, K is the next C, O is C sharp, L is D, P is D sharp and ; is E.

These keys play at full velocity. There are no keys to change octave. A text box takes the letters instead while you are typing in it.

Mouse gestures

Dials, sliders and keys

Gesture What it does
Drag a dial up or to the right Raises the value. Down or left lowers it. About 220 pixels cover the whole range.
Shift and drag Fine adjust, at about a fifth of the speed. On the depth of a link, Shift makes the drag four times finer.
Alt-click (Option-click on a Mac) Resets a dial, slider, the level fader or a transpose readout to its starting value, as one undo step.
Double-click a dial Opens a box to type an exact value. A number with % is a share of the dial's travel.
Click a slider The value goes to where you click. Click the name for the lowest value and the reading for the highest, unless Click slider to reset is on.
Ctrl-click a dial Opens a menu of the LFOs with a free slot, to link one to the dial.
Right-click a dial Opens the dial's own menu if it has one. If not, it opens the LFO menu.
Right-click and drag a dial Sets how far the sidechain input pulls the dial down. Alt right-click clears it.
Mouse wheel Scrolls the panel under the pointer. It never changes a dial.

Where a right-click has a menu

Where What the menu holds
Wave on an oscillator, Shape on an LFO, Sub wave Every choice, with the current one ticked. The bank waves are in families.
Phase check Optimise the phases.
Width on the level block Quiet, Calm, Present, Deep.
Amount on the pitch envelope What the sweep moves: Pitch, OSC 2, OSC 3 or FM.
An Analogue tile dial All twenty voices.
An effect tile Remove followed by the effect, and Generate this effect.
A macro card Nothing: a right-click removes the macro.
A link pill on an LFO Nothing: a right-click cuts the link.
A row in the history table Play or Stop, Load, Copy to new synth as v1.0, Move to new synth as v1.0, Delete from this history, Delete branch, Flatten branch....
The header of the history table A list of the columns to show or hide.
A sound in the Library tab MOVE TO: a folder, the top folder, or New folder....
A chat in the History tab Rename and Delete.
A key of the on-screen keyboard Save note as WAV... and Save note as MP3.... A right-click does not play the note. On a Mac, Ctrl-click does the same.

Titles, the waveform and the edges

Gesture What it does
Click a block title Folds or opens the block.
Click the waveform display Silences every note at once.
Drag the bottom edge of the waveform display Changes its height.
Drag the bottom edge of the Effects block Changes its height.
Drag the top edge of the chat block Changes its height.
Drag the top edge of the open keyboard Changes its height.
Click the thin keyboard strip Opens or closes the keyboard.
Click the name of the sound Edits the name.
Click the family word or the tags Opens the family menu, or edits the tags.
Hover over the logo and click Starts a new patch, after asking.

Notes, envelopes and drawing

Gesture What it does
Click or drag across keys of the on-screen keyboard Plays notes. Dragging slides from one note to the next. The harder you press toward the bottom of a key, the louder it plays.
Drag a corner of an envelope graph Changes that stage of the envelope. One drag is one undo step.
Drag a dot on a folded envelope Changes a time, or the sustain on the decay dot, without opening the block.
Drag a folded Transpose value Changes it. Alt-click resets it.
Press and drag across the harmonic bars Draws the amount of each partial.
Click the left or right half of the partials strip Takes away or adds one partial.
Click or drag along the level bar Sets the output level. Alt-click puts it back to 0 dB.
Drag a note up or down in the preview roll Changes that note's pitch.
Drop one file on the paperclip key Attaches it as context. It takes a PDF, text, Markdown or JSON file.
Gesture What it does
Double-click a macro card Opens its detail. Double-click again, or press Esc, to close it.
Drag a macro intensity track Sets how much the macro reaches that control. Double-click it to return to 100%.
Click the spark or the power glyph on a macro card Asks the designer to change that macro, or switches it off and on.
Drag the grip of an effect tile, or the tile itself Reorders it. Drop it on another tile to swap, or on an empty slot to move it.
Click the power glyph of an effect tile Switches that effect off and on.
Double-click an effect tile Opens its panel. Double-click it again to close just that one.
Click an empty effects slot Opens the add menu.
Click an empty + on an LFO Starts a pick: click the dial the LFO should move. Click on nothing to cancel.
Drag a link pill up or down Sets its depth. Shift for fine control. The depth snaps at 0.
Click the x on a link pill Removes the link.

The history, library and chats

Gesture What it does
Click a row in the history table Loads that version.
Drag a column header to another place Swaps the two columns.
Click a saved chat Opens it.
Double-click a chat Renames it in place.
Click a sound in the Library Loads it.