Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: about 1 month 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 (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-10-11T03:22:39.000Z (2 months ago)
- Last Synced: 2024-10-11T03:37:23.392Z (2 months ago)
- Topics: accuraterip, audio-cd, cddb, cdtoc, ctdb, musicbrainz, rust
- Language: Rust
- Homepage:
- Size: 175 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
[](https://docs.rs/cdtoc/)
[](https://github.com/Blobfolio/cdtoc/blob/master/CHANGELOG.md)
[](https://crates.io/crates/cdtoc)
[](https://github.com/Blobfolio/cdtoc/actions)
[](https://deps.rs/repo/github/blobfolio/cdtoc)
[](https://en.wikipedia.org/wiki/WTFPL)
[](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.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.
```toml
[dependencies.cdtoc]
version = "0.5.*"
default-features = false
```
## License
Copyright © 2024 [Blobfolio, LLC](https://blobfolio.com) <[email protected]>
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
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.