This project was built with Claude.

chd-to-iso

A small web app that converts PS2 CHD images to ISO format on demand. Drop CHD files into a directory, open the browser, click Download — chdman handles the conversion server-side and the ISO streams straight to your machine.

Usage

Container (recommended)

Mount your CHD directory to /chds and expose port 8000:

docker run -v /path/to/chds:/chds -p 8000:8000 git.cpressland.io/cpressland/chd-to-iso:latest

Then open http://localhost:8000 in a browser. mame-tools is bundled in the image.

Local

Requires Python 3.14+ and uv. chdman must be in $PATH (macOS: brew install mame-tools, Debian/Ubuntu: apt install mame).

uv run chd-to-iso

The app reads CHD files from a chds/ directory relative to the working directory.

Deployment

CI builds and pushes a multi-arch (amd64/arm64) image to git.cpressland.io on any vX.Y.Z tag.