https://github.com/blobfolio/cdtoc

Parser and tools for CDTOC metadata tags written in Rust.
https://github.com/blobfolio/cdtoc

accuraterip audio-cd cddb cdtoc ctdb musicbrainz rust

Last synced: 9 months ago
JSON representation

Parser and tools for CDTOC metadata tags written in Rust.

• Host: GitHub
• URL: https://github.com/blobfolio/cdtoc
• Owner: Blobfolio
• License: wtfpl
• Created: 2022-12-23T06:32:56.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2025-04-03T18:54:30.000Z (9 months ago)
• Last Synced: 2025-04-12T13:45:51.251Z (9 months ago)
• Topics: accuraterip, audio-cd, cddb, cdtoc, ctdb, musicbrainz, rust
• Language: Rust
• Homepage:
• Size: 321 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# CDTOC

[![docs.rs](https://img.shields.io/docsrs/cdtoc.svg?style=flat-square&label=docs.rs)](https://docs.rs/cdtoc/)

[![changelog](https://img.shields.io/crates/v/cdtoc.svg?style=flat-square&label=changelog&color=9b59b6)](https://github.com/Blobfolio/cdtoc/blob/master/CHANGELOG.md)


[![crates.io](https://img.shields.io/crates/v/cdtoc.svg?style=flat-square&label=crates.io)](https://crates.io/crates/cdtoc)

[![ci](https://img.shields.io/github/actions/workflow/status/Blobfolio/cdtoc/ci.yaml?label=ci&style=flat-square)](https://github.com/Blobfolio/cdtoc/actions)

[![deps.rs](https://deps.rs/repo/github/blobfolio/cdtoc/status.svg?style=flat-square&label=deps.rs)](https://deps.rs/repo/github/blobfolio/cdtoc)


[![license](https://img.shields.io/badge/license-wtfpl-ff1493?style=flat-square)](https://en.wikipedia.org/wiki/WTFPL)

[![contributions welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square&label=contributions)](https://github.com/Blobfolio/cdtoc/issues)

CDTOC is a simple Rust library for parsing and working with audio CD tables of contents, namely in the form of [CDTOC-style](https://forum.dbpoweramp.com/showthread.php?16705-FLAC-amp-Ogg-Vorbis-Storage-of-CDTOC&s=3ca0c65ee58fc45489103bb1c39bfac0&p=76686&viewfull=1#post76686) metadata values.

By default it can also generate disc IDs for services like [AccurateRip](http://accuraterip.com/), [CDDB](https://en.wikipedia.org/wiki/CDDB), [CUETools Database](http://cue.tools/wiki/CUETools_Database), and [MusicBrainz](https://musicbrainz.org/), 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

```rust

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:

```toml

[dependencies]

cdtoc = "0.8.*"

```

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.

```toml

[dependencies.cdtoc]

version = "0.8.*"

default-features = false

```