audio_metadata_reader

1.7.1 (2026-07-30)

Bug Fixes

• skip consecutive ID3v2 tags before MP3 audio (5b12b01)

Bug Fixes

• skip consecutive ID3v2 tags before MP3 audio (5b12b01)

1.7.0 (2026-07-28)

Features

• add APEv2 metadata writer (556bb81)

Bug Fixes

• merge MP3 tags and decode sample rates (5c6ed17)
• parse MP3 files without ID3 tags (6c65312)
• parse MP4 meta boxes without fullbox header (4950f1c)
• preserve FLAC stream duration (af309f8)
• tolerate malformed APEv2 item padding (b9e3519)

Features

• add APEv2 metadata writer (556bb81)

Bug Fixes

• merge MP3 tags and decode sample rates (5c6ed17)
• preserve FLAC stream duration (af309f8)
• parse MP3 files without ID3 tags (6c65312)
• parse MP4 meta boxes without fullbox header (4950f1c)
• tolerate malformed APEv2 item padding (b9e3519)

Maintenance

• always close the reader even if there's an error (9367009)
• add linter rules (9f39e1d)

1.6.0 (2026-04-30)

Features

• add AIFF parser (bbde644)
• add APE parser (193b182)
• support MP4 chapters (cb75ba6)
• WAV support ID3 metadata (ce3d035)

Bug Fixes

• add RIFF parser to the readMetadata (2432411)
• avoid loading in memor the whole WAV file (07844b5)
• FLAC/OPUS parse the language field (04837e4)
• id3v1: parse correctly the year (1a5a792)
• id3v2: correctly assign TOWN (9688e6b)
• id3V4 writer will work with non ASCII characters (6bb7ae4)
• ID3v4 writer: don't write twice genre (9dd0acd)
• In some cases, the last character of lyrics may be truncated. (#95) (6225d83)
• riff writer was overwriting the origin file (2c6cad7)
• riff writer: don't override the track Number using setTrackTotal (66aaa06)
• riff_writer: correct size for the header (7d523ff)
• setArtist tag for mp3 (#91) (daa5da2)

Features

• add AIFF parser (bbde644)
• add APE parser (193b182)
• support MP4 chapters (cb75ba6)
• WAV support ID3 metadata (ce3d035)

Bug Fixes

• add RIFF parser to the readMetadata (2432411)
• avoid loading in memor the whole WAV file (07844b5)
• FLAC/OPUS parse the language field (04837e4)
• id3v1: parse correctly the year (1a5a792)
• id3v2: correctly assign TOWN (9688e6b)
• id3V4 writer will work with non ASCII characters (6bb7ae4)
• ID3v4 writer: don't write twice genre (9dd0acd)
• In some cases, the last character of lyrics may be truncated. (#95) (6225d83)
• riff writer was overwriting the origin file (2c6cad7)
• riff writer: don't override the track Number using setTrackTotal (66aaa06)
• riff_writer: correct size for the header (7d523ff)
• setArtist tag for mp3 (#91) (daa5da2)

1.5.0 (2026-04-25)

Features

• support MP4 chapters (cb75ba6)

Bug Fixes

• add RIFF parser to the readMetadata (2432411)
• FLAC/OPUS parse the language field (04837e4)
• id3v1: parse correctly the year (1a5a792)
• id3v2: correctly assign TOWN (9688e6b)
• id3V4 writer will work with non ASCII characters (6bb7ae4)
• ID3v4 writer: don't write twice genre (9dd0acd)
• In some cases, the last character of lyrics may be truncated. (#95) (6225d83)
• riff writer was overwriting the origin file (2c6cad7)
• riff writer: don't override the track Number using setTrackTotal (66aaa06)
• riff_writer: correct size for the header (7d523ff)
• setArtist tag for mp3 (#91) (daa5da2)

Features

• support MP4 chapters (cb75ba6)

Bug Fixes

• add RIFF parser to the readMetadata (2432411)
• FLAC/OPUS parse the language field (04837e4)
• id3v1: parse correctly the year (1a5a792)
• id3v2: correctly assign TOWN (9688e6b)
• id3V4 writer will work with non ASCII characters (6bb7ae4)
• ID3v4 writer: don't write twice genre (9dd0acd)
• In some cases, the last character of lyrics may be truncated. (#95) (6225d83)
• riff writer was overwriting the origin file (2c6cad7)
• riff writer: don't override the track Number using setTrackTotal (66aaa06)
• riff_writer: correct size for the header (7d523ff)
• setArtist tag for mp3 (#91) (daa5da2)

What's Changed

• Bump intl and test versions

Full Changelog: v1.4.2...v1.4.1

Chore

• Bump intl and test (#80) (89c2771)

Bug Fixes

• MP4 should be able to skip the images (#75) (8923c67)

1.4.1 (2025-04-29)

Bug Fixes

• MP4 should be able to skip the images (#75) (8923c67)

Bug Fixes

• MP4 should be able to skip the images (#75) (8923c67)

1.4.0 (2025-04-20)

Features

• add toString method to all metadata classes (#71) (6d9a9e8)

Bug Fixes

• MP4: use the mdhv version for the duration calculation (#73) (d78ae23)
• write CD and genres for MP3 (#70) (1d7c01c)

Features

• add toString method to all metadata classes (#71) (6d9a9e8)

Bug Fixes

• MP4: use the mdhv version for the duration calculation (#73) (d78ae23)
• write CD and genres for MP3 (#70) (1d7c01c)

1.3.1 (2025-04-20)

Bug Fixes

• remove a forgotten } for TLEN frame (56593cb)
• TLEN parser can fail if the content is not an integer (d7ff5db)
• write and read number in MP3 (5441412)
• write track number if it's alone (6d2836e)

Bug Fixes

• remove a forgotten } for TLEN frame (56593cb)
• TLEN parser can fail if the content is not an integer (d7ff5db)
• write and read number in MP3 (5441412)
• write track number if it's alone (6d2836e)

1.3.0 (2025-04-20)

Features

• add metadata writers (#26) (463e10a)

Features

• add metadata writers (#26) (463e10a)

1.2.0 (2025-04-19)

Features

• add RIFF parser (#60) (cf9d686)

Features

• add RIFF parser (#60) (cf9d686)

Bug Fixes

• OGG parsing was overflowing (#58) (4d8d00f)

Bug Fixes

• calculate ID3v2 duration at the microsecond (#54) (5eedca0)
• find correctly the first MP3 frame (#52) (ed6322c)
• MP4 parser is more robust (#55) (1d0f7bf)

Features

• support album artist (#39) (97c84cb)

Bug Fixes

• ID3v2 wasn't parsing description as UTF-16 (#42) (78e8c79)
• parse correctly the null character (#43) (7dda538)

Features

• metadata returns File reference (01b01a3)
• use different exception if there's no available parser (#29) (197624a)

Bug Fixes

• exit if MP4 is malformed (#35) (44536c6)
• id3v1 metadata with ASCII (#30) (22d5eeb)
• id3v2 lyric (#36) (4987448)
• ID3v2 lyrics with UTF-16 (#27) (57f18eb)
• ogg perf and mp4 parsing (#34) (9183ae8)
• Opus/OGG duration (#21) (3ade1b7)
• read all metadata from Opus (#28) (0be3d0e)
• skip images + id3v2 extended header (#22) (d1eb14f)
• skip the non used id3 tags (a24eab6)
• sometimes the track value is empty (#31) (256da3d)
• various bugs in ID3 (#24) (e6c5c61)

• OGG : fix performance
• ID3v2 : read the lyrics correctly for UTF8-LE
• MP4 : reset the reader when we start the parsing

• ID3v2 : read correctly the lyric if we have UTF-16
• Opus : performance improvement. Back to a few ms per file
• ID3v1 : fix the metadata if we have ASCII
• Add a new exception to differenciate a parse error from an non-implemented parser
• ID3v2 : fix the track number. Seems that it can be defined but empty

• OGG : compute correctly the duration
• ID3v2 : skip correctly the images if we don't want them
• ID3v2 : take care of the extended header
• ID3v2 : use the correct MPEG version and layer

• Fix : MP4 day is parsed correctly
• Fix : The Buffer skip function is skipping correctly
• Some basic refactoring

BREAKING CHANGE

• readMetadata is now synchronous. You may remove some Future.wait()
• InvalidTag class has beem removed and replace with a real exception MetadataParserException
• Remove the writers. They are not working

• Fix : the MP4 duration was not accurate (#9). Thanks to @PKiman

• A reference to the file is returned with the metadata

• Update docs : show what format can be read and written
• Add tests to the projects
• Fix : mp3 can retreive total discs
• Fix : mp4 can retreive lyrics/genre/samplerate/total tracks/total discs
• Fix : OGG and OPUS can retreive lyrics

• Remove dependencies to Flutter
• add support for OPUS and OGG

• FIX : read correcly a FLAC track. A mistake in the mask was missing the metadata
• FIX : compute correctly the duration of a MP3 track with Variable Bit Rate (VBR)

• Release of the first version