User Tools

Site Tools


ui_overview

RomVault Interface Overview




Side Buttons

The side buttons include the main actions needed for working with RomVault on a regular basis.

Shortcuts:

Action Mouse Keyboard
Updating DATs
Update new DATs LEFT/RIGHT CLICK F5
Refresh all DATs SHIFT + CLICK SHIFT+F5
Open DATVault CTRL + CLICK CTRL+F5
Scanning ROMs
Scan ROMs (hash new, renamed, modified) LEFT CLICK F6
Quick scan ROMs (check archive headers only) SHIFT+F6
Force rescan ROMs (decompress and rehash) CTRL+F6
Finding fixes
Find fixes for ROMs LEFT CLICK F7
Fixing ROMs
Fix ROMs LEFT CLICK F8
Scan ROMs, find fixes, and fix ROMs RIGHT CLICK
Generating reports
Generate Fix DATs for red status ROMs only LEFT CLICK F9
Generate Fix DATs for red and yellow status ROMs RIGHT CLICK
Generate a full text report SHIFT+F9
Generate a text report for fixes CTRL+F9
Saving and applying tree presets
Apply tree selection preset (1-4) LEFT CLICK
Save tree selection preset (1-4) RIGHT CLICK



DAT Tree

The DAT tree represents all of your DATs as you have them stored in your DATRoot.

Shortcuts:

Action Mouse
Selecting scope for scanning and fixing
Select or deselect LEFT CLICK
Select or deselect without impacting decedents SHIFT + LEFT CLICK
Mark as read only RIGHT CLICK
Expanding and collapsing the tree
Expand or collapse children LEFT CLICK
Expand or collapse all decendants RIGHT CLICK
Viewing info and accessing context menus
View information in info panel LEFT CLICK
Open context menu RIGHT CLICK



Info Panel

The info panel displays information about the DAT or game set you currently have selected.

DAT Info:

FieldDescription
NameName value from the DAT header or the current directory name
DescriptionRespective values from the DAT header
Category
Author
Version
Date
ROM PathPath to the ROMs for the current DAT or the current full directory path
ROMs GotTotal ROMs you have (green) in the current and descendant directories
ROMs MissingTotal ROMs missing (red) in the current and descendant directories
ROMs FixableTotal ROMs which are fixable (yellow, orange, purple, brown) in the current and descendant directories
ROMs UnknownTotal ROMs which are an unknown status (cyan) in the current and descendant directories

Game Info:

FieldDescription
Directory
NameName of the current directory
Standard Set
NameRespective values for the set from the DAT
Description
Manufacturer
Clone of
Rom of
Year
Total ROMs???
Trurip / EmuArc Set
NameRespective values for the set from the DAT
Description
Publisher
Developer
Title ID
Source
Clone of
Related to
Year
Players
Genre
SubGenre
Ratings
Score

Set Filters:
Refer to the color key for more information about statuses.

FilterStatuses
(Always displayed)
☑ Show complete sets
☑ Show incomplete sets
☑ Show sets with fixes
☑ Show merged ROMs
ⓘ NOTE:
The search box filters the game list grid using case insensitive string matching. Regex is not supported.



Game List Grid

The game list grid displays the games or sets that you have for the DAT selected.

Column Reference:

ColumnDescriptionSortable
TypeStorage type for the set or folder for a directory. Refer to the set type section of color key.Yes
Game (Directory / Zip)Directory or set nameYes
DescriptionDescription value from the DATYes
ROM StatusRefer to the color key.No

Shortcuts:

Action Mouse
Launch game (if configured, see advanced settings for details) DOUBLE LEFT CLICK
an archive
Navigate down a level into a directory DOUBLE LEFT CLICK
a directory
Navigate up a level to parent directory DOUBLE RIGHT CLICK
in the white space
Copy game directory/archive name and description to clipboard RIGHT CLICK
a row
💡 TIP:
You can navigate one level higher than your RomRoot (RomVault in the DAT tree) to see both your RomRoot and ToSort directories in the grid by using the double right click shortcut.



ROM Details Grid

The ROM details grid displays the details of each ROM or file in game you have selected.

Column Reference:

ColumnDescriptionSortable
GotStatus. Refer to the status and fix planning sections of the color key.Yes
ROM (File)Names of the files in the set.Yes
MergeNames of the files that are included in a parent set.Yes
SizeSize of the file.Yes
CRC32CRC32 hash of the file.Yes
SHA1SHA1 hash of the file.Yes
MD5MD5 hash of the file.Yes
AltSize*Alternate size of the file.
- Headered ROMs: Size excluding the header
- CHDs: Not applicable
Yes
AltCRC32*Alternate CRC32 of the file.
- Headered ROMs: CRC32 hash excluding the header
- CHDs: Not applicable
Yes
AltSHA1*Alternate SHA1 of the file.
- Headered ROMs: SHA1 hash excluding the header
- CHDs: Internal SHA1 hash of contents
Yes
AltMD5*Alternate MD5 of the file.
- Headered ROMs: MD5 hash excluding the header
- CHDs: Internal MD5 hash of contents
Yes
ZipIndexIndex number or order of the files in the archive.Yes
Instance CountNumber of times the file appears in your RomVault cache. Only updated after executing a “Find Fixes” action.Yes
ⓘ NOTE:
The Alt columns are only displayed if the set contains files that have alternate sizes or hashes. This applies to CHDs and headered ROMs (NES, FDS, Lynx, 7800, etc.)

Data Source Flags:

  • D = Value from the DAT
  • F = Value from the archive file header (Not applicable for uncompressed sets)
  • V = Verified value from checking the size and hashing the file to calculate CRC32, SHA1, and MD5

Header Flags:

  • A7800 = Atari 7800
  • CHD = Compressed Hunks of Data
  • FDS = Famicom Disk System
  • Lynx = Atari Lynx
  • NES = Nintendo Entertainment System
  • PCE = NEC PC Engine / TurboGrafx
  • PSID = Commodore 64 SID (Sound Interface Device) Audio
  • SNES = Super Nintendo Entertainment System
  • SPC = SNES Audio

CHD Version Flags:

  • V1 = Version 1 - Checked natively by RomVault, chdman.exe does not support
  • V2 = Version 2 - Checked natively by RomVault if compression is not AVHuff, chdman.exe otherwise
  • V3 = Version 3 - Checked natively by RomVault if compression is not AVHuff, chdman.exe otherwise
  • V4 = Version 4 - Checked with chdman.exe
  • V5 = Version 5 - Checked with chdman.exe

Example: A headered NES ROM of “Super Mario Bros. (World)” from the No-Intro set compressed in a ZIP archive would have the following values if using a DAT with a header skipper:

ColumnValueFlagsExplanation
NameSuper Mario Bros. (World).nesNES DFThe DAT has an NES header skipper (D) and the file scanned has an NES header (F)
Size40,976FVThe actual scanned size is larger than the DAT size because the DAT excludes the ROM header
CRC323337ec46FVThe actual CRC32 is different than the DAT CRC32 because the DAT excludes the ROM header
SHA1ea343f4e445a9050d4b4fbac2c77d0693b1d0922VThe ZIP header does not store SHA1, and the actual SHA1 is different than the DAT SHA1 because the DAT excludes the ROM header
MD5811b027eaf99c2def7b933c5208636deVThe ZIP header does not store MD5, and the actual MD5 is different than the DAT MD5 because the DAT excludes the ROM header
AltSize40,960DVThe DAT size is smaller than the actual scanned size because the DAT excludes the ROM header
AltCRC32d445f698DVThe DAT CRC32 is different from the actual scanned CRC32
AltSHA1facee9c577a5262dbe33ac4930bb0b58c8c037f7DVThe DAT SHA1 is different from the actual scanned SHA1
AltMD58e3630186e35d477231bf8fd50e54cddDVThe DAT MD5 is different from the actual scanned MD5

Shortcuts:

Action Mouse
Copy file name, size, and hashes to clipboard RIGHT CLICK
anywhere in a row
View list of ROM occurrences LEFT CLICK
the Instance Count value



Repair Status Log

The repair status window shows a detailed log of all the actions RomVault is performing during a fix.

Status Reference:

StatusDescription
DeleteThe file was deleted permanently
RenameThe file was renamed in its current location
TrrntZippingThe file was recompressed to TorrentZip
<<--CompressThe file was compressed to the same archive, typically for file renames within archives
<-CompressThe file was compressed to a different archive
<<--RawThe file was raw copied to the same archive (TorrentZip only), typically for file renames within archives
<--RawThe file was raw copied to a different archive (TorrentZip only)
<--CopyThe file was copied to another set
<--MoveThe file was moved to another set
-->The file in the archive was decompressed to the 7z cache or copied to ToSort
Raw-->The file in the archive was raw copied to ToSort (TorrentZip and corrupt archives only)
ui_overview.txt · Last modified: 2022/01/17 07:07 by johnsanc