Data and cache directories: Difference between revisions

From Resonite Wiki
m add link to log files page
overhaul, translate tags
Line 1: Line 1:
Resonite has '''two''' locations, '''outside of the main installation directory''' which store files and folders that help Resonite run:
<languages/>
# Cache - Store's temporary copies of assets and other items that are downloaded or generated while you are using Resonite.
# Database/Data - Stores a local copy of your items and things that you are working on, your login status and settings.
Note that it path is shown inside [[Log Files|Resonite Log]], in the first few lines saying "DataPath=" and "CachePath=" if those default location does not exist for you.


= Folder Default Locations = <!--T:2-->
<translate>
== Cache ==
Resonite has two directories outside of the main installation directory which store files and folders that help it run. These directories are the ''cache path'' and ''data path''.
By default the cache can be found in: <code>%USERPROFILE%\AppData\Local\Temp\Yellow Dog Man Studios\Resonite</code>
</translate>


<!--T:3-->
<translate>
To get there easily:
== Cache path ==
# Push Windows Key + R
</translate>
# Type/Copy this <code>%USERPROFILE%\AppData\Local\Temp\Yellow Dog Man Studios\Resonite</code> into the Run box that appears
# Press Enter or the Ok button


== Database/Data == <!--T:4-->
<translate>
By default the data folder can be found in: <code>%USERPROFILE%\AppData\LocalLow\Yellow Dog Man Studios\</code>
The cache path contains the Resonite cache, or copies of assets downloaded or generated while Resonite is open. This allows for quick retrieval of previously seen assets without the need to re-download or re-generate them.
</translate>


<!--T:5-->
<translate>
To get there easily:
== Data path ==
# Push Windows Key + R
</translate>
# Type/Copy this <code>%USERPROFILE%\AppData\LocalLow\Yellow Dog Man Studios\</code> into the Run box that appears
# Press Enter or the Ok button


<translate>
The data path mainly houses the [[local database]], the key used to unlock the local database, and a miscellaneous asset cache.
</translate>


= Folder Default Locations On Linux =
== Location of folders ==


== Cache ==
<translate>
By default cache can be found in <code>$XDG_CACHE_HOME/Yellow\ Dog\ Man\ Studios/Cache/</code>
The location of the cache and data paths on any specific machine can always be found in the first few lines of the [[Log files|Resonite log file]]:
</translate>


By default XDG_CACHE_HOME should be <code>/home/$USER/.cache/</code>  
<pre>
ℹ️11:23:46 PM.388 (FPS: 0): AppPath: /home/user/.local/share/Steam/steamapps/common/Resonite
DataPath: /home/user/.local/share/Yellow Dog Man Studios/Data
CachePath: /home/user/.cache/Yellow Dog Man Studios/Cache
LocalePath: /home/user/.local/share/Steam/steamapps/common/Resonite/Locale
</pre>


If you're using Steam in flatpak, XDG_CACHE_HOME should be <code>/home/$USER/.var/app/com.valvesoftware.Steam/cache/</code>
<translate>
Custom locations for the data and cache paths can be set with the <code>-DataPath</code> and <code>-CachePath</code> [[command line arguments]]. To avoid potential conflicts, do <strong>not</strong> move over the previous folders to any new location. More information can be found on the [[relocating Resonite folders]] page.
</translate>


== Database/Data ==
<translate>
By default cache can be found in <code>$XDG_DATA_HOME/Yellow\ Dog\ Man\ Studios/Data/</code>
=== Default locations ===
</translate>


By default XDG_DATA_HOME should be <code>/home/$USER/.local/share/</code>  
<translate>
==== Cache path ====
</translate>


If you're using Steam in flatpak, XDG_DATA_HOME should be <code>/home/$USER/.var/app/com.valvesoftware.Steam/data</code>
<translate>
On Windows, the default cache directory is <code>%USERPROFILE%\AppData\Local\Temp\Yellow Dog Man Studios\Resonite</code>. To get to this path easily:
</translate>
 
# <translate>Push Windows Key + R</translate>
# <translate>Enter <code>%USERPROFILE%\AppData\Local\Temp\Yellow Dog Man Studios\Resonite</code> into the Run box that appears</translate>
# <translate>Press Enter or the Ok button</translate>
 
<translate>
On Linux, the default cache directory is <code>$XDG_CACHE_HOME/Yellow Dog Man Studios/Cache</code>. If [https://wiki.archlinux.org/title/XDG_Base_Directory#User_directories <code>XDG_CACHE_HOME</code>] is not defined, it will default to <code>$HOME/.cache</code>. If Resonite is launched through [https://wiki.archlinux.org/title/Steam#Flatpak Flatpak Steam], then <code>XDG_CACHE_HOME</code> will be <code>$HOME/.var/app/com.valvesoftware.Steam/cache</code>.
</translate>
 
<translate>
==== Data path ====
</translate>
 
<translate>
On Windows, the default data directory is <code>%USERPROFILE%\AppData\LocalLow\Yellow Dog Man Studios\Resonite</code>. To get to this path easily:
</translate>
 
# <translate>Push Windows Key + R</translate>
# <translate>Enter <code>%USERPROFILE%\AppData\LocalLow\Yellow Dog Man Studios\Resonite</code> into the Run box that appears</translate>
# <translate>Press Enter or the Ok button</translate>
 
<translate>
On Linux, the default data directory is <code>$XDG_DATA_HOME/Yellow Dog Man Studios/Data</code>. If [https://wiki.archlinux.org/title/XDG_Base_Directory#User_directories <code>XDG_DATA_HOME</code>] is not defined, it will default to <code>$HOME/.local/share</code>. If Resonite is launched through [https://wiki.archlinux.org/title/Steam#Flatpak Flatpak Steam], then <code>XDG_DATA_HOME</code> will be <code>$HOME/.var/app/com.valvesoftware.Steam/data</code>.
</translate>
 
<translate>
== See also ==
</translate>
 
* <translate>[[Log files]] for another directory used by resonite that can be specified by the user.</translate>

Revision as of 17:32, 23 August 2025

Resonite has two directories outside of the main installation directory which store files and folders that help it run. These directories are the cache path and data path.

Cache path

The cache path contains the Resonite cache, or copies of assets downloaded or generated while Resonite is open. This allows for quick retrieval of previously seen assets without the need to re-download or re-generate them.

Data path

The data path mainly houses the local database, the key used to unlock the local database, and a miscellaneous asset cache.

Location of folders

The location of the cache and data paths on any specific machine can always be found in the first few lines of the Resonite log file:

ℹ️11:23:46 PM.388 (FPS: 0):	AppPath: /home/user/.local/share/Steam/steamapps/common/Resonite
DataPath: /home/user/.local/share/Yellow Dog Man Studios/Data
CachePath: /home/user/.cache/Yellow Dog Man Studios/Cache
LocalePath: /home/user/.local/share/Steam/steamapps/common/Resonite/Locale

Custom locations for the data and cache paths can be set with the -DataPath and -CachePath command line arguments. To avoid potential conflicts, do not move over the previous folders to any new location. More information can be found on the relocating Resonite folders page.

Default locations

Cache path

On Windows, the default cache directory is %USERPROFILE%\AppData\Local\Temp\Yellow Dog Man Studios\Resonite. To get to this path easily:

  1. Push Windows Key + R
  2. Enter %USERPROFILE%\AppData\Local\Temp\Yellow Dog Man Studios\Resonite into the Run box that appears
  3. Press Enter or the Ok button

On Linux, the default cache directory is $XDG_CACHE_HOME/Yellow Dog Man Studios/Cache. If XDG_CACHE_HOME is not defined, it will default to $HOME/.cache. If Resonite is launched through Flatpak Steam, then XDG_CACHE_HOME will be $HOME/.var/app/com.valvesoftware.Steam/cache.

Data path

On Windows, the default data directory is %USERPROFILE%\AppData\LocalLow\Yellow Dog Man Studios\Resonite. To get to this path easily:

  1. Push Windows Key + R
  2. Enter %USERPROFILE%\AppData\LocalLow\Yellow Dog Man Studios\Resonite into the Run box that appears
  3. Press Enter or the Ok button

On Linux, the default data directory is $XDG_DATA_HOME/Yellow Dog Man Studios/Data. If XDG_DATA_HOME is not defined, it will default to $HOME/.local/share. If Resonite is launched through Flatpak Steam, then XDG_DATA_HOME will be $HOME/.var/app/com.valvesoftware.Steam/data.

See also

  • Log files for another directory used by resonite that can be specified by the user.