Data and cache directories: Difference between revisions

From Resonite Wiki
overhaul, translate tags
Marked this version for translation
Line 2: Line 2:


<translate>
<translate>
<!--T:1-->
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''.
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''.
</translate>
</translate>


<translate>
<translate>
== Cache path ==
== Cache path == <!--T:2-->
</translate>
</translate>


<translate>
<translate>
<!--T:3-->
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.
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>
</translate>


<translate>
<translate>
== Data path ==
== Data path == <!--T:4-->
</translate>
</translate>


<translate>
<translate>
<!--T:5-->
The data path mainly houses the [[local database]], the key used to unlock the local database, and a miscellaneous asset cache.
The data path mainly houses the [[local database]], the key used to unlock the local database, and a miscellaneous asset cache.
</translate>
</translate>
Line 24: Line 27:


<translate>
<translate>
<!--T:6-->
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]]:
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>
</translate>
Line 35: Line 39:


<translate>
<translate>
<!--T:7-->
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.
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>
</translate>


<translate>
<translate>
=== Default locations ===
=== Default locations === <!--T:8-->
</translate>
</translate>


<translate>
<translate>
==== Cache path ====
==== Cache path ==== <!--T:9-->
</translate>
</translate>


<translate>
<translate>
<!--T:10-->
On Windows, the default cache directory is <code>%USERPROFILE%\AppData\Local\Temp\Yellow Dog Man Studios\Resonite</code>. To get to this path easily:
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>


# <translate>Push Windows Key + R</translate>
# <translate><!--T:11--> 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><!--T:12--> 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><!--T:13--> Press Enter or the Ok button</translate>


<translate>
<translate>
<!--T:14-->
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>.
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>


<translate>
<translate>
==== Data path ====
==== Data path ==== <!--T:15-->
</translate>
</translate>


<translate>
<translate>
<!--T:16-->
On Windows, the default data directory is <code>%USERPROFILE%\AppData\LocalLow\Yellow Dog Man Studios\Resonite</code>. To get to this path easily:
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>


# <translate>Push Windows Key + R</translate>
# <translate><!--T:17--> 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><!--T:18--> 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><!--T:19--> Press Enter or the Ok button</translate>


<translate>
<translate>
<!--T:20-->
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>.
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>


<translate>
<translate>
== See also ==
== See also == <!--T:21-->
</translate>
</translate>


* <translate>[[Log files]] for another directory used by resonite that can be specified by the user.</translate>
* <translate><!--T:22--> [[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.