Skip to content

AyeBathingApe/tochd-gui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tochd-gui — ISO to CHD Converter

A tiny, dependency-free Windows GUI for converting game disc images (.iso, .cue+.bin, .gdi) into the compressed CHD format used by RetroArch, MAME, and other emulators.

Just download the exe, click Browse to pick your ISO, Browse to pick an output folder, and hit Start. A progress bar shows how the conversion is going.

Built with Python's stdlib Tkinter and packaged as a single .exe with PyInstaller. Under the hood it shells out to MAME's chdman.exe to do the actual work.


Features

  • ✅ Single-file Windows executable — no install, no Python required
  • ✅ Browse for input ISO / CUE / GDI
  • ✅ Browse for output folder
  • ✅ Live progress bar parsed from chdman output
  • ✅ Cancel button
  • ✅ Auto-detects chdman.exe if it's on PATH or sitting next to the app
  • ✅ Falls back from createcd to createdvd automatically for DVD-sized ISOs

Requirements

You need chdman.exe on your machine. It's part of MAME tools and is not bundled with this app.

Get chdman

  1. Go to MAME Releases on GitHub.
  2. Download the latest mame<version>b_64bit.exe (it's a self-extracting 7-Zip archive, not an installer).
  3. Run it and extract somewhere convenient, for example:
    • C:\Tools\mame\ (auto-detected), or
    • a MAME folder next to tochd-gui.exe (auto-detected), or
    • anywhere else — you can browse to it once and the path will stay filled in for that session.

Auto-detect search order:

  1. chdman.exe next to tochd-gui.exe
  2. MAME\chdman.exe next to tochd-gui.exe
  3. mame\chdman.exe next to tochd-gui.exe
  4. System PATH
  5. C:\Program Files\MAME\chdman.exe
  6. C:\mame\chdman.exe
  7. C:\Tools\mame\chdman.exe

Usage

  1. Launch tochd-gui.exe.
  2. Input — browse to your .iso, .cue, or .gdi file.
  3. Output folder — pre-filled to the input's folder; change if you want.
  4. chdman.exe — auto-filled if found, otherwise browse to it once.
  5. Click Start.

The output .chd will be named after the input file (e.g. MyGame.isoMyGame.chd).


Building from source

git clone https://github.com/AyeBathingApe/tochd-gui
cd tochd-gui
python tochd_gui.py            # run from source
.\build_exe.bat                # build dist\tochd-gui.exe

Requires Python 3.10+ on Windows. PyInstaller is the only build dependency and is installed automatically by build_exe.bat.


Credits & inspiration

This project was inspired by tochd by Tuncay D. — an excellent Linux command-line tool that performs the same ISO→CHD conversion with optional 7z archive extraction and batch processing. If you're on Linux, or if you want a powerful CLI with batch support, go use the original — it's great. Give it a star.

tochd-gui is an independent Windows GUI. It does not include or invoke tochd.py at runtime; it talks to chdman directly. The name acknowledges the inspiration.

chdman.exe is part of MAME, developed by the MAME team and contributors and licensed under the BSD-3-Clause license. It is not bundled with this repo; users download it from the official MAME releases.

See THIRD_PARTY_NOTICES.md for full license details of upstream projects.


License

MIT © 2026 AyeBathingApe

About

Windows GUI for converting ISO/CUE/GDI disc images to CHD using MAME's chdman. Inspired by thingsiplay/tochd.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors