Configuration Directory - JetSetIlly/Gopher2600-Docs GitHub Wiki

Gopher2600 will look for previously saved support files in a configuration directory. The location of this directory depends on your operating system.

On Linux type systems, the location of the configuration directory is .config/gopher2600.

For MacOS the location is ~/Library/Application Support/gopher2600 (where the ~ indicates the path to your home directory).

For Windows a directory called gopher2600 will be placed in the user's %AppData% folder, either in the Local or Roaming sub-folder. For example C:\Users\USER_NAME\AppData\Roaming\gopher2600

The directory, sub-directory and most files will be created automatically as required.

Content Details

The directory may contain any of the following files and sub-directories:

  • preferences - User specified preferences for the emulator.

  • debugger_imgui.ini - The window coordinates and sizing of the windows created by the Dear Imgui GUI system.

  • savekey - Data saved to an attached Savekey peripheral will be read from and stored in this file. Created when a ROM using the Savekey is first inserted.

  • fa2_nvram - A sub-directory containing RAM dumps from FA2 ROMs.

  • regression - A sub-directory containing the regression database and scripts. Created and used by the REGRESS sub-mode.

  • debuggerInit - A series of terminal commands that will be run by the debugger on startup.

  • patches - Patch files for ROMs. For now, patches must be manually created and stored in this directory. In addition they are only applicable when applied via the setupDB file.

  • setupDB - Manually created and maintained for now, this file can be used to associate a ROM with console preparation and patch application.

  • managerState - Positioning of windows and whether they are open

  • managerHotkeys - Window activation hotkeys. These are generated automatically by the windows search feature

For Non-release Versions

For non-release versions of the emulator (see Compilation) the location of the configuration directory is .gopher2600 in the current working directory. This applies to all platforms.