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.

Install CHDMan on Unraid in a few clicks.

Find CHDMan in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for CHDMan Review the template variables and paths Click Install

Download Statistics

220
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