directory_settings
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
directory_settings [2022/11/07 18:00] – johnsanc | directory_settings [2024/04/10 18:27] (current) – johnsanc | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== |
- | Directory | + | DAT rules 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. |
- | |**⚠ WARNING:** \\ The RomVault UI will allow you map multiple DATs to a single directory. Do NOT map multiple DATs to the same ROM directory. Doing so may result in unintentional file deletions during a fix operation if the " | + | <WRAP alert>The RomVault UI will allow you map multiple DATs to a single directory. Do NOT map multiple DATs to the same ROM directory. Doing so may result in unintentional file deletions during a fix operation if the " |
- | |**⚠ CAUTION:** \\ Directory rules can only be applied to standard directories, | + | <WRAP important> |
The directory settings can be accessed in two ways: | The directory settings can be accessed in two ways: | ||
Line 13: | Line 13: | ||
{{: | {{: | ||
\\ | \\ | ||
- | |||
----- | ----- | ||
- | + | ===== Rule Path and Directory Location | |
- | ===== Rule Path ===== | + | \\ |
+ | {{: | ||
+ | \\ | ||
+ | \\ | ||
+ | ==== Rule Path ==== | ||
This field is for reference and is not editable. The root of your entire setup is always called " | This field is for reference and is not editable. The root of your entire setup is always called " | ||
Line 23: | Line 26: | ||
- | ===== Dir Location | + | ==== Dir Location ==== |
The Dir Location is the path to your ROMs. The folder icon allows you to choose the location by browsing. | The Dir Location is the path to your ROMs. The folder icon allows you to choose the location by browsing. | ||
Line 32: | Line 35: | ||
* '' | * '' | ||
- | |**⚠ CAUTION: | + | ----- |
- | + | ===== Directory / Merge Rules ===== | |
- | + | \\ | |
- | ===== 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 ==== | ||
+ | If two or more DATs share a 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.| | + | <WRAP info>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.</ |
- | ===== Archive Type ===== | + | ==== Archive Type ==== |
This option allows you to specify your preferred way packaging your ROMs. Options include: | This option allows you to specify your preferred way packaging your ROMs. Options include: | ||
* **File** - Sets will be stored uncompressed | * **File** - Sets will be stored uncompressed | ||
Line 50: | Line 56: | ||
- | ===== Merge Type ===== | + | ==== Merge Type ==== |
This option allows you to specify your preferred way of merging your ROMs. This is primarily used for MAME DATs. Options include: | 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 | * **Nothing** - No preference, generally used for non-MAME sets where merging does not apply | ||
Line 62: | Line 68: | ||
- | ===== ROM/CHD Filter | + | ==== ROM/CHD Filter ==== |
This option allows you to specify what types of files to allow. This is primarily used for MAME DATs. Options include: | 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 most cases. | * **ROMs & CHDs** - Both ROMs and CHDs will be included. This option should be used in most cases. | ||
Line 69: | Line 75: | ||
- | ===== Header Type ===== | + | ==== Header Type ==== |
This option allows you to specify how you want to handle ROM headers. | This option allows you to specify how you want to handle ROM headers. | ||
* **Optional** - Both headered and headerless ROMs will be allowed if a header skipper is declared in the DAT. | * **Optional** - Both headered and headerless ROMs will be allowed if a header skipper is declared in the DAT. | ||
Line 75: | Line 81: | ||
* **Headerless** - Only ROMs without headers will be included. | * **Headerless** - Only ROMs without headers will be included. | ||
- | |**ⓘ NOTE:** \\ | + | <WRAP info>The " |
- | ===== Single Archive | + | ==== 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: | 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** | * **Add SubDirs** | ||
Line 89: | Line 95: | ||
- | ===== Use description (instead of name) for auto added paths ===== | + | ==== Use description (instead of name) for auto added paths ==== |
- | 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 (instead of name) for auto added paths" option is __disabled__ then these subdirectories will be named as follows: | + | If two or more DATs share a directory |
* The value of the ''< | * The value of the ''< | ||
* If no ''< | * If no ''< | ||
Line 99: | Line 105: | ||
* If no ''< | * If no ''< | ||
+ | ----- | ||
+ | |||
+ | ===== Advanced Options ===== | ||
+ | \\ | ||
+ | {{: | ||
+ | \\ | ||
+ | \\ | ||
+ | ==== Use ID for Numbered DAT Names (No-Intro DATs) ==== | ||
+ | This option will prefix the set name with the value of the id attribute in the DAT. This is typically only applicable for No-Intro DATs that have release numbers. | ||
+ | |||
+ | ==== Only Keep Complete Sets ==== | ||
+ | This option will prevent incomplete sets. This is useful when you only want to collect a subset of games in DAT or you want to ensure everything you collect has all files for playability in a frontend. | ||
+ | |||
+ | ----- | ||
+ | ===== Filename Exclude ===== | ||
+ | \\ | ||
+ | {{: | ||
+ | \\ | ||
- | ===== Filenames not to remove | + | ==== Filenames not to remove ==== |
This setting allows you to specify rules for files to ignore. Any ignored files are still scanned by RomVault, but they are flagged with an " | This setting allows you to specify rules for files to ignore. Any ignored files are still scanned by RomVault, but they are flagged with an " | ||
Line 106: | Line 130: | ||
|Exact|'' | |Exact|'' | ||
|Wildcard|'' | |Wildcard|'' | ||
- | |Regex|'' | + | |Regex|'' |
- | |**ⓘ NOTE:** \\ | + | <WRAP info>Each ignore rule must be on its own line. Wildcard rules support ''?'' |
- | |**💡 TIP:** \\ | + | <WRAP tip>For assistance with regex, try [[https:// |
----- | ----- | ||
\\ | \\ | ||
- | ====== Cascading Directory Rules ====== | + | ===== Cascading Directory Rules ===== |
Settings for a directory will cascade to all of that directory' | Settings for a directory will cascade to all of that directory' | ||
Line 126: | Line 150: | ||
If '' | If '' | ||
+ | |||
+ | ===== Video Tutorial ===== | ||
+ | {{youtube> |
directory_settings.1667872844.txt.gz · Last modified: 2022/11/07 18:00 by johnsanc