Parse, convert, and write metadata to audio formats.

Supported Formats

* APE does not officially support ID3v2, so the tag will be read only

Examples

Reading a generic file

It isn't always convenient to use concrete file types, which is where [TaggedFile] comes in.

Using a path

# use lofty::LoftyError;
# fn main() -> Result<(), LoftyError> {
use lofty::{read_from_path, Probe};

// First, create a probe.
// This will guess the format from the extension
// ("mp3" in this case), but we can guess from the content if we want to.
let tagged_file = read_from_path("tests/files/assets/minimal/full_test.mp3", false)?;

// Let's guess the format from the content just in case.
// This is not necessary in this case!
let tagged_file2 = Probe::open("tests/files/assets/minimal/full_test.mp3")?
.guess_file_type()?
.read(false)?;
# Ok(())
# }

Using an existing reader

# use lofty::LoftyError;
# fn main() -> Result<(), LoftyError> {
use lofty::read_from;
use std::fs::File;

// Let's read from an open file
let mut file = File::open("tests/files/assets/minimal/full_test.mp3")?;

// Here, we have to guess the file type prior to reading
let tagged_file = read_from(&mut file, false)?;
# Ok(())
# }

Accessing tags

# use lofty::LoftyError;
# fn main() -> Result<(), LoftyError> {
use lofty::read_from_path;

let tagged_file = read_from_path("tests/files/assets/minimal/full_test.mp3", false)?;

// Get the primary tag (ID3v2 in this case)
let id3v2 = tagged_file.primary_tag();

// If the primary tag doesn't exist, or the tag types
// don't matter, the first tag can be retrieved
let unknown_first_tag = tagged_file.first_tag();
# Ok(())
# }

Using concrete file types

# use lofty::LoftyError;
# fn main() -> Result<(), LoftyError> {
use lofty::mp3::Mp3File;
use lofty::{AudioFile, TagType};
use std::fs::File;

let mut file_content = File::open("tests/files/assets/minimal/full_test.mp3")?;

// We are expecting an MP3 file
let mpeg_file = Mp3File::read_from(&mut file_content, true)?;

assert_eq!(mpeg_file.properties().channels(), 2);

// Here we have a file with multiple tags
assert!(mpeg_file.contains_tag_type(TagType::Id3v2));
assert!(mpeg_file.contains_tag_type(TagType::Ape));
# Ok(())
# }

Features

Individual metadata formats

These features are available if you have a specific use case, or just don't want certain formats.

• aiff_text_chunks
• ape
• id3v1
• id3v2
• mp4_ilst
• riff_info_list
• vorbis_comments

Utilities

• id3v2_restrictions - Parses ID3v2 extended headers and exposes flags for fine grained control

Important format-specific notes

All formats have their own quirks that may produce unexpected results between conversions. Be sure to read the module documentation of each format to see important notes and warnings.