22 releases

0.5.1 Oct 11, 2024
0.4.0 Jul 29, 2024
0.3.5 Feb 8, 2024
0.3.4 Nov 25, 2023
0.1.0 Dec 26, 2022

#167 in Database interfaces

Download history 59/week @ 2024-07-04 10/week @ 2024-07-18 222/week @ 2024-07-25 21/week @ 2024-08-01 147/week @ 2024-09-05 4/week @ 2024-09-12 32/week @ 2024-09-19 30/week @ 2024-09-26 1/week @ 2024-10-03 193/week @ 2024-10-10 11/week @ 2024-10-17

249 downloads per month

WTFPL license

125KB
2K SLoC

CDTOC

docs.rs changelog
crates.io ci deps.rs
license contributions welcome

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.5.*"

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.5.*"
default-features = false

License

Copyright © 2024 Blobfolio, LLC <hello@blobfolio.com>

This work is free. You can redistribute it and/or modify it under the terms of the Do What The Fuck You Want To Public License, Version 2.

DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
Version 2, December 2004

Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>

Everyone is permitted to copy and distribute verbatim or modified
copies of this license document, and changing it is allowed as long
as the name is changed.

DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

0. You just DO WHAT THE FUCK YOU WANT TO.

Dependencies

~390–780KB
~16K SLoC