Box Of Synths manual

Box Of Synths manualSettings

Settings: Library and folders

Keep your library on our site, switch auto-save on or off, and choose and understand the folders your sounds live in.

The Library tab is about where your work is kept. Every sound, generation and chat is saved on your computer, always. This tab lets you add a copy on our site, decide whether every generation is also saved as a preset, and move the folders.

Settings: Library Click any numbered part of the picture to read what it does.
The Library tab of Settings, with a cloud sync note, an Auto-save generations switch, and the library and database folders with buttons to open and change them.
  1. 1Settings tabsTabs

    The six pages of Settings. Library is the one lit green here. See Settings: Designer.

  2. 2Cloud syncArea

    Keeping your library on Box Of Synths needs a plan. Until your account has synced items, this area is only a line saying A plan keeps your library on Box Of Synths.

    Once your account has synced items, a switch called Keep my library on Box Of Synths appears here. The page text explains it.

  3. 3Auto-save generationsSwitch

    When on, every generation is also saved as a preset, named the way the designer named it. When off, that extra copy stops. Your version history is kept either way.

    Starts as
    On
  4. 4Library folder pathDisplay

    Shows the folder where your sounds, chats and designs live. It is text only: you cannot type in it.

    Starts as
    The Box of Rules folder, then Synths, inside your Music folder
  5. 5Library folderKey

    Opens the library folder in Finder or File Explorer.

  6. 6ChooseKey

    Opens a folder chooser headed Where should your sounds live? and makes the folder you pick your library.

    Files already in the old folder are not moved. Move them yourself if you want them in the new one.

  7. 7Database folder pathDisplay

    Shows the folder of the offline database: the packs you download and any records of your own.

    Starts as
    The Database folder inside your library
  8. 8FolderKey

    Opens a folder chooser headed Where should the database live? and points the offline database at the folder you pick. The app reads that folder again straight away. If the built-in database is the chosen source, the Designer tab says Folder set.

  9. 9Database folder captionDisplay

    A reminder that the database folder defaults to the Database folder inside your library.

Cloud sync

Cloud sync keeps your library on Box Of Synths, so your sounds and racks follow you between machines. It needs a plan. See A plan in Settings: Account and privacy.

Until your account has synced items, you see only a line: A plan keeps your library on Box Of Synths. Once it has, a switch called Keep my library on Box Of Synths appears above that line.

  • Switch it on and your library uploads straight away.
  • Switch it off and the app stops sending. Nothing is removed from the site.
  • If you have a plan, the line under the switch reads a plan keeps it: followed by how many sounds you have used of your limit, and the limit in MB.
  • If the site refuses because you have no plan, the switch turns itself off.

Nothing is ever deleted from this computer by syncing. With sync on, a file you removed on another machine is moved to the Trash folder in your library here, never destroyed. After a save, a generation or a chat rename, a sync runs a couple of seconds later. There is also one quiet sync when the app starts. Sync only brings down what the site has that is newer.

Auto-save generations

When Auto-save generations is on, every generation is also written as a preset, named the way the designer named it. The file goes to Presets/Auto in your library as <yyyy-mm-dd> <name>.json. If the name is taken, the app adds -2. Switch it off and that extra copy stops. Your version history is kept either way.

Where your files live

Library folder shows where your library is. The default is the Box of Rules folder, then Synths, inside your Music folder.

  • Library folder (the key) opens it in Finder or File Explorer.
  • Choose opens a folder chooser headed Where should your sounds live? and makes the folder you pick your library. Files already in the old folder stay where they are. The app does not move them.

Database folder shows where the offline database lives: the packs you download and any records of your own. It defaults to the Database folder inside your library.

  • Folder opens a chooser headed Where should the database live? After you pick, the app reads the folder again straight away. If the built-in database is the chosen source, the line under its keys on the Designer tab says Folder set.

The first time you open the app, a card called Where your sounds live asks you to keep the default folder or choose another. See Agreements and confirmations.

Move your library, step by step

Walkthrough Move your library
  1. 1Open the Library tab

    Open Settings and click Library.

  2. 2See where it lives

    The path under Library folder is where your sounds, chats and designs live.

  3. 3Choose a new folder

    Click Choose, and pick a folder in the chooser headed Where should your sounds live?

  4. 4Move your old files

    Click Library folder to open the folder. Files in the old folder are not moved for you, so copy them across yourself if you want them there.

What is in each folder

Inside your library folder you will find these.

Folder or file What is in it File type
Generations Every design the designer made, one file each, named like <stamp> <title>.json. .json
Chats One file for each chat. .json
Synths Your saved sounds and racks. You can add your own sub-folders. .json
Presets/Auto The automatic copies from Auto-save generations. .json
Database The offline database: the packs you download and the records you add. .json, .jsonl
Inbox and Outbox The two folders an agent uses: requests arrive in the inbox, answers go to the outbox. files an agent writes
Trash Files that sync removed because you deleted them on another machine, kept here instead of being destroyed. as they were
Media Kept copies of files your sounds refer to, such as samples. as they were
Errors A record of each failed call, named like error-<time>.json. It never holds a key. .json
Translations Translation files you add, named by language code like fr.json. .json
usage.jsonl One line for each design on your own AI key, with the service, model and token counts. .jsonl

Two hidden files, .cloud-cache.json and .cloud-index.json, belong to cloud sync. Leave them alone.

Your themes are not in the library. They live in a Themes folder inside the Box of Rules and Synths folders in your Music folder. See Settings: Appearance and themes. The settings file is somewhere else again, and Settings file in Settings: Advanced shows you where.