A cross-platform desktop application for validating ROM files against DAT files and generating new No-Intro compliant DAT files from your collection. Runs on Windows, Linux and macOS.
Documentation: https://purelogiccode.github.io/RomValidator/ Β |Β Release notes: see docs/release-notes.md
- ROM Validation: Validate your ROM collection against No-Intro XML DAT files
- DAT File Generation: Generate new No-Intro compliant DAT files from your ROM collection
- Duplicate Detection: Identify duplicate ROM files in your collection
- Multiple Hash Support: CRC32, MD5, SHA-1, and SHA-256 hash verification
- Cross-Platform: Windows, Linux and macOS builds on x64 and ARM64, published as single-file executables
- Archive Support: Read ROMs directly from
.zip,.7z, and.rararchives (SharpCompress). Windows bundles include7za.exe/7za_arm64.exenext to the application as a fallback; on Linux and macOS a system-installed7zz,7zor7zais used when available - Modern Dark Theme: Avalonia 12.1 with the Fluent theme and a custom professional dark palette
- Live Activity Log: a full-height, resizable log panel on the right of the validation screen, with controls and DAT information on the left
- Screenshot Capture: Press F8 to save a screenshot of the active window to the
Screenshotfolder next to the executable, falling back to the per-user data folder when the application folder is read-only - App Data Button: the App Data button in the top-right corner opens the per-user data folder β logs (
Logs/) and fallback screenshots (Screenshot/) live there, always writable even when the application is installed in a protected location - Donate Button: the Donate button in the top-right corner (next to About) opens the donation page in your default browser
- Version Checking: Automatic GitHub version checking at startup, with a prompt to open the release page when an update is available
- Robust Error Handling: Retry-based temp-directory cleanup, binary-format detection for wrongly selected DAT files, and automatic bug reports (Serilog) β all Warning, Error, and Fatal events are forwarded to the bug report API
- Windows 10/11, Linux or macOS 11+ on x64 or ARM64
- .NET 11 Desktop Runtime - the single-file application is framework-dependent
- 7-Zip - the Windows bundle ships
7za.exefor x64 and7za_arm64.exefor ARM64 (7-Zip 26.03); on Linux and macOS an optional system7zz,7zor7zaenables the archive fallback
- Download the bundle for your platform and architecture from the latest release:
- Windows:
release_<version>_win-x64.ziporrelease_<version>_win-arm64.zip - Linux:
release_<version>_linux-x64.tar.gzorrelease_<version>_linux-arm64.tar.gz - macOS:
release_<version>_osx-x64.dmgorrelease_<version>_osx-arm64.dmg
- Windows:
- Install it:
- Windows: extract the zip to a permanent folder and run
RomValidator.exe. The application refuses to run directly from a zip archive or a temporary folder. - Linux: extract the archive, make the executable startable if needed (
chmod +x RomValidator), then run./RomValidator. - macOS: open the
.dmgand dragROM Validator.appto your Applications folder, then launch it from there.
- Windows: extract the zip to a permanent folder and run
Every bundle contains one single-file executable and requires the .NET 11 Desktop Runtime. Windows bundles also ship 7za.exe and 7za_arm64.exe alongside the application. Every bundle also contains LICENSE.txt, ReadMe.md and WhatsNew.md.
Full instructions: Getting Started.
The complete documentation lives in the docs/ folder and is published to:
- Documentation site: https://purelogiccode.github.io/RomValidator/
- GitHub Wiki: https://github.com/purelogiccode/RomValidator/wiki
| Section | Contents |
|---|---|
| Getting Started | Install, first run, quick start |
| User Guide | Validation, DAT generation, duplicates, archives, data |
| Reference | Formats, troubleshooting, build, architecture, CI/CD |
| FAQ | Frequently asked questions |
| Contributing | Bugs, features, pull requests |
- Launch the application
- Navigate to the "Validate ROMs" tab
- Load a DAT file (No-Intro format,
.dator.xml) - Select your ROM directory or archive
- Click "Start Validation" to begin
- Review the results: matched, failed, unknown, renamed, and duplicate files, with live progress stats
- Navigate to the "Generate DAT" tab
- Select your ROM directory
- Configure output settings (name, description, author)
- Click "Start Hashing" to compute hashes, then "Export DAT"
- Save the generated DAT file for use with other ROM management tools
- Use F8 anytime to capture a screenshot of the active window.
- Click App Data (top-right, next to About) to open the folder where logs and fallback screenshots are stored.
- DAT files must be No-Intro XML; ZIP archives, binary images, and ClrMamePro/MAME formats are detected and rejected with a clear message.
- If a file is temporarily locked (e.g. still being written), the app retries automatically and cleans up leftover temp folders in the background.
Logs (Logs/) and fallback screenshots (Screenshot/) live in a per-user data folder:
| Platform | Folder |
|---|---|
| Windows | %LOCALAPPDATA%\ROM Validator |
| macOS | ~/Library/Application Support/ROM Validator |
| Linux | ~/.local/share/ROM Validator (the XDG data directory when set) |
Primary screenshots are written to the Screenshot folder next to the executable when that folder is writable. See Screenshots and Application Data.
- Avalonia (12.1.6): cross-platform UI framework, Fluent theme, Inter font and DataGrid
- Serilog (4.4.0) + Sinks (Debug, File): structured logging and automatic bug reports
- SharpCompress (0.50.9): zip/7z/RAR archive reading and zip/7z archive creation
- 7-Zip 26.03 (
7za.exe/7za_arm64.exe): shipped next toRomValidator.exein the Windows bundles; a system7zz,7zor7zais used on Linux and macOS when present - xUnit (2.9.3), Microsoft.NET.Test.Sdk (18.12.0), coverlet.collector (10.1.0): testing
The solution includes unit and integration tests (models, services, hash calculation, archive handling, temp-directory cleanup, serialization). Run them with:
dotnet test
The suite runs on Windows, Linux and macOS; CI executes it on all three platforms.
| Workflow | Purpose |
|---|---|
| CI | Builds and tests on windows-latest, ubuntu-latest and macos-latest, and runs JetBrains InspectCode with zero findings |
| Release | Runs the test suite, then publishes single-file framework-dependent bundles for win-x64/win-arm64, linux-x64/linux-arm64 and osx-x64/osx-arm64 (with license, readme and what's new) plus checksums on release_* / v* tags, with generated release notes |
| Docs | Publishes the documentation site and mirrors docs/ to the wiki |
See CI/CD for details.
See WhatsNew.md for the latest release highlights and Release Notes for the full history.
- No-Intro for the DAT file format specification
- Avalonia for the cross-platform user interface
- SharpCompress for archive support
- 7-Zip for the standalone fallback executables
- Donate: If you find this project useful, consider supporting the developer.
- If you like this project, please give us a star on GitHub! β
This project is licensed under the GPLv3 License β see the LICENSE file for details.
Copyright (C) 2026 Peterson Fernandes β PureLogicCode.com

