Dolphin Emulator Wiki

Controlling the Global User Directory: Difference between revisions

Page Discussion

Controlling the Global User Directory (view source)

Revision as of 07:17, 26 February 2018

1,400 bytes removed ,  26 February 2018
Modernizing and adding in the portable.txt on linux information that passed us by! Removing the instructions for moving saves from old versions (important then but irrelevant now), and shortcut instructions (portable.txt was always better)
(Restoring deleted instructions. Portable.txt especially must not be removed, and operating system instructions should remain as well as it differs significantly between OSes.)
(Modernizing and adding in the portable.txt on linux information that passed us by! Removing the instructions for moving saves from old versions (important then but irrelevant now), and shortcut instructions (portable.txt was always better))
Line 1: Line 1:
The '''Global User Directory''' was brought to Windows in {{revision|3.5-2381}} and release {{revision|4.0}}. Now, like Linux and macOS before it, Windows builds have a central location where saves, settings, screenshots, themes, etc are kept. All builds will have the same settings and saves, and updating from one revision to another will be much easier.
The '''Global User Directory''' was brought to Windows in {{revision|3.5-2381}} and release {{revision|4.0}}. Now, like Linux and macOS before it, Windows builds have a central location where saves, settings, screenshots, themes, etc are kept. All builds will have the same settings and saves, and updating from one revision to another will be much easier.


= Windows =
== Choose the Location of the Global User Directory ==
== Moving Saves and Settings from Older Versions ==
===Windows===
Moving saves and settings from an older version of Dolphin to {{revision|4.0}}-era builds is easy. The default location of the Global User Directory is <var>%userprofile%\My Documents\Dolphin Emulator\</var>. To preserve game saves, copy over the <var>\GC\</var> and <var>\Wii\</var> folders which are under the old build's <var>\User\</var> folder to the directory currently specified by Global User Directory. The same can be done for settings by copying over the <var>\Config\</var> folder.
*It may be more convenient to copy all of the content from the old <var>\User\</var> folder to the Dolphin Emulator folder, however the <var>\GameConfig\</var> folder will be ignored.
 
== Choose the Default Location of the Dolphin Profile ==
*Open the registry. Simply type "regedit" in the search bar of the Start Menu and hit enter.
*Open the registry. Simply type "regedit" in the search bar of the Start Menu and hit enter.
*Expand <var>HKEY_CURRENT_USER</var>.
*Expand <var>HKEY_CURRENT_USER</var>.
Line 12: Line 8:
*Right click the new <var>Dolphin Emulator</var> key, and select <var>New &gt; String Value</var>. Name the value <kbd>UserConfigPath</kbd>.
*Right click the new <var>Dolphin Emulator</var> key, and select <var>New &gt; 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.
*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.
=== Linux and macOS ===
On Linux and macOS, the Global User Directory's location can be changed with the command:
<pre>/path/to/dolphin/build/dolphin-emu -u /path/to/user/directory</pre>


== 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 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.
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.


== Local User Directory for Any Build with "LocalUserConfig" registry key ==
This will work on Windows and Linux (as of {{revision|5.0-148}}). macOS and Android are not supported for this method.
 
== Use Local User Directories on Windows ==
The Global User Directory system can be disabled entirely with a registry key. The key is global, so it is a "once and for all" change.
The Global User Directory system can be disabled entirely with a registry key. The key is global, so it is a "once and for all" change.


Line 42: Line 45:


The first key will set all Dolphin builds to use a Local User Directory, whereas the second will remove the Local User config and return to the Global User Directory system.
The first key will set all Dolphin builds to use a Local User Directory, whereas the second will remove the Local User config and return to the Global User Directory system.
== Use a Shortcut to Use a Specific User Directory for a Specific Build ==
A shortcut can be customized to tell a specific build to use a specific user directory. This also overrides the portable.txt file.
*Create a shortcut to the Dolphin build you want to use.
*Open the shortcut's properties and edit the target field. After the path to dolphin, add an argument <var>-u</var> (case sensitive) then add the desired path to user folder. As such example:
<pre>Dolphin.exe -u "%userprofile%\Documents\Dolphin Emulator 2"</pre>
Anytime you want that build to use the specified user directory, just run the custom shortcut. If you launch Dolphin without the custom shortcut it will use the Global User Directory or portable.txt, as normal.
= Linux and macOS =
Linux and macOS always use a Global User Directory. One can choose the directory's location with the command:
<pre>/path/to/dolphin/build/dolphin-emu -u /path/to/user/directory</pre>


[[Category:Tutorials]]
[[Category:Tutorials]]
Retrieved from "https://wiki.dolphin-emu.org/index.php?title=Special:MobileDiff/161552"