metadata_god
1.1.0, released a year ago by krtirtho.dev
Flutter plugin for reading and writing audio metadata and tags using Rust
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.
78Compare - record
Record audio from the microphone to a file or stream with multiple codec options.
94Compare - audioplayers
A Flutter plugin to play multiple audio files simultaneously
87Compare - flutter_recorder
Low-level cross-platform audio recorder plugin using miniaudio with real-time waveform, FFT and volume.
87Compare
Works with
Packages commonly used together with metadata_god: ones it builds on, ones built on it, and its own family.