Box Of Synths manual

Box Of Synths manualSettings

Settings: Control

How new synths start, what Raw dog it starts from, how the controls move, and how MIDI learn works.

The Control tab is about how the app behaves under your hands: the defaults a new synth starts with, the feel of the controls, a few behaviour switches, and MIDI.

Settings: Control Click any numbered part of the picture to read what it does.
The Control tab of Settings, with the Poly key and four defaults dials, Factory reset, template keys, four motion feel dials, behaviour switches, a limiter switch and a MIDI learn key.
  1. 1Poly or MonoKey

    Click to flip between Poly and Mono. The key shows what a new synth starts as: Poly plays chords, Mono plays one note at a time.

    Starts as
    Poly

    It applies to the first sound and to every new synth. It does not change a sound you already have.

  2. 2AttackDial

    How fast a new synth's notes come up. Drag the dial.

    Options

    0.5 to 2000 ms

    Starts as
    5 ms
  3. 3ReleaseDial

    How long a new synth's notes take to die away.

    Options

    5 to 5000 ms

    Starts as
    200 ms
  4. 4GainDial

    A new synth's own level.

    Options

    -36 to +12 dB

    Starts as
    0 dB
  5. 5OutputDial

    What leaves a new synth.

    Options

    -36 to +6 dB

    Starts as
    0 dB
  6. 6Factory resetKey

    Puts the five new-synth defaults back to the factory values: Poly, 5 ms, 200 ms, 0 dB, 0 dB. It does not touch Motion feel.

  7. 7Starting templateKey

    Opens a file chooser headed Starting template. Pick a patch file (.json) and Raw dog it starts from that sound instead of the plain init patch.

  8. 8Default templateKey

    Clears your starting template, so Raw dog it starts from the plain init patch again. It is dimmed when no template is set.

  9. 9Template captionDisplay

    Shows the file name of your starting template, or The plain init patch. when none is set.

  10. 10RiseDial

    How fast a pressed key reaches the top. Double-click to return it to the value it had when the window opened.

    Options

    30 to 300 ms

    Starts as
    90 ms
  11. 11HangDial

    The hold at the top. This is what makes a key feel snappy. Double-click to return it to the value it had when the window opened.

    Options

    0 to 200 ms

    Starts as
    55 ms
  12. 12SettleDial

    The fall back after the hold. Double-click to return it to the value it had when the window opened.

    Options

    40 to 400 ms

    Starts as
    130 ms
  13. 13MagnetDial

    How far outside a control still counts as hitting it, so small controls are easier to grab. Double-click to return it to the value it had when the window opened.

    Options

    0 to 16 px

    Starts as
    7 px
  14. 14Reduce motion noteDisplay

    Reminds you that Reduce motion in the Appearance tab dims these four dials and turns the glides off. See Settings: Appearance and themes.

  15. 15Auto-load designsSwitch

    When on, each design lands on the synth as it arrives. When off, the design is still saved as a version but does not go onto the synth until you click Load on its row in the version list.

    Starts as
    On
  16. 16Click slider to resetSwitch

    Changes what a click on the name or the value of a slider does. Off: the name takes the slider to its lowest end, the value to its highest. On: the click puts the slider back to the design's value. Alt-click always puts it back to the design's value.

    Starts as
    Off

    It applies to the glide and volume envelope sliders.

  17. 17Limiter anti-popSwitch

    When on, the limiter eases in so it does not pop. Turn it off to disable that fix. It takes effect while you listen.

    Starts as
    On
  18. 18MIDI learnKey

    Opens a menu to map a MIDI controller to a synth control or a macro. The steps are in the MIDI section of the page text.

New synth defaults

These five settings decide what a new synth starts as. They apply to the first sound and to every new synth. They do not change a sound you already have.

Setting What it sets Range Starts as
Poly or Mono key Poly plays chords. Mono plays one note at a time. Click to flip it. Poly, Mono Poly
Attack How fast a new synth's notes come up. 0.5 to 2000 ms 5 ms
Release How long a new synth's notes take to die away. 5 to 5000 ms 200 ms
Gain A new synth's own level. -36 to +12 dB 0 dB
Output What leaves a new synth. -36 to +6 dB 0 dB

Drag a dial to change it. Attack and release are not spread evenly: the short times take more of the turn, so small changes are easy. Factory reset puts all five back to Poly, 5 ms, 200 ms, 0 dB and 0 dB. It does not touch Motion feel.

Set how new synths start, step by step

Walkthrough Set how new synths start
  1. 1Pick Poly or Mono

    Click the key to flip between Poly and Mono. New synths start as what it shows.

  2. 2Set the envelope

    Drag Attack and Release to the times you want new notes to start with.

  3. 3Set the levels

    Drag Gain and Output. They set the level of every new synth.

  4. 4Start again if you want

    Click Factory reset to put all five defaults back to Poly, 5 ms, 200 ms, 0 dB and 0 dB.

Raw dog it starts from

Raw dog it is one way to start a new sound. By default it starts from the plain init patch. You can start it from a sound of your own instead. See Starting a new sound.

  • Starting template opens a file chooser headed Starting template. Pick a patch file (.json) and Raw dog it starts from that sound.
  • Default template clears your choice, so Raw dog it starts from the plain init patch again. It is dimmed when no template is set.
  • The line under the keys shows the file name of your template, or The plain init patch.

Motion feel

Four dials set how the controls move. They apply while you drag, and they are saved when you let go. Double-click a dial to return it to the value it had when the window opened.

Dial What it does Range Starts as
Rise How fast a pressed key reaches the top. 30 to 300 ms 90 ms
Hang The hold at the top. This is what makes a key feel snappy. 0 to 200 ms 55 ms
Settle The fall back after the hold. 40 to 400 ms 130 ms
Magnet How far outside a control still counts as hitting it, so small controls are easier to grab. 0 to 16 px 7 px

The dials are dimmed when Reduce motion is on in the Appearance tab. The line under them says so: Reduce motion in Appearance disables these controls. See Settings: Appearance and themes.

Behaviour

  • Auto-load designs (on to start with): each design lands on the synth as it arrives. Turn it off and the new design is still saved as a version, but it does not go onto the synth: it waits in the version list until you click Load on its row.
  • Click slider to reset (off to start with): changes what a click on the name or the value of a slider does. Off, the name takes the slider to its lowest end and the value takes it to its highest. On, the click puts the slider back to the design's value. Alt-click always puts it back to the design's value. It applies to the glide and volume envelope sliders. See How dials, sliders and keys behave.

Audio

Limiter anti-pop (on to start with): the limiter eases in so it does not pop when the sound starts. Turn it off to disable that fix. It takes effect while you listen.

MIDI

MIDI learn maps a MIDI controller to a control on the synth or to a macro.

How to learn a control

  1. Click MIDI learn. A menu opens under the key.
  2. Pick the target. Every group of controls is a sub-menu, and the active synth's macros are in a Macros sub-menu. Each item shows its state: MIDI with the channel and controller number and the last value, MOVE a MIDI control, or Not learned.
  3. The target's menu item now reads MOVE a MIDI control. Move the knob or fader on your controller.
  4. The first controller you move is bound to the target. The bound controller then moves that control from 0 to 100 percent.

To cancel before moving anything, open the menu and choose Cancel MIDI learn. The target goes back to Not learned. To remove every mapping, choose Clear MIDI mappings.

What to know

  • Learning applies to the active synth.
  • Controller numbers 0 to 119 work, on any of the 16 channels. Numbers from 120 up are ignored.
  • You can hold up to 64 mappings.
  • Learning the same target again replaces its old mapping.
  • Mappings are saved with your session, not in the settings file.