CHDMan

CHDMan

Docker app from Florian Dambrine's Repository

Overview

Docker CHD "Compressed Hunks of Data" Converter. Compresses GDI, ISO, BIN and CUE files to CHD using CHDMAN from MAME Tools. Skips existing .chd files and does not modify source files.

chdman-walker

Alpine-based Docker image that recursively walks a directory and converts disc images to CHD (Compressed Hunks of Data) using chdman from mame-tools.

Features

  • Recursively scans subdirectories — handles entire ROM library structures
  • Skips files that already have a corresponding .chd (safe to re-run)
  • Never modifies or deletes source files
  • Multi-platform image (linux/amd64, linux/arm64)
  • Minimal Alpine base

Supported modes

CHDMAN_MODE Input Output Use case
createcd (default) .gdi, .cue, .iso .chd PS1, Dreamcast, CD-based consoles
createdvd .iso .chd PSP (UMD), PS2, DVD-based systems
extractcd .chd .cue + .bin Extract CD CHD back to image
extractdvd .chd .iso Extract DVD CHD back to ISO

Quick start

# Convert all GDI/CUE/ISO in a folder (and subfolders) to CHD
docker run --rm \
  -e CHDMAN_MODE=createcd \
  -v "/path/to/roms:/input" \
  lowess/chdman-walker

# PSP / PS2 — use createdvd
docker run --rm \
  -e CHDMAN_MODE=createdvd \
  -v "/path/to/roms:/input" \
  lowess/chdman-walker

Environment variables

Variable Default Description
CHDMAN_MODE createcd Conversion mode (see table above)
INPUT_DIR /input Directory to scan inside the container

Unraid

A community template is available at Lowess/docker-templates-unraid.

Download Statistics

741
Total Downloads

Related apps

Explore more like this

Explore all

Details

Repository
lowess/chdman-walker
Last Updated2026-04-01
First Seen2026-04-01

Runtime arguments

Network
none
Privileged
false

Template configuration

Images DirectoryPathrw

Directory containing your source disc images (GDI, ISO, BIN, CUE) for conversion, or your CHD files for extraction. Converted files are written to the same directory.

Target
/input
Default
/mnt/user/data/media/roms
Value
/mnt/user/data/media/roms
Conversion ModeVariable

Conversion mode. Options: createcd (default, for CD-based systems like PS1/Dreamcast), createdvd (for DVD-based systems like PSP/PS2), extractcd (CHD → ISO for CD), extractdvd (CHD → ISO for DVD).

Target
CHDMAN_MODE
Default
createcd
Value
createcd