RomsOrganizer

What it does

Conservative matching

For RetroAchievements filtering, the README says it acts only when exactly one version in a group is recognized and otherwise leaves the group unchanged.checked 4 Oct 2026

Duplicate detection

It handles same-name files, format variants, region or revision duplicates, and byte-for-byte duplicates with different names.checked 4 Oct 2026

Duplicate types

It identifies same-name files, format variants, region or revision variants, and byte-identical files by hash.checked 4 Oct 2026

Gamelist cleanup

It removes duplicate and orphan gamelist entries and sorts the list alphabetically.checked 4 Oct 2026

Installation and interface

The installer adds the app to Batocera's PORTS menu, where it runs with a controller-friendly pygame interface.checked 4 Oct 2026

Interface

The app uses a pygame arcade-style interface in Batocera's PORTS menu and supports controller navigation.checked 4 Oct 2026

Known issues

The repository's issues page lists five open issues, including reports about restore overwriting recreated files, silent file-operation failures, and duplicate handling.checked 4 Oct 2026

License

The code is licensed under MIT, and the README says the project is not affiliated with Batocera, RetroBat, or RGS.checked 4 Oct 2026

Multi-disc handling

Its 1G1R comparison matches discs only against discs with the same index across regions.checked 4 Oct 2026

Paired files

Paired cue, bin, ccd, and sub tracks are excluded from hash matching so the app does not separate those sets.checked 4 Oct 2026

Preview

It offers a dry-run preview before each operation so users can review and confirm the proposed changes.checked 4 Oct 2026

Purpose

RomsOrganizer finds and removes duplicate ROMs from Batocera game lists, with built-in backup and restore.checked 4 Oct 2026

Recovery

The README says duplicates are moved to a ROM elimination folder and can be restored from the menu using a manifest.checked 4 Oct 2026

Requirements

The project states that it requires Python 3 and pygame, which it says is usually already present in Batocera.checked 4 Oct 2026

RetroAchievements

For supported cartridge systems, it can keep the version with a hash recognized by RetroAchievements; the hash database is bundled.checked 4 Oct 2026

ROM tidying

It cleans up displayed ROM names and moves ROMs to the appropriate system.checked 4 Oct 2026

Safety

The app moves duplicates to a holding folder instead of deleting them and provides a menu option to restore them.checked 4 Oct 2026