Relocating and deleting Resonite directories

It is possible to relocate the data and cache directories to directories outside of their default location. This may be done for organizational purposes or for saving space on one filesystem by relocating them to a different filesystem.

Precautions

The data and cache paths are intertwined, and the local database uses absolute paths to reference the cache in places. As such, to avoid conflict and potential database bloat, this process involves deleting both the data and cache directories. They will not be moved to the new location. This will have the following side effects:

1. You will be logged out. Ensure that you know your password and, if applicable, your two-factor authentication device is on hand.
2. Your Local Home will be cleared. Ensure that everything in there that you wish to save is backed up to the cloud.
3. Any local unsynced records will be deleted. If you are having sync issues and do not want to lose potential progress, see the sync conflict page for help on resolving it before continuing.

Relocating

An example of custom launch options where the data path is relocated to D:\Temporary files\ResoniteCache.

For the Steam build, the relocation process is as follows:

1. Navigate to Resonite in your Steam library
2. Click the gear icon to the right underneath the banner, then choose "Properties..."
3. In the "Launch options" section, there is a text box for custom launch options.
   • To change the data path, add the text -DataPath C:\Path\To\New\Data\Folder
   • To change the cache path, add the text -CachePath C:\Path\To\New\Cache\Folder
   • If the path contains a space, it must be surrounded by double quotes, such as -DataPath "D:\Example Path\With Spaces".
   • Both options can be specified at the same time—one after another—so long as they are separated by a space.
4. Close the window to save changes.
5. Delete the old cache and data directories. To find where these directories are, see the data and cache directories page.

If launching Resonite outside of Steam, then these options are appended to the command line of the Resonite.exe executable that you run.

These arguments must be present at all times or else Resonite will revert back to the default directories.