User Tools

Site Tools


directory_settings

Directory Settings

Directory settings allow you to define locations for your ROMs and settings for how you want those ROMs stored. These settings offer a lot of flexibility and control over your collection. To get the most value out of RomVault its best to spend time understanding exactly what options are available and how they work.

The directory settings can be accessed in two ways:

  • From the top menu: Settings > Directory Settings
  • Right-clicking a directory in the tree and selecting “Set Dir Settings”



Setting Explanations


DAT Location

This field is for reference and is not editable. The root of your entire setup is always called “RomVault”. “RomVault” is mapped to where ever you keep all of your ROMs.

This may not seem intuitive at first, but this mapping ensures that the path references to your ROMs are stored in a relative fashion in the cache. For example, lets say you start by storing all your ROMs at “C:\ROMs\”. At some point in the future you may run out of space on C:\ and you need to move your ROMs to a NAS accessed with a mapped network drive of “Y:\”. You can make this change to the RomRoot location without needing to rescan all of your ROMs.


ROM Location

The ROM Location is the path to your ROMs. The folder icon allows you to choose the location by browsing.

The ROM locations can be modified directly in the RomVault config XML. This should not be required unless you want to use the long path syntax or reference a remote server. Examples:

  • Y:\ROMs\
  • \\?\Y:\ROMs\
  • \\Server\Share\
  • \\?\UNC\Server\Share\

It's recommended to use regular paths with drive letters to ensure support with chdman.exe for CHD verification.


Archive Type

This option allows you to specify your preferred way packaging your ROMs. Options include:

  • File - Sets will be stored uncompressed
  • Zip - Sets will be .zip archives
  • SevenZip - Sets will be .7z archives

If a DAT explicitly specifies a forced packing type in its header then that will be used. The Override DAT option allows you to override that specification and use your preferred settings instead.


Merge Type

This option allows you to specify your preferred way of merging your ROMs. This is primarily used for MAME DATs. Options include:

  • Nothing - No preference, generally used for non-MAME sets where merging does not apply
  • Split - A split set is one where the parent set contains all of the normal data it should, and the clone sets contain only what has changed as compared to the parent set. This saves some space, but isn’t quite as efficient as a merged set.
  • Merged - A merged set takes the parent set and one or more clone sets and puts them all inside the parent set’s storage.
  • NonMerged - A non-merged set is one that contains everything necessary for a given game to run in one ZIP file. The non-merged set is great for people that for instance create their own arcade cabinets and want to copy only very specific games to their PC/Rapsberry/Other.

If a DAT explicitly specifies a forced merging type in its header then that will be used. The Override DAT option allows you to override that specification and use your preferred settings instead.


ROM/CHD Filter

This option allows you to specify what types of files to allow. This is primarily used for MAME DATs. Options include:

  • ROMs & CHDs - Both ROMs and CHDs will be included. This option should be used in nearly all cases.
  • ROMs Only - Only ROMs will be included. This is useful if you prefer to use MAME's listxml output as a DAT and only want to include ROMs.
  • CHDs Only - Only CHDs will be included. This is useful if you prefer to use MAME's listxml output as a DAT and only want to include CHDs.


Don't Auto Add DAT Directories

If two or more DATs share a directory then RomVault will automatically create a subdirectory for each DAT so that they do not conflict with each other. If the “Don't Auto Add DAT Directories” option is enabled then these directories will not be automatically created and the contents of the DATs will be effectively merged together. The result is that all of your ROMs from these DATs will be placed in the same directory.

Note: Because this option causes DATs to be merged its likely you may encounter a DAT merge conflict if used haphazardly. This option is only useful under very specific circumstances.


Use Description for Auto Dir

If two or more DATs share a directory then RomVault will automatically create a subdirectory for each DAT so that they do not conflict with each other. If the “Use Description for Auto Dir” option is disabled then these subdirectories will be named as follows:

  • The value of the <name> tag in the DAT header
  • If no <name> tag is present, then the DAT filename will be used

If the “Use Description for Auto Dir” option is enabled then these subdirectories will be named as follows:

  • The value of <description> tag in the DAT header
  • If no <description> tag exists, then the value of the <name> tag is used
  • If no <name> tag exists, then the DAT filename will be used


Single Archive

Enabling this option will turn the DATs in these directories into single archives. If enabled, this option allows you to specify how to handle subdirectories. The options are:

  • Add SubDirs
  • No SubDirs
  • Add SubDirs if conflicts
  • Add SubDirs if multiple roms

This setting is extremely powerful and enables you to build a collection to match TOSEC torrents. It can also be used to create uncompressed sets without requiring subdirectories.

The Single Archive subdirectory settings are outlined in more detail here: Single Archive Options




Cascading Settings

Settings for a directory will cascade to all of that directory's descendants until overwritten by a higher priority setting. Settings for descendant subdirectories are always a higher priority than the settings for ancestor directories.

Directory settings of descendants are not “merged” with the settings of their ancestors. All directory settings are complete overrides.

These cascading settings allow for a great deal of control over your ROM storage strategy. For example, you can apply settings at the root level that you would like to apply to all directories, and then override those settings on a case by case basis for certain DATs.

directory_settings.txt · Last modified: 2020/11/25 18:15 by johnsanc