Skip to content

Home

Jump to bottom
github-actions[bot] edited this page Sep 27, 2026 · 6 revisions

MiSTer FPGA Game Library Audit Wiki

This wiki documents the behavior currently implemented in the repository. The GitHub repository is authoritative.

Pages

  • Audit workflow — Fast Audit, Full Verification, hashing, cache behavior, and report publishing.
  • Hash database — bundled TSV schema, matching rules, normalized hashes, and supported systems.
  • Reports — files written under /media/fat/GameLibraryAudit and what each contains.
  • Rename workflow — Preview, Apply, Rollback, curated destinations, and safeguards.
  • Safety and invariants — boundaries that protect the library.
  • Update All installation — installation and publishing through MiSTer Downloader.

Current implementation

The current release is v1.4. A single unified MiSTer_Audit.sh runtime provides the read-only audit plus guarded Preview / Apply / Rollback tools. Development source is split across src/audit.sh, src/update.sh, and src/main.sh, then assembled by tools/build_runtime.sh.

Authoritative DAT matches provide canonical naming and ROM-type classification. Retail/Standard ROMs remain in the parent system folder; Homebrew, Unlicensed, Aftermarket, Prototype, Beta, Demo/Sample, Translation, and Hack/Modified ROMs use one shared category folder per type. These are ROM release/status categories, not gameplay genres, and there is no per-ROM folder layer.

Update All distributes exactly two files under /media/fat/Scripts/: MiSTer_Audit.sh and mister_hash_database.tsv.

Clone this wiki locally