Backup

Where to find the files and folders to include with a manual backup of Synfire

Important: We strongly recommended you backup your installation of Synfire and the projects and files you created using your operating system's preferred tools and schedules. On macOS this is Time Machine and on Windows this is the backup utility found in System Preferences.

Should you ever need to manually backup or restore the files you have created with Synfire, this is where you find the relevant files.

Home Folders

These are all found under your personal home directory.

~/Documents/Synfire Documents\Synfire
The default folder for all your settings and projects. It should have a sub-folder for Arrangements, Sketches, Libraries, Palettes and other document types. We recommend you keep your saved files in this hierarchy in order to simplify backup and migration to future versions of Synfire.

Inside this folder you find the so-called Configuration Folder Config that contains your customized system preferences, Device Descriptions, Palette Colorings and Layouts, Plug-in Presets and more. Your Global Racks also go here into the Racks folder by default, unless you save them to a more specific location.

Note: Version 1 used distinct names Synfire Express and Synfire Pro for this folder, which are now migrated into a single folder for all editions Sparks, Express and Pro. This is to ensure a smoother upgrade experience and simplify file management and backup.
~/Library/Application Support/Cognitone AppData\Roaming\Cognitone
This is where the Audio Engine stores its settings and the list of scanned plug-ins. You need not necessarily backup this folder, unless you manually patched individual files.

System Folders

These are found under the root folder of your startup volume.

/Library/Application Support/Cognitone C:\ProgramData\Cognitone
This is where Synfire installs the apps of the Audio Engine and the SETUP application used to install or uninstall Synfire. You need not backup these manually, as they can be restored by re-installing Synfire.
/Library/Application Support/Synfire C:\ProgramData\Synfire
This is where user manuals, update logs and system-provided settings and defaults are stored in order to keep them separate from files you customized for your own purposes. It also includes a Configuration Folder the content of which you should not modify.
Note: Version 1 used distinct names Synfire Express and Synfire Pro for this folder, which are now migrated into a single folder for all editions Sparks, Express and Pro. This is to ensure a smoother upgrade experience and simplify file management and backup.

Making a Manual Backup

Grab all of the above folders and copy them to a thumb drive, external disk or other data volume. In order to not confuse folders that bear the same name, be sure to create empty destination folders Home and System first before you copy the original folders into them.

Restoring a Manual Backup

Uninstall and re-install Synfire first. Then copy your backup folders back to their original locations as they are explained above, replacing any existing files.