패키지, 저장소 및 앱 카테고리 검색

GitHub 저장소Hirdaya-Shrestha/haudiotagger

hAudiotagger

Flutter에서 오디오 메타데이터 읽기 및 쓰기 - Rust(lofty-rs) 기반. Android, iOS, Linux, macOS, Windows, Web(WASM)에서 MP3, FLAC, OGG, MP4/M4A, WAV, AIFF 등 지원.

hAudiotagger 프로젝트 이미지
스타
9
포크
2
최근 푸시(UTC)
2026. 10. 2.
프로젝트 상태
활성

원본 README

아래는 영문 원문 스냅샷입니다. 최신 내용은 GitHub에서 확인하세요.

hAudiotagger

hAudiotagger

Powerful, cross-platform audio metadata for Flutter.

Read · Write · Edit · Analyze · Transform

pub.dev CI MIT License Downloads Live Demo Coverage

Documentation · Live Demo · pub.dev


Why hAudiotagger?

hAudiotagger is a Rust-powered Flutter library for reading, writing, updating, and transforming audio metadata.

It supports Android, iOS, Linux, macOS, Windows, and Web, with native performance powered by lofty and flutter_rust_bridge.

Built for everything from music players and tag editors to media managers, audio libraries, podcast apps, and file organizers.

Highlights
  • 🚀 Rust-powered metadata processing
  • 🌍 Android, iOS, Linux, macOS, Windows & Web
  • 🎵 MP3, FLAC, M4A, OGG, Opus, WAV, AIFF, APE & WavPack
  • 🏷️ Read, write & partially update metadata
  • 🖼️ Artwork and picture management
  • 📚 Extended metadata with 60+ fields
  • ⚡ Parallel batch processing
  • 🔧 Custom tags and ID3 control
  • 🔄 Metadata diff, merge & transformation
  • 🎧 ReplayGain support
  • 📖 MP3 chapter support
  • 🌐 WebAssembly support

Live Demo

Try hAudiotagger directly in your browser.

No installation. No server-side processing. Everything runs locally in your browser.

Try Live Demo

[!NOTE] Web applications should use the *FromBytes APIs such as readFromBytes and writeToBytes. See the Web Setup Guide.


Installation

Add hAudiotagger to your pubspec.yaml:

dependencies:
  haudiotagger: ^2.0.1

Or install it from the command line:

flutter pub add haudiotagger

Quick Start

Read metadata
import 'package:haudiotagger/haudiotagger.dart';

final tag = await Haudiotagger.read('/path/to/song.mp3');

print(tag?.title);
print(tag?.artist);
print(tag?.album);
Write metadata
await Haudiotagger.write(
  '/path/to/song.mp3',
  Tag(
    title: 'My Song',
    artist: 'Artist',
    album: 'Album',
  ),
);
Update specific fields

Change only what you need while preserving the rest of the existing metadata:

await Haudiotagger.update(
  '/path/to/song.mp3',
  TagChanges(
    album: 'New Album',
  ),
);
Batch processing

Process multiple files with a single API:

final result = await Haudiotagger.batchWrite(
  paths,
  tag,
);

Supported Formats

Format Read Write Metadata
MP3 ✅ ✅ ID3v2, ID3v1, APE
FLAC ✅ ✅ Vorbis Comments, ID3v2*
MP4 / M4A ✅ ✅ iTunes ilst
Ogg Vorbis ✅ ✅ Vorbis Comments
Opus ✅ ✅ Vorbis Comments
AAC ✅ ✅ ID3v2, ID3v1
WAV ✅ ✅ ID3v2, RIFF INFO
AIFF ✅ ✅ ID3v2, Text Chunks
APE ✅ ✅ APE, ID3v2*, ID3v1
WavPack ✅ ✅ APE, ID3v1

* Read-only where writing is not supported by the underlying format implementation.


Features

Metadata
  • Title, artist, album, album artist
  • Genre, year, track & disc numbers
  • Composer, conductor, grouping
  • Comment and description
  • Lyrics
  • Artwork / embedded pictures
  • Custom tags
  • Extended metadata
  • MusicBrainz identifiers
  • AcoustID
  • ISRC
  • ReplayGain
Advanced Operations
  • Partial metadata updates
  • Batch read/write/update
  • Progress callbacks
  • Metadata diff
  • Configurable merge strategies
  • Metadata validation & normalization
  • ID3v2.3 / ID3v2.4 control
  • ID3v1 removal
  • MP3 chapters
  • Individual field reads
  • Individual picture reads
  • Metadata-driven file renaming
  • TagPipeline transformation engine

TagPipeline

Need to transform metadata across thousands of files?

The TagPipeline provides a rule-based transformation engine for building repeatable metadata workflows.

final pipeline = TagPipeline([
  // transformation rules
]);

await pipeline.process(paths);

Use it to build workflows such as:

Read metadata
     ↓
Normalize fields
     ↓
Apply transformation rules
     ↓
Validate metadata
     ↓
Write changes

Perfect for music library managers, tag editors, and automated organization tools.


Performance

Native file-path operations use Rust with parallel processing where applicable.

Benchmarked on Linux using 100 distinct MP3 files (~8 MB each):

Operation 1 File 100 Files
Read 500 f/s 1,282 f/s
Batch Write 29 f/s 197 f/s
Batch Update 25 f/s 197 f/s

[!NOTE] Performance depends heavily on storage, file size, metadata complexity, filesystem, and hardware. These numbers are provided as a reference rather than a guaranteed throughput.


Platform Support

Platform Support
Android ✅
iOS ✅
Linux ✅
macOS ✅
Windows ✅
Web ✅

The Web implementation uses WebAssembly and provides byte-based APIs for browser environments.


Documentation

Guides
Reference

→ Read the full documentation


Requirements

  • Flutter >= 3.0.0
  • Dart SDK >= 3.6.0

Contributing

Contributions are welcome! 🎉

If you find a bug, have an idea, or want to improve hAudiotagger:


License

hAudiotagger is open-source software licensed under the MIT License.


Made with ❤️ and 🦀 by Hirdaya Shrestha

Hirdaya Shrestha GitHub avatar
GitHub 작성자

Hirdaya Shrestha ↗

Just Building and Shattering things...

Damak-9, Jhapa
언어DartRustJavaScriptCMakeRubyC++ShellSwiftBatchfileCKotlinPowerShellObjective-C

분류

앱 카테고리

프로젝트에 맞는 저장소를 선택하려면?

사용 목적에 따라 검색하고 개발 활동을 비교한 뒤 원본 저장소에서 요구 사항을 확인하세요.

  1. 이름, 작성자 또는 설명으로 검색하고 기술 주제로 범위를 좁힙니다.
  2. 스타, 포크, 최근 푸시를 함께 비교하세요. 스타는 관심의 지표이며 품질을 보장하지 않습니다.
  3. 사용하기 전에 GitHub에서 README, 라이선스, Issues를 확인하세요.

출처 및 관리

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗