Warning
READ BEFORE RECORDING.
- CONFIRM THE DRIVE AND DISC BEFORE WRITING.
- CD-R CANNOT BE ERASED. ERASING CD-RW DESTROYS ITS CONTENTS.
- DO NOT RUN AS ROOT OR DISCONNECT THE DRIVE DURING WRITING. IF WRITING FAILS, KEEP THE JOB AND CHECK ITS LOG BEFORE RETRYING.
Make a music CD with artwork in the outer ring. Design and build on macOS, Windows or Linux. Record on macOS; Windows recording is experimental.
Download your system's archive from Releases
and verify it against SHA256SUMS.txt. No Rust or Python installation is needed.
| System | Archive suffix |
|---|---|
| macOS Apple Silicon / Intel | macos-arm64.tar.gz / macos-x64.tar.gz |
| Linux x86-64 | linux-x64.tar.gz |
| Windows x86-64 | windows-x64.zip |
In the extracted directory, on macOS/Linux:
mkdir -p "$HOME/.local/bin"
cp -p ./discimage "$HOME/.local/bin/discimage"
export PATH="$HOME/.local/bin:$PATH"
discimage --versionOn Windows, in PowerShell:
$env:Path = "$((Get-Location).Path);$env:Path"
discimage --versionThese PATH changes apply to the current terminal. macOS packages are not notarized; if blocked, follow Apple's instructions for a verified download.
Use a matching tested preset, or calibrate your own batch:
discimage devices
discimage select DRIVE_ID
discimage select
discimage calibrate -o calibrations/my-batchReplace DRIVE_ID with the hardware ID shown by devices. Calibration writes one
blank CD-R/CD-RW target, reads it twice and exports disc.toml. Continue with the
same command if interrupted. Calibration and optional photo refinement.
Use one 44.1 kHz, 16-bit stereo PCM WAV per track, at least four seconds.
Save album.toml in your working directory; the array sets the playing order:
title = "My album"
preset = { file = "calibrations/my-batch/disc.toml", name = "my-batch" }
tracks = [{ path = "audio/01.wav" }, { path = "audio/02.wav" }]Replace the preset with your own path/name, then export the album's template:
discimage preview album.toml
discimage template album.toml -o templatesImport templates/layout.json into the artwork editor.
Design, export the artwork ZIP, put artwork.png beside album.toml, and add the
exported artwork.toml section to your album. Keep the tracks and preset.
Images, text and previews.
discimage build album.toml
discimage verify output/album
# Open output/album/preview.svg in a browser and check the design.
discimage devices
discimage select DRIVE_ID
discimage select
# Insert a matching blank disc, then write:
discimage burn output/albumUse a new blank CD-R, or explicitly erase a used CD-RW.
The calibration target is already written. Speed is automatic unless you supply --speed N.
burn writes and checks audio, reads the actual NWA, then encodes, writes,
checks and closes the data session. Afterwards devices should show two sessions;
inspect the artwork and audition the music. Recording and recovery.
- Manual photo refinement · Copyable AI prompt
- ISO/RAW export and local verification
- Windows notes · Hardware results · Files
Current zsh completion: autoload -Uz compinit && compinit, then
source <(discimage completions zsh). Also supports bash, fish, PowerShell and elvish.
Run discimage COMMAND --help for options. Logs support macOS Terminal colors and NO_COLOR=1.
CD-Text currently supports printable ASCII. Full Blue Book CD Extra/XA compliance and consumer-player compatibility remain unverified.
Inspired by DiscImageStudio by JiaFeiMiao-K-Cat and contributors, including its CDImage-derived CIRC mapping. Credits · GPL-3.0-or-later.