Your library on disk
Your songs are not inside the app. BandBinder keeps your whole library - every chart, setlist, note and bit of artwork - in one folder on each device, and that copy is the source of truth. Replacing or deleting the app never touches it. This page is for the people who want to know exactly where that folder is and how to put it somewhere else.
Where it is
| Platform | Library folder |
|---|---|
| Windows | %APPDATA%\BandBinder\BandBinder |
| macOS | ~/Library/Application Support/app.bandbinder |
| Linux | $XDG_DATA_HOME/app.bandbinder.bandbinder, usually ~/.local/share/app.bandbinder.bandbinder |
| Android and iOS | Inside the app's private storage. You cannot browse it; use Export your library or a cloud backup to get a copy out. |
Inside the folder: bandbinder.sqlite (the library itself, plus its -wal and -shm companions while the app runs), cached artwork and PDF charts. On Windows, the folder also holds shared_preferences.json for device preferences. On macOS, those preferences use the system's NSUserDefaults store outside the library folder. Treat the library folder as one thing: copy all of it, with the app closed.
Sign-in is stored separately: Windows uses Credential Manager and macOS uses Keychain. Copying the library folder does not copy those sessions or macOS device preferences. After moving a library you sign in again on Windows and macOS.
Portable mode (Windows)
Keep the app and your library together in one folder - on a USB stick, an external drive, or simply a folder you control:
- Unzip the Windows download into the folder.
- Before the first launch, create an empty file named
portable.txtbesidebandbinder.exe. - Launch. BandBinder creates
bbdatanext to the exe and keeps the library and Windows device preferences there from then on.
A portable copy uses a separate sign-in session from a normally installed BandBinder on the same PC. On Windows, switching to portable mode or changing BANDBINDER_DATA_DIR changes which session the app uses in Credential Manager. Plug the stick into another Windows PC and the library comes with it, but you sign in again on that PC.
Keep a portable folder out of OneDrive, Dropbox or any synced folder: a database that two sync clients rewrite under the running app gets corrupted, and the whole library would upload with it.
Portable mode is Windows only. macOS ships as a signed app in a disk image and Linux as a tarball you extract, so there is no exe-beside-the-data layout to detect; on those, use the folder override below.
Choose any folder (Windows and Linux)
Set the environment variable BANDBINDER_DATA_DIR to a folder path before BandBinder starts, and it keeps the library there. The folder is created if it is missing. On Windows, set it as a user environment variable (System Properties, Environment Variables) and launch bandbinder.exe from the folder where you unzipped the app; on Linux, export it in the shell or desktop session that launches the app. On macOS a variable set in a terminal does not reach an app opened from Finder, so this is not a supported path there.
The override wins over portable mode when both are present. Pick a local disk: a network share or a synced folder is a corruption risk for an open database.
Moving a library you already have
BandBinder does not move a library for you when you switch to portable mode or set the folder override: the new location starts empty. To bring an existing library with you:
- Close BandBinder completely.
- Copy everything from the current library folder (table above) into the new one -
bbdatabeside the exe for portable mode, or the folder you named inBANDBINDER_DATA_DIR. - Launch from the new location. Your songs, setlists and notes are there. On Windows and macOS, sign in again: the session lives outside the library folder and does not come with the copy. On Linux it comes along.
The same steps move a library to another computer of the same platform; sign in again there. Between platforms, or with no file access, use Export your library and import on the other side, or a cloud backup.
What not to do
- Do not point two running copies of BandBinder at the same folder, on one PC or over a network. One library, one app at a time.
- Do not keep the library folder in a synced folder. Sync your songs with a band plan instead; that is what it is for.