34 releases (10 breaking)
Uses new Rust 2024
| 0.11.1 | Sep 18, 2025 |
|---|---|
| 0.11.0 | Jun 26, 2025 |
| 0.10.0 | Jun 2, 2025 |
| 0.8.0 | Feb 26, 2025 |
| 0.1.0 | Dec 26, 2022 |
#383 in Encoding
125KB
2K
SLoC
CDTOC
CDTOC is a simple Rust library for parsing and working with audio CD tables of contents, namely in the form of CDTOC-style metadata values.
By default it can also generate disc IDs for services like AccurateRip, CDDB, CUETools Database, and MusicBrainz, but you can disable the corresponding crate feature(s) — accuraterip, cddb, ctdb, and musicbrainz respectively — to shrink the dependency tree if you don't need that functionality.
Examples
use cdtoc::Toc;
// From a CDTOC string.
let toc1 = Toc::from_cdtoc("4+96+2D2B+6256+B327+D84A").unwrap();
// From the raw parts.
let toc2 = Toc::from_parts(
vec![150, 11563, 25174, 45863],
None,
55370,
).unwrap();
// Either way gets you to the same place.
assert_eq!(toc1, toc2);
// You can also get a CDTOC-style string back at any time:
assert_eq!(toc1.to_string(), "4+96+2D2B+6256+B327+D84A");
De/Serialization
The optional serde crate feature can be enabled to expose de/serialization implementations for this library's types:
| Type | Format | Notes |
|---|---|---|
AccurateRip |
String |
|
Cddb |
String |
|
Duration |
u64 |
|
ShaB64 |
String |
MusicBrainz and CTDB IDs. |
Toc |
String |
|
Track |
Map |
|
TrackPosition |
String |
Installation
Add cdtoc to your dependencies in Cargo.toml, like:
[dependencies]
cdtoc = "0.11.*"
The disc ID helpers require additional dependencies, so if you aren't using them, be sure to disable the default features (adding back any you do want) to skip the overhead.
[dependencies.cdtoc]
version = "0.11.*"
default-features = false
Dependencies
~185–440KB
~10K SLoC