cdio-rust

Rust implementation and Utility programs of the Compact Disc Input and Control Core Library.

This Cargo workspace contains two packages:

• libcdio-rs: Safe Rust abstraction over libcdio C
• libcdio-cli: Utility programs that use libcdio

Status

• cd-drive: show CD-ROM drive characteristics
• cd-info: show information about a CD or CD-image
• cd-paranoia: an audio CD ripper
• cd-read: read information from a CD or CD-image
• cdda-player: a simple curses-based audio CD player
• iso-info: show information about an ISO 9660 image
• iso-read: read portions of an ISO 9660 image
• mmc-tool: issue low-level commands to a CD drive

Development

Build Requirements

• Cargo: The Rust build tool
• libclang: Used by libcdio-sys for generating Rust bindings to libcdio
• libcdio: libcdio headers. Consult your package manager.
  • Debian: libcdio-headers
  • Fedora: libcdio-devel

Build

cargo build --release

Omit --release for debug builds. The build outputs should be in the target directory.

Run the tests

cargo test

To run ignored tests, which require some extra setup:

cargo test -- --include-ignored

Run the executables

For example, to run the iso-info program:

cargo run --bin iso-info-rs -- ./test-data/rock-ridge.iso

Use the provided Git Hooks

These automatically perform lint and formatting checks:

git config core.hooksPath .githooks

To skip hooks, use --no-verify:

git commit --no-verify

How to use a local build of libcdio

Build libcdio with the --without-versioned-libs option.

cd libcdio
autoreconf -f -i
./configure --without-versioned-libs
make

Set the following environment variables:

# Set this to the (absolute!) path of your libcdio build directory
export LIBCDIO_ROOT="/home/skran/libcdio"

export SYSTEM_DEPS_LIBCDIO_NO_PKG_CONFIG="yes"
export SYSTEM_DEPS_LIBCDIO_SEARCH_NATIVE="$LIBCDIO_ROOT/lib/driver/.libs"
export SYSTEM_DEPS_LIBCDIO_INCLUDE="$LIBCDIO_ROOT/include"
export SYSTEM_DEPS_LIBCDIO_LIB="cdio"

export SYSTEM_DEPS_LIBISO9660_NO_PKG_CONFIG="yes"
export SYSTEM_DEPS_LIBISO9660_SEARCH_NATIVE="$LIBCDIO_ROOT/lib/iso9660/.libs"
export SYSTEM_DEPS_LIBISO9660_INCLUDE="$LIBCDIO_ROOT/include"
export SYSTEM_DEPS_LIBISO9660_LIB="iso9660"

export SYSTEM_DEPS_LIBUDF_NO_PKG_CONFIG="yes"
export SYSTEM_DEPS_LIBUDF_SEARCH_NATIVE="$LIBCDIO_ROOT/lib/udf/.libs"
export SYSTEM_DEPS_LIBUDF_INCLUDE="$LIBCDIO_ROOT/include"
export SYSTEM_DEPS_LIBUDF_LIB="udf"

export BINDGEN_EXTRA_CLANG_ARGS="-I$LIBCDIO_ROOT/include"
export LD_LIBRARY_PATH="$LIBCDIO_ROOT/lib/driver/.libs:$LIBCDIO_ROOT/lib/iso9660/.libs:$LIBCDIO_ROOT/lib/udf/.libs:$LD_LIBRARY_PATH"

# For macOS
export LD_LIBRARY_PATH="$LIBCDIO_ROOT/lib/driver/.libs:$LIBCDIO_ROOT/lib/iso9660/.libs:$LIBCDIO_ROOT/lib/udf/.libs:$DYLD_LIBRARY_PATH"

That's it. Cargo should now use your local copy of libcdio.

License

Copyright (C) 2026 Shiva Kiran Koninty shiva@skran.xyz

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.