opticaldiscs

Format-agnostic optical disc image reading and filesystem browsing for Rust.

Provides a unified SectorReader abstraction that handles the cooked/raw sector translation across three container formats — ISO, BIN/CUE, and CHD — with filesystem browsers for ISO 9660, HFS, HFS+, and SGI EFS on top.

Status: Early development. See PLAN.md for the implementation roadmap.

CHD support

opticaldiscs-rs reads CHD optical images via libchdman-rs, which wraps MAME's official chd_file core. This provides byte-for-byte parity with the chdman tool — including subcode handling, audio byte-swapping, and per-track frame semantics — at the cost of needing to link MAME's C++ code.

By default, opticaldiscs-rs enables libchdman-rs's prebuilt feature, which downloads a pre-built static archive matching the build target from libchdman-rs's GitHub Releases instead of compiling MAME from source. This keeps CI build times in seconds, not minutes.

When you might need to override prebuilt behavior

See libchdman-rs's README for the full list of supported targets, glibc floors, and escape hatches.

Features

Quick Example

use opticaldiscs::detect::DiscImageInfo;
use opticaldiscs::browse;

let info = DiscImageInfo::open("disc.iso")?;
println!("Volume: {:?}", info.volume_label);
println!("Filesystem: {}", info.filesystem.display_name());

let mut fs = browse::open_disc_filesystem(&info)?;
let root = fs.root()?;
for entry in fs.list_directory(&root)? {
    println!("{:<40} {}", entry.name, entry.size_string());
}

Cargo.toml

# git dependency while API stabilises
opticaldiscs = { git = "https://github.com/dani/opticaldiscs-rs" }

# with optional features
opticaldiscs = { git = "...", features = ["toc", "drives"] }

Feature Flags

Used By

• rusty-backup — vintage disc backup/restore tool
• ODE-artwork-downloader — USBODE cover art downloader

License

GPL-3.0 — see LICENSE.