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.
-
1Settings tabsTabs
The six pages of Settings. Library is the one lit green here. See Settings: Designer.
-
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.
-
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
-
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
-
5Library folderKey
Opens the library folder in Finder or File Explorer.
-
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.
-
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
-
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.
-
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
-
1Open the Library tab
Open Settings and click Library.
-
2See where it lives
The path under Library folder is where your sounds, chats and designs live.
-
3Choose a new folder
Click Choose, and pick a folder in the chooser headed Where should your sounds live?
-
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.