Your ROM companion - Convert, compress, verify, and organize disc images and cartridge ROMs.

• CHD Conversion - Convert CUE, GDI, ISO to compressed CHD format (40-60% space savings)
• CHD Extraction - Extract CHD files back to their original format (CUE/BIN, ISO)
• M3U Playlist Creation - Automatically organize multi-disc games
• CHD Verification - Verify CHD file integrity with chdman
• CUE/BIN Validation - Check file structure and references

• ROM Health Check - Verify ROMs against No-Intro/Redump databases
• Multi-level Verification - 5 confidence levels (100% to 80%)
• ROM Hack Detection - Identify translations and modifications
• Header Detection - Find external copier headers (SNES, NES)
• Fuzzy Matching - Smart filename and checksum comparison

Cartridges:

• Nintendo: NES, SNES, N64, GB, GBC, GBA, NDS, 3DS
• Sega: Genesis, Master System, Game Gear, 32X
• Atari: 2600, 5200

Discs:

• Sony: PS1, PS2, PS3, PSP
• Nintendo: GameCube, Wii
• Sega: Saturn, Dreamcast, Sega CD
• Microsoft: Xbox, Xbox 360
• SNK: Neo Geo CD

1. Download RomMate.exe from the Releases page
2. Double-click and run, no installation needed

Note: Windows may show a "Windows protected your PC" SmartScreen warning, since RomMate isn't code-signed. This is expected for open-source apps without a paid certificate. Click "More info" → "Run anyway" to proceed. You can verify your download against the SHA256 checksum listed on the release page.

1. Download RomMate-x86_64.AppImage from the Releases page
2. Double-click and run, no installation needed

# Prerequisites
sudo apt install python3 python3-tk  # Linux only
pip install tkinterdnd2 customtkinter

git clone https://github.com/rchaicowski/rommate.git
cd rommate
python3 rommate.py

1. Launch RomMate
2. Select a folder containing your ROMs or disc images
3. Choose an operation:
   • Convert to CHD
   • Extract CHD to original format
   • Create M3U playlists
   • Check ROM health
   • Validate & fix ROM names
4. Click Start and let RomMate do the work!

Access settings via the gear icon:

• Sound preferences
• Folder behavior (remember last / default)
• Conversion options
• Language (9 languages supported)

rommate/
├── core/
│   ├── chd_converter.py       # CHD conversion logic
│   ├── m3u_creator.py          # M3U playlist creation
│   ├── rom_health.py           # ROM verification
│   └── cartridge_checker.py    # Cartridge ROM validation
├── gui/
│   ├── main_window.py          # Main interface
│   ├── processing_panel.py     # Progress display
│   ├── completion_panel.py     # Results screen
│   └── settings_panel.py       # Settings interface
├── utils/
│   ├── config.py               # Configuration management
│   ├── i18n.py                 # Internationalization
│   ├── sounds.py               # Sound playback
│   ├── theme.py                # UI theming
│   └── file_utils.py           # File operations
├── databases/
│   ├── no-intro/               # Cartridge ROM databases
│   └── redump/                 # Disc ROM databases
├── locales/                    # Translations (EN, PT, ES, FR, DE, IT, JA, ZH)
├── icon.png                        # App icon (Linux)
├── icon.ico                        # App icon (Windows)
└── sounds/                         # Sound effects

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the GNU General Public License v3.0 (GPLv3).

See LICENSE file for full text.

• ✅ You can use, modify, and distribute this software
• ✅ You must keep the source code open
• ✅ You must license derivative works under GPLv3
• ✅ You must credit the original authors

• MAME chdman - CHD compression and verification
• Python tkinter - GUI framework
• tkinterdnd2 - Drag and drop support
• customtkinter - Modern UI widgets (toggle switch)
• pycaw - Windows audio control

• No-Intro - Cartridge ROM databases
• Redump - Optical disc databases

• The ROM preservation community
• MAME development team
• No-Intro and Redump projects

Found a bug or have a feature idea?

• Open an issue on GitHub
• Include your OS, app version, and steps to reproduce

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Ko-fi: Support the project

Made with love for the ROM preservation community