Box Of Synths manualReference
Files and folders
Where Box Of Synths keeps your sounds, chats, database, themes and settings on your computer, what each file is, and how to move or back up your library.
Box Of Synths keeps everything you make on your own computer, in plain files. This page says where they are and what each one is. To change the folders, see Settings: Library and folders.
The library folder
Your library is one folder. By default it is the Box of Rules folder, then Synths, inside your Music folder:
- On a Mac:
Music/Box of Rules/Synthsin your home folder. - On Windows:
Music\Box of Rules\Synthsin your user folder.
The first time you open the app, a card called Where your sounds live asks you to keep this folder or choose another. You can change it at any time in Settings, Library. The Library folder key there opens it in Finder or File Explorer.
What is inside
| Folder or file | What is in it | File type |
|---|---|---|
Generations |
Every design the designer made, and every tweak you kept, one file each, named like 2026-01-31 142501 soft-pad.json. A line in the history brings its sound back from this file. |
.json |
Chats |
One file for each chat, with its lines and its versions. | .json |
Synths |
Your saved sounds and racks. You can add your own sub-folders. The Library tab lists what is here. | .json |
Presets/Auto |
The automatic copies made by Auto-save generations, named like 2026-01-31 Soft pad.json. |
.json |
Database |
The offline database: the packs you download, and records you add. It also holds learned.jsonl, which gets a line each time you give a sound a thumbs up. |
.json, .jsonl |
Inbox and Outbox |
The two folders an agent uses. Requests arrive in the inbox, and answers go to the outbox. | files an agent writes |
Trash |
Files removed from your library. They are kept here instead of being destroyed. | as they were |
Media |
Copies of files your sounds refer to, such as a granular sample. The copy means a moved original cannot break the sound. | audio files |
Errors |
A record of each failed call to an AI service, named like error-[time].json. It never holds your 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, the model and the token counts. | .jsonl |
.cloud-cache.json, .cloud-index.json |
Hidden files that belong to cloud sync. Leave them alone. | .json |
The app makes a folder the first time it needs it, so you may not see all of these at once.
File types
| Extension | What it is |
|---|---|
.json |
A sound, a rack, a generation, a chat, a database pack, a theme or a translation. It is plain text that you can open in any text editor. |
.jsonl |
The same, with one record on each line. Used for database records you add and for the usage log. |
.wav, .mp3 |
A note you export from the on-screen keyboard, saved where you choose. |
.settings |
The settings file. |
Auto-save generations
With Auto-save generations on, which is how the app starts, every design is also written as a preset in Presets/Auto. The file is named with the date and the name the designer gave the sound. If that name is taken, the app adds -2. Switch it off and the extra copy stops. Your version history is kept either way, because Generations and Chats are always written.
The themes folder
Your themes live in a Themes folder at Music/Box of Rules/Synths/Themes in your home folder. Each theme is one .json file. The folder stays there even if you move your library, because it is not part of the library. See Settings: Appearance and themes.
The settings file
Your settings are in one file called Box of Synths.settings, in the Box of Rules and Box of Synths folders of your system's application data. On a Mac that is the Application Support folder inside your Library folder. On Windows it is your AppData folder. The Settings file key in Settings: Advanced shows it for you. It holds your choices, and your account and AI keys if you have set them up, so do not share it. The diagnostics block never includes a key.
Move your library
The Choose key in Settings, Library makes another folder your library. The app does not move the files for you. To move your library:
- Make or pick the new folder and note where it is.
- Copy everything inside your old library folder into the new one, using Finder or File Explorer.
- In Settings, Library, press Choose and pick the new folder. The app reads it straight away.
- Check that your sounds, chats and history are there. Keep the old folder until you are sure.
The offline database can live somewhere else. Use Folder under Database folder to point it at another folder.
Back up, and what is safe to delete
To keep a safe copy of everything, copy the whole library folder. Copy the Themes folder too if you have made your own themes.
| Folder | If it were gone |
|---|---|
Generations and Chats |
You would lose your version history and saved chats. Do not delete these. |
Synths |
You would lose the sounds you saved. |
Presets/Auto |
You would lose only the automatic copies. Your history is kept in Generations. |
Database |
You would lose the packs you downloaded and the records you added. Download free packs brings the free ones back. |
Media |
A granular sound would lose its sample file. Do not delete it. |
Trash |
You would lose the files you removed. |
Errors |
You would lose only the records of failed calls. |