Box Of Synths manual

Box Of Synths manualStart here

Install and first run

What the installers put on your computer, how to remove them, the cards you meet the first time you open the app, and how to find and update Box Of Synths.

Box Of Synths comes as an installer from boxofsynths.com. One installer gives you the standalone app and the plugin formats for your system. This page covers the macOS and Windows installers, what you see the first time you open the app, and how updates reach you.

What you get

Pick the format your music program uses. If you are not sure, the standalone app works without any other program.

On macOS

Format What it is for Where it goes
Standalone app Runs on its own, with no music program. Good for trying the synth and for designing sounds. /Applications/Box Of Synths.app
AU plugin The Audio Units format, for music programs that load AU plugins. /Library/Audio/Plug-Ins/Components/Box Of Synths.component
VST3 plugin The VST3 format, for music programs that load VST3 plugins. /Library/Audio/Plug-Ins/VST3/Box Of Synths.vst3

On Windows

Format What it is for Where it goes
Standalone app Runs on its own, with no music program. Program Files\Box Of Rules\Box Of Synths\Box Of Synths.exe (you can change the folder during the install)
VST3 plugin The VST3 format, for music programs that load VST3 plugins. Common Files\VST3\Box Of Synths.vst3, inside Program Files

There is no AU plugin on Windows.

System requirements

  • macOS: version 10.13 or later. The installer accepts both Apple silicon and Intel Macs.
  • Windows: a 64-bit computer. The installer does not run on 32-bit Windows.
  • All systems: an audio output, so you can hear it. The standalone app also needs a way to play notes: a MIDI keyboard, or the on-screen keyboard. See The keyboard.

Install on macOS

The Mac installer is a single .pkg file. It has no options to choose, so there are no components to tick and no folders to pick.

  1. Open the downloaded .pkg file.
  2. The first page tells you what is being installed: the AU and VST3 plugins and the standalone app. It also says the app will ask where to keep your library the first time it opens. Click Continue.
  3. Follow the installer's remaining pages and click Install. macOS may ask for your administrator password, because the plugins go into the shared /Library folder.
  4. When the installer says it has finished, close it.

The installer puts the three items listed in the table above in exactly those places, for every user of the Mac. They cannot be moved during the install.

Remove it on macOS

There is no uninstaller. To remove Box Of Synths, move these three items to the Bin:

  1. /Applications/Box Of Synths.app
  2. /Library/Audio/Plug-Ins/Components/Box Of Synths.component
  3. /Library/Audio/Plug-Ins/VST3/Box Of Synths.vst3

Your library and your settings stay where they are. See Files and folders if you want to remove those too.

Install on Windows

The Windows installer is a single .exe file. It uses the usual Setup wizard.

  1. Open the downloaded .exe file. At the start it may ask whether to install for everyone who uses the computer or only for you, and Windows may ask you to approve the change.
  2. Choose the install folder. The app goes in Program Files\Box Of Rules\Box Of Synths unless you pick another. This folder holds the standalone app only.
  3. Choose your shortcuts. One option is offered: Create a desktop shortcut. A Box Of Synths shortcut is always added to the Start menu.
  4. Click Install.
  5. On the last page, leave Launch Box Of Synths ticked to open the app straight away, or untick it.

The VST3 plugin always goes in the shared VST3 folder, Common Files\VST3 inside Program Files, whatever install folder you pick. If you choose to install only for yourself, Windows uses folders under your own user profile instead of Program Files, so choose the everyone option if your music program looks in the shared VST3 folder.

Remove it on Windows

Open the list of installed apps in Windows, choose Box Of Synths and uninstall it.

  • Removed: the standalone app, the VST3 plugin and the shortcuts.
  • Left behind on purpose: your library and your settings. Delete them yourself if you want them gone. See Files and folders.

Your first run

The first time you open the app, a short run of cards asks what it needs to know. This happens in the standalone app and in the plugin alike. You meet each card once, and each stays until you answer it. The full text of every card is on Agreements and confirmations.

  1. Where your sounds live. Every preset, every generation and every chat is saved in one folder on your computer. The card shows the folder. Press Keep this folder to accept it, or Choose another... to pick a different one. Files are not moved if you change it later. Change it any time in Settings, Library: see Settings: Library and folders.
  2. Who designs your sounds? Pick where the designing happens: Box Of Synths (tokens), Built-in database (free), My own AI key (your own bill), Local model (free) or Agent (free). Box Of Synths opens the sign-in card. My own AI key and Local model first show a card about your keys and your bill, then open Settings on the Designer tab. Built-in database opens nothing. Change it any time in Settings, Designer: see Settings: Designer and Sources, tokens and what a design costs.
  3. How much may we learn from your designs? Three choices, none chosen for you: Essential only, Improve Box Of Synths and Share everything. Change it any time in Settings, Account: see Settings: Account and privacy.
  4. Terms of use. Press I agree to accept, Later to close the card, or Read on the site to read the full terms in your web browser. After Later, the card does not come back by itself.

Cards 1 and 2 can come up at about the same moment. Answer the one in front, and the other is behind it. Cards 3 and 4 follow your answer to card 2.

When the cards are done, go to Your first sound.

Find it in your music program

  • In your music program, look for Box Of Synths among the instruments. The maker is shown as Box of Rules.
  • If it does not appear, rescan your plugins in the music program's settings. Programs differ in where that is. See Troubleshooting if it still does not show.
  • The standalone app needs an audio output to make sound. Play it with a MIDI keyboard, or with the on-screen keyboard: see The keyboard.

Updates

The app checks for a new version when it opens. It remembers the answer, and asks our site again when the last check was more than a day ago.

When a newer version exists:

  • The status line says Version followed by the version number, then is out.
  • A green key, UPDATE NOW, takes the place of the logo in the header. Hover over it and the tooltip says the version is out and that clicking downloads it for your system.
  • Click it. Your web browser opens the download for your system. If there is no direct download, it opens our changelog instead.

To update, run the new installer. On macOS it replaces the three items in the same places. On Windows it recognises the earlier install and updates it. Your library and your settings are kept.