metatagger 2.3.0
metatagger: ^2.3.0 copied to clipboard
A pure Dart library for reading and writing audio metadata (ID3v2, Vorbis Comments, iTunes-style, and EBML) in MP3, FLAC, MP4/M4A, OGG, Opus, and WebM files.
2.3.0 #
- AAC Support: Added read and write support for raw ADTS
.aacfiles using ID3v2 metadata.- Supports text, numeric, custom metadata, and embedded album artwork.
- Added AAC-specific detection so ADTS frames are not misclassified as MP3.
- Added file and in-memory read/write tests using
example.aac.
- Added AAC standalone and all-in-one examples and updated format documentation.
- Opus Support: Added read and write support for
.opusfiles using Ogg OpusOpusTagscomments.- Supports text, numeric, custom metadata, and embedded album artwork.
- Added valid Opus packet repagination while preserving the audio stream.
- Added file and in-memory format detection through the existing OGG APIs.
- Added
example.opus, an Opus example script, all-in-one example coverage, and integration tests. - Verified rewritten Opus files with standard media probing tools.
2.2.0 #
- WebM Support: Added read and write support for EBML metadata in
.webmfiles.- Supports text, numeric, and custom metadata through
Tags/SimpleTagelements. - Supports file-based and in-memory operations with automatic WebM detection.
- Added
WebmReaderandWebmWriterexports.
- Supports text, numeric, and custom metadata through
- WebM embedded artwork is explicitly rejected because attachments are not part of the compliant WebM profile. Use OGG/Opus or MKV/MKA for embedded artwork.
- MP3 Reliability: Added valid ID3 padding to prevent “Missing ID3 terminating frame” warnings.
- Added real-file WebM integration tests using
example/example.webm. - Added WebM examples and updated format documentation.
2.1.0 #
- In-Memory Parsing: Added support for parsing and writing metadata directly from/to
Uint8Listbyte arrays without using physical files.- Added
readTagsFromBytes(Uint8List bytes)method - Added
writeTagsToBytes(Uint8List bytes, List<MetadataTag> tags)method - Added
clearTagsFromBytes(Uint8List bytes)method - Magic number detection automatically routes the buffer to the correct parser without needing file extensions
- Added
- Backwards compatible: File-based methods use the byte-level methods internally
- Added comprehensive in-memory parsing integration tests
- Added
memory_example.dartexample script - OGG Support: Added read and write support for Ogg Vorbis metadata
- Implemented
OggReaderfor extracting Vorbis Comments and Album Art from.oggfiles - Implemented a pure Dart Ogg multiplexer (
OggWriter) capable of repaginating files to safely modify tags without breaking the container stream - Implemented an Ogg-specific CRC32 checksum generator for compliant file manipulation
- Implemented
- Added comprehensive OGG read/write integration tests
- Updated example scripts (
read_example.dart,read_write_example.dart,metatagger_example.dart) to demonstrate Ogg capabilities
2.0.1 #
- MP4 Custom Tags: Added full support for custom metadata in MP4/M4A files
- Custom tags stored as freeform (----) atoms with
com.apple.iTunesnamespace - Compatible with iTunes, Music.app, and other players
- Supports text, number, and binary custom tags
- Custom tags stored as freeform (----) atoms with
- Fixed
writeTag()method to properly merge with existing tags instead of replacing all metadata - Added
mp4_custom_tags_example.dartdemonstrating advanced custom tag usage - Added test coverage for MP4 custom tags
2.0.0 #
- BREAKING: Added read functionality - major feature addition
- Added
MetadataReaderabstract class for reading metadata - Implemented
Mp3Readerfor reading ID3v2.3 and ID3v2.4 tags from MP3 files - Implemented
FlacReaderfor reading Vorbis Comments and PICTURE blocks from FLAC files - Implemented
Mp4Writerfor writing iTunes-style metadata to MP4/M4A files - Implemented
Mp4Readerfor reading iTunes-style metadata from MP4/M4A files - Added support for
.mp4,.m4a,.m4v, and.m4bfile extensions - Added
readTags()method to read all metadata from a file - Added
readTag()method to read a specific tag from a file - Added
readCommonTags()method to read metadata as a convenient Map - Enhanced
MetaTaggerconstructor to support both readers and writers - Added comprehensive tests for read and write functionality (19 tests covering MP3, FLAC, and MP4)
- Added
read_example.dartdemonstrating metadata reading - Added
read_write_example.dartdemonstrating advanced operations (copy, update, migrate) - Updated README with extensive read functionality documentation
- Technical note: MP4 atom names use Latin-1 encoding for proper handling of © character (0xA9)
- All existing write functionality remains unchanged and compatible
1.0.0 #
- Initial version.