rust-mp4ameta

A library for reading and writing iTunes style MPEG-4 audio metadata.

Examples

The easy way

let mut tag = mp4ameta::Tag::read_from_path("music.m4a").unwrap();

println!("{}", tag.artist().unwrap());

tag.set_artist("artist");

tag.write_to_path("music.m4a").unwrap();

The hard way

use mp4ameta::{atom, Data, FourCC, Tag};

let mut tag = Tag::read_from_path("music.m4a").unwrap();
let artist_ident = FourCC(*b"\xa9ART");

let artist = tag.string(&artist_ident).next().unwrap();
println!("{}", artist);

tag.set_data(artist_ident, Data::Utf8("artist".to_owned()));

tag.write_to_path("music.m4a").unwrap();

Using freeform identifiers

use mp4ameta::{Data, FreeformIdent, Tag};

let mut tag = Tag::read_from_path("music.m4a").unwrap();
let isrc_ident = FreeformIdent::new("com.apple.iTunes", "ISRC");

let isrc = tag.string(&isrc_ident).next().unwrap();
println!("{}", isrc);

tag.set_data(isrc_ident, Data::Utf8("isrc".to_owned()));

tag.write_to_path("music.m4a").unwrap();

Supported Filetypes

• M4A
• M4B
• M4P
• M4V

Useful Links

• AtomicParsley docs
• Mutagen docs
• QuickTime spec
  • Movie Atoms
  • Metadata
• QuickTime container
• MusicBrainz Picard tag mapping
• Filetype list

Testing

Run all tests: cargo test

Test this library on your collection: cargo test -- --nocapture collection <path>