Dart Tags

Coverage Status pub package Build Status Awesome Dart MIT

The library for parsing ID3 tags, written in pure Dart.

You can found sample app written with flutter framework here.


project under MIT license


full changelog


  • implemented separate getting size of frame for id3 v2.3 and v2.4
  • added test case and asset
  • fixed typos, thanx to @algoshipda and his PR
  • fixed APIC picture type error, thanx to @algoshipda and his PR


  • hotfix! missed exports for new tags was added


  • COMM, APIC, USLT, WXXX tags returns as a map
  • WXXX frame returns WURL object
  • various fixes
  • added USLT tag
  • added possibility to pass many COMM, APIC, USLT tags
  • APIC processing was refactored
  • hex encoder
  • unrecognized encoding falls to hex encoder (removed unsupported encoding error)
  • unsupported tags like PRIV will be printed just like raw binary data


add dependency in pubsec.yaml

  dart_tags: ^0.3.1


A simple usage example:

import 'dart:io';

import 'package:dart_tags/dart_tags.dart';

main(List<String> args) {
  TagProcessor tp = new TagProcessor();

  File f = new File(args[0]);

  tp.getTagsFromByteArray(f.readAsBytes()).then((l) => l.forEach((f) => print(f)));

Code of conduct

Please refer our code of conduct.

Features and bugs

Please feel free for feature requests and bugs at the issue tracker.

In addition

Thanx for contributing @magodo, @frankdenouter

Thanx for the Photo by Mink Mingle on Unsplash that we using in unit tests.


The library helps to gets tags from mp3 files. [...]