15,188
edits
(undo removing the trivial sentence) |
(→Windows: a bit late, but updated the guide to reflect the new default folder on Windows) |
||
(19 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
The | The user directory is where Dolphin stores saves, settings, screenshots, and other data. Where the user directory is located depends on the Dolphin version, operating system, and your configuration. Some locations let the user directory be shared by different installations of Dolphin (a global user directory), and some locations are tied to a specific installation of Dolphin (a local user directory). | ||
== Windows == | |||
Dolphin {{revision|3.5-2368}} and earlier always used a local user directory, stored in the same folder as <tt>Dolphin.exe</tt> and named <tt>User</tt>. Starting with {{revision|3.5-2381}}, the global user directory system was introduced on Windows and the default user directory changed to a subfolder inside the <tt>Documents</tt> folder, named <tt>Dolphin Emulator</tt>. | |||
The default folder changed again on {{revision|5.0-18242}}, which now defaults to <tt>%AppData%\Dolphin Emulator</tt>, however, for backwards compatibility, the previous location will remain in use if it exists when launching Dolphin {{revision|5.0-18242}} or newer for the first time. Additionally, it's possible to configure Dolphin to still use a local user directory or another custom location, as explained below. | |||
= | === Disable the Global User Directory for a Specific Build with "portable.txt" === | ||
To make a build use a local user directory, create a text file named "portable" next to the executable files of the build. With the extension it should be named "portable.txt". Dolphin will check if that file exists in the same directory, then it will not use the global user directory, instead it will create and use the local user directory in the same directory. | |||
=== Custom Command Line Path === | |||
If you are launching Dolphin from the command line, you can set a custom user directory path for the current session of Dolphin by using the <tt>-u</tt> option: | |||
<pre>C:\Path\To\Dolphin\Build\Dolphin.exe -u E:\Path\To\User\Directory\</pre> | |||
Dolphin will use the regular user directory path again the next time you launch Dolphin, unless you use <tt>-u</tt> again. | |||
== | === Registry Configuration === | ||
The user directory behavior can be changed for all Dolphin installations at once using the registry. Editing the registry is an advanced topic and is not recommended for most users! | |||
==== Choose the Location of the Global User Directory ==== | |||
*Open the registry. Type "regedit" in the search bar of the Start Menu and hit enter. | |||
*Expand <var>HKEY_CURRENT_USER</var>. | |||
*Right click <var>Software</var> and select <var>New > Key</var>. Name the key <kbd>Dolphin Emulator</kbd>. | |||
*Right click the new <var>Dolphin Emulator</var> key, and select <var>New > String Value</var>. Name the value <kbd>UserConfigPath</kbd>. | |||
*Double click the "UserConfigPath" value and an Edit String dialog appears. Under "Value Data", enter the path to the custom User directory. Make sure that the "User" folder is explicitly specified, since Dolphin will assume whatever path it is directed to is the <var>\User\</var> folder. If it is pointed to Desktop for example, the Desktop will be flooded with folders unnecessarily. | |||
== | ==== Use Local User Directories ==== | ||
*Open the registry. | *Open the registry. Type "regedit" in the search bar of the Start Menu and hit enter. | ||
*Expand < | *Expand <var>HKEY_CURRENT_USER</var>. | ||
*Right click < | *Right click <var>Software</var> and select <var>New > Key</var>. Name the key <kbd>Dolphin Emulator</kbd>. | ||
*Right click the new < | *Right click the new <var>Dolphin Emulator</var> key, and select <var>New > String Value</var>. Name the value <kbd>LocalUserConfig</kbd>. | ||
*Double click the " | *Double click the "LocalUserConfig" value and an Edit String dialog appears. Under "Value Data", type the number <var>1</var>. | ||
== Linux == | |||
By default, Dolphin uses a global user directory and follows the [https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html XDG Base Directory Specification] for determining its location. If the directory <tt>~/.dolphin-emu</tt> exists, or you are using a version of Dolphin older than {{revision|4.0-8143}}, <tt>~/.dolphin-emu</tt> will be used as the location of the global user directory instead. | |||
== Disable the Global User Directory for a Specific Build with "portable.txt" == | === Disable the Global User Directory for a Specific Build with "portable.txt" === | ||
To make a build use a local user directory, create a | In Dolphin {{revision|5.0-148}} and later, it's possible to use the same <tt>portable.txt</tt> method as on Windows to set a local user directory for a Dolphin build. | ||
To make a build use a local user directory, create a file named <tt>portable.txt</tt> in the same directory as the executable files of the build. Dolphin will check if that file exists in the same directory, then it will not use the global user directory, instead it will create and use the local user directory in the same directory. | |||
=== Custom Command Line Path === | |||
If you are launching Dolphin from the command line, you can set a custom user directory path for the current session of Dolphin by using the <tt>-u</tt> option: | |||
<pre>/path/to/dolphin/build/dolphin-emu -u /path/to/user/directory</pre> | |||
Dolphin will use the regular user directory path again the next time you launch Dolphin, unless you use <tt>-u</tt> again. | |||
=== Environment Variable === | |||
If you set the <tt>DOLPHIN_EMU_USERPATH</tt> environment variable, Dolphin will use its value as the path to the user directory. | |||
== macOS == | |||
By default, Dolphin uses a global user directory located at <tt>~/Library/Application Support/Dolphin</tt>. | |||
=== Custom Command Line Path === | |||
< | If you are launching Dolphin from the command line, you can set a custom user directory path for the current session of Dolphin by using the <tt>-u</tt> option: | ||
<pre>/path/to/dolphin/build/dolphin-emu -u /path/to/user/directory</pre> | |||
<pre> | |||
Dolphin will use the regular user directory path again the next time you launch Dolphin, unless you use <tt>-u</tt> again. | |||
=== Environment Variable === | |||
If you set the <tt>DOLPHIN_EMU_USERPATH</tt> environment variable, Dolphin will use its value as the path to the user directory. | |||
== Android == | |||
Old versions of Dolphin always use the directory <tt>dolphin-emu</tt> on shared storage as the user directory. This directory is shared between different installations of Dolphin and is not automatically deleted when you uninstall Dolphin. | |||
Dolphin {{revision|5.0-15348}} and newer comply with Google's scoped storage policy and normally use the directory <tt>Android/data/org.dolphinemu.dolphinemu/files</tt> on shared storage as the user directory. This directory is difficult to access in most file managers on Android 11 and newer, and by default all data in the directory will be deleted when you uninstall Dolphin. However, if <b>all</b> of the following applies, the old <tt>dolphin-emu</tt> location will be used as the user directory instead: | |||
* Scoped storage is disabled | |||
* <tt>Android/data/org.dolphinemu.dolphinemu/files</tt> does not exist or is empty | |||
* <tt>dolphin-emu</tt> exists | |||
* When Dolphin requests permission to access your files, you press Allow | |||
Scoped storage is disabled if <b>at least one</b> of the following applies: | |||
* You are using Android 10 or older <!-- TODO: What exactly happens when updating from Android 10 with Dolphin installed? Is scoped storage intended to stay disabled? Does the preserveLegacyExternalStorage bug affect it? --> | |||
* You were using Dolphin {{revision|5.0-15341}} or older when you installed Dolphin, and you haven't uninstalled Dolphin since then, and you haven't triggered the preserveLegacyExternalStorage bug since then | |||
* You have manually disabled scoped storage for Dolphin using the following command (only possible if you have a rooted device or a debug version of Dolphin), and you haven't triggered the preserveLegacyExternalStorage bug since then: <pre>cmd appops set org.dolphinemu.dolphinemu android:legacy_storage allow && am force-stop org.dolphinemu.dolphinemu</pre> | |||
[https://cs.android.com/android/_/android/platform/frameworks/base/+/c57e3455ff29b0a15a8781a34c19c6ded196f69e The preserveLegacyExternalStorage bug] is triggered when <b>all</b> of the following applies at the same time: | |||
* You are using Android 11 (not Android 12 or newer) | |||
* The installed version of Dolphin is {{revision|5.0-15348}} or newer | |||
* You restart your device | |||
[[Category:Tutorials]] | [[Category:Tutorials]] |