Skip to content
pubscout

metadata_god

1.1.0, released a year ago by krtirtho.dev

Flutter plugin for reading and writing audio metadata and tags using Rust

WASM-ready
$ flutter pub add metadata_god
Source repository

What it does

metadata_god retrieves and updates metadata tags in local audio files, supporting formats such as MP3 (ID3v2.4), MP4/M4A, and FLAC (Vorbis comments). It uses flutter_rust_bridge and Cargokit to run native Rust audio tagging libraries under the hood. Developers can inspect or set track information, album details, and embedded cover artwork.

AI-written summary of version 1.1.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need to read embedded metadata or album artwork from audio files on the local filesystem.
  • You need to edit, tag, or update metadata in MP3, M4A, MP4, or FLAC audio files.

Skip it when

  • You only need to play or stream audio without inspecting or altering file tags.
  • You are targeting web, as it relies on Rust FFI and local file access.

Strengths

  • Supports both reading and writing metadata tags including embedded cover art.
  • Supports multiple desktop and mobile platforms via Rust FFI.
  • Simple imperative API with `readMetadata` and `writeMetadata`.

Weaknesses

  • Requires `rustup` installed on the developer machine to build due to flutter_rust_bridge and Cargokit.
  • Format support documented is limited to mp3, m4a, mp4, and flac.

Setup

Kind
Plugin (native code)
Effort
Medium
Code generation
No
Direct dependencies
4

Requires rustup installed on the build machine. Android requires READ/WRITE_EXTERNAL_STORAGE permissions configured in AndroidManifest.xml and requested at runtime.

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await MetadataGod.initialize();

  // Read metadata
  Metadata metadata = await MetadataGod.readMetadata('/path/to/audio-file.mp3');
  print(metadata.title);

  // Write metadata
  await MetadataGod.writeMetadata(
    '/path/to/audio-file.mp3',
    Metadata(
      title: 'Song Title',
      artist: 'Artist Name',
      album: 'Album Name',
      year: 2024,
    ),
  );
}

Alternatives

Packages that do the same job and could replace metadata_god.

  • audio_metadata_reader

    Pure Dart metadata reader and writer for MP3, MP4, FLAC, OGG, Opus, WAV, AIFF, and APE files.

  • record

    Record audio from the microphone to a file or stream with multiple codec options.

  • audioplayers

    A Flutter plugin to play multiple audio files simultaneously

  • flutter_recorder

    Low-level cross-platform audio recorder plugin using miniaudio with real-time waveform, FFT and volume.

Works with

Packages commonly used together with metadata_god: ones it builds on, ones built on it, and its own family.