Unofficial, fully static AppImage of unecm — Neill Corlett's decoder
for ECM (Error Code Modeler) CD-image files — for x86_64 Linux. Static means
no glibc or library requirements whatsoever — it runs on any distribution,
however old or new, including minimal containers and distros without FUSE.
The ECM sources (v1.0, GPL v2+) are vendored in external/ — ECM has been
frozen for two decades, so there is nothing to track upstream. Companion
repo: chdman-appimage (compresses
the decoded image to .chd).
am -e https://github.com/hcet-sudo/unecm-appimage unecm unecm
curl -LO https://github.com/hcet-sudo/unecm-appimage/releases/latest/download/unecm-x86_64.AppImage
chmod +x unecm-x86_64.AppImage
Without FUSE, run ./unecm-x86_64.AppImage --appimage-extract-and-run ....
./unecm-x86_64.AppImage game.bin.ecm # writes game.bin
./unecm-x86_64.AppImage game.bin.ecm out.bin # explicit output name
Then compress the result to a .chd with
chdman:
./chdman-x86_64.AppImage createcd -i game.cue -o game.chd
The GitHub Actions workflow (.github/workflows/release.yml) runs on every
push that touches the build or sources, and on demand (Actions → Build and
release → Run workflow):
- Compiles
unecmstatically from the vendored sources. - Self-tests it — generates a valid MODE1/2352 CD image, encodes it
with the
ecmencoder (built in CI from the same source, not shipped), decodes it back with the AppImage, and requires bit-identical results. - ISA-gates it — the release only publishes if the same bit-perfect
self-test also passes under
qemuemulating a baseline x86-64-v1 CPU, so the AppImage runs on every x86_64 CPU, however old. - Publishes a release tagged
<ver>@<date>_<epoch>with the stable asset nameunecm-x86_64.AppImage, soreleases/latest/download/...always points at the newest build.
gcc -O2 -Wall -s -static -o unecm external/unecm.c
bash build/build-unecm.sh # also packages the AppImage
bash build/self-test-unecm.sh dist/unecm-x86_64.AppImage dist/ecm
- Replace
hcet-sudowith your GitHub username in this README:grep -rl hcet-sudo . | xargs sed -i 's/hcet-sudo/yourname/g'. - Push the repo to GitHub (terminal or the web UI's "Upload files" flow —
the workflows invoke scripts via
bash, so missing execute bits on web-uploaded files don't matter). - Repo Settings → Actions → General → Workflow permissions → Read and write (the release job needs write access to publish releases).
- Test with Actions → "Build and release" → Run workflow.
To make plain am -i unecm work for everyone, submit an installation
script to the AM database: run
am -t unecm, choose the GitHub option, then open a PR adding the
generated script to programs/x86_64/ and its name to the x86_64-apps
list. (As of Nov 2026 there is no unecm entry in the AM database — you
would be the first.)
- ECM sources by Neill Corlett are GNU GPL v2 or later (header text in
external/ecm.c/external/unecm.c). - Build scripts and icons in this repo: GPL-2.0-or-later, same license.