Controlling the Global User Directory: Difference between revisions

From Dolphin Emulator Wiki
Jump to navigation Jump to search
m (Accidentally deleted this)
m (restored something)
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.
== Moving Saves and Settings from Older Versions ==
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 ==
== Choose the Default Location of the Dolphin Profile ==

Revision as of 08:24, 7 February 2018

The Global User Directory was brought to Windows in 3.5-2381 and release 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.

Moving Saves and Settings from Older Versions

Moving saves and settings from an older version of Dolphin to 4.0-era builds is easy. The default location of the Global User Directory is %userprofile%\My Documents\Dolphin Emulator\. To preserve game saves, copy over the \GC\ and \Wii\ folders which are under the old build's \User\ folder to the directory currently specified by Global User Directory. The same can be done for settings by copying over the \Config\ folder.

  • It may be more convenient to copy all of the content from the old \User\ folder to the Dolphin Emulator folder, however the \GameConfig\ 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.
  • Expand HKEY_CURRENT_USER.
  • Right click Software and select New > Key. Name the key Dolphin Emulator.
  • Right click the new Dolphin Emulator key, and select New > String Value. Name the value UserConfigPath.
  • 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 \User\ folder. If it is pointed to Desktop for example, the Desktop will be flooded with folders unnecessarily.

Local User Directory for Any Build with "LocalUserConfig" registry key

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.

When done editing the Windows Registry, and before launching Dolphin, be sure to move the \User\ folder along with Dolphin executable files (or check if it's placed correctly). Otherwise, Dolphin will create a new one instead.

Manual Registry Editing

  • Open the registry. Simply type "regedit" in the search bar of the Start Menu and hit enter.
  • Expand HKEY_CURRENT_USER.
  • Right click Software and select New > Key. Name the key Dolphin Emulator.
  • Right click the new Dolphin Emulator key, and select New > String Value. Name the value LocalUserConfig.
  • Double click the "LocalUserConfig" value and an Edit String dialog appears. Under "Value Data", type the number 1.

Automatic Process with .REG Files

These registry keys can be created and removed with .reg files to make the process easier.

To create the LocalUserConfig registry key, open notepad, paste the following in it and save it as a .reg file:

Windows Registry Editor Version 5.00
[HKEY_CURRENT_USER\Software\Dolphin Emulator]
"LocalUserConfig"="1"

To remove the LocalUserConfig registry key and revert back to the Global User Directory system, open notepad, paste the following in it and save it as a .reg file:

Windows Registry Editor Version 5.00
[HKEY_CURRENT_USER\Software\Dolphin Emulator]
"LocalUserConfig"=-

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.