taglib-rust icon indicating copy to clipboard operation
taglib-rust copied to clipboard

TagLib bindings for Rust

TagLib-Rust Build Status

TagLib-Rust is a library that allows accessing audio meta-data in Rust, by using the TagLib library.

TagLib-Rust supports reading and editing the meta-data of several popular audio formats. Currently there is support for:

  • ID3v1 and ID3v2 for MP3 files
  • Ogg Vorbis and FLAC
  • MPC
  • Speex
  • WavPack
  • TrueAudio
  • MP4
  • ASF

Requirements

You need TagLib installed on your system to build. This can be found in the following packages:

The pkg-config Rust module can also be optionally used to find the location of the TagLib library when building.

Using TagLib-Rust

If you're using cargo to manage your project, you can download through Crates.io:

[dependencies]
taglib = "*"

Alternatively, you can pull it from GitHub:

[dependencies]
taglib = { git = "https://github.com/ebassi/taglib-rust" }

Otherwise, clone the Git repository, and run cargo:

$ cargo build

Examples

TagLib-Rust comes with some examples on how to use it, see the examples directory in the the Git repository.

Documentation

The API reference for TagLib-Rust is available online.

License

TagLib-Rust is licensed under the terms of the MIT/X11 license.

See the LICENSE file for more details.