Data and cache directories: Difference between revisions

From Resonite Wiki
overhaul, translate tags
m cat(real)(real)
 
(9 intermediate revisions by 2 users not shown)
Line 2: Line 2:


<translate>
<translate>
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''.
<!--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''.
</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>
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.
=== Default locations === <!--T:8-->
</translate>
</translate>


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


<translate>
<translate>
==== Cache path ====
<!--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:
</translate>
</translate>
# <translate><!--T:11--> Push Windows Key + R</translate>
# <translate><!--T:12--> Enter <code>%USERPROFILE%\AppData\Local\Temp\Yellow Dog Man Studios\Resonite</code> into the Run box that appears</translate>
# <translate><!--T:13--> Press Enter or the Ok button</translate>


<translate>
<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:
<!--T:14-->
On Linux, the default cache directory is <code>$XDG_CACHE_HOME/Yellow Dog Man Studios/Cache</code>. If <code>[https://specifications.freedesktop.org/basedir-spec/latest/#variables XDG_CACHE_HOME]</code> is not defined, it will default to <code>$HOME/.cache</code>. If Resonite is launched through [https://flathub.org/apps/com.valvesoftware.Steam Flatpak Steam], then <code>XDG_CACHE_HOME</code> will be <code>$HOME/.var/app/com.valvesoftware.Steam/cache</code>.
</translate>
</translate>


# <translate>Push Windows Key + R</translate>
<translate>
# <translate>Enter <code>%USERPROFILE%\AppData\Local\Temp\Yellow Dog Man Studios\Resonite</code> into the Run box that appears</translate>
==== Data path ==== <!--T:15-->
# <translate>Press Enter or the Ok button</translate>
</translate>


<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>.
<!--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:
</translate>
</translate>
# <translate><!--T:17--> Push Windows Key + R</translate>
# <translate><!--T:18--> Enter <code>%USERPROFILE%\AppData\LocalLow\Yellow Dog Man Studios\Resonite</code> into the Run box that appears</translate>
# <translate><!--T:19--> Press Enter or the Ok button</translate>


<translate>
<translate>
==== Data path ====
<!--T:20-->
On Linux, the default data directory is <code>$XDG_DATA_HOME/Yellow Dog Man Studios/Data</code>. If <code>[https://specifications.freedesktop.org/basedir-spec/latest/#variables XDG_DATA_HOME]</code> is not defined, it will default to <code>$HOME/.local/share</code>. If Resonite is launched through [https://flathub.org/apps/com.valvesoftware.Steam Flatpak Steam], then <code>XDG_DATA_HOME</code> will be <code>$HOME/.var/app/com.valvesoftware.Steam/data</code>.
</translate>
</translate>


<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:
== Deletion and relocation == <!--T:23-->
</translate>
</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>
<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>.
<!--T:24-->
Sometimes, it may be desired or required to relocate or delete these directories. Relocation is done with a [[command line argument]], and deletion is done manually. More information on relocation and deletion can be found on the [[relocating and deleting Resonite directories]] page.
</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>
 
[[Category:Resonite files and directories]]

Latest revision as of 22:58, 2 October 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

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.

Deletion and relocation

Sometimes, it may be desired or required to relocate or delete these directories. Relocation is done with a command line argument, and deletion is done manually. More information on relocation and deletion can be found on the relocating and deleting Resonite directories page.

See also

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