audio_metadata_reader

KO | EN

gitlite — search

#react #ai #llm #rust #docker #nodejs #windows #awesome #kubernetes #awesome-list #pytorch #mcp #ios #open-source

audio_metadata_reader

(★ 45)

A pure-dart audio metadata reader

audio_metadata_reader 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Audio Metadata Reader

A pure Dart package for reading and writing metadata in various audio formats.

| File Format | Metadata Format(s)    | Read | Write |
|-------------|------------------------|------|-------|
| MP3         | `ID3v1`, `ID3v2`        | ✅   | ✅    |
| MP4         | `iTunes-style ilst`     | ✅   | ✅    |
| FLAC        | `Vorbis Comments`       | ✅   | ✅    |
| OGG         | `Vorbis Comments`       | ✅   | ❌    |
| Opus        | `Vorbis Comments`       | ✅   | ❌    |
| WAV         | `RIFF`                  | ✅   | ✅    |
| AIFF/AIFC   | `IFF chunks`            | ✅   | ❌    |
| APE         | `APEv2`                 | ✅   | ✅    |

This package is still under active development. If there's a metadata format you'd like to see supported or specific information you’d like the library to expose, feel free to open an issue.

## Usage

### Read

```dart
import 'dart:io';
import 'package:audio_metadata_reader/audio_metadata_reader.dart';

void main() {
  final track = File("Pieces.mp3");

// Fetching images can slow down metadata reading
  final metadata = readMetadata(track, getImage: false);

print(metadata.title);
  print(metadata.album);
}
```

`readMetadata` returns the common `AudioMetadata` view shared by all supported
formats. Use `readAllMetadata` when you need the format-specific metadata
object, such as `Mp3Metadata`, `Mp4Metadata`, `VorbisMetadata`, `RiffMetadata`
or `ApeMetadata`.

```dart
import 'dart:io';

import 'package:audio_metadata_reader/audio_metadata_reader.dart';

final track = File("Pieces.mp3");
final metadata = readAllMetadata(track, getImage: false);
print(metadata);
```

### Supported File Extensions

The package currently recognizes these extensions:

`.mp3`, `.flac`, `.mp4`, `.m4a`, `.ape`, `.ogg`, `.opus`, `.wav`, `.aif`,
`.aiff`, `.aifc` and `.mov`.

Use `supportedFileExtensions` when filtering files before parsing:

```dart
final isSupported = supportedFileExtensions.any(
  (ext) => file.path.toLowerCase().endsWith(ext),
);
```

### Write

```dart
import 'dart:io';
import 'dart:typed_data';

import 'package:audio_metadata_reader/audio_metadata_reader.dart';

void main() {
  final track = File("Pieces.mp3");

// Use a switch if you want to update metadata based on the file type
  updateMetadata(
    track,
    (metadata) {
      switch (metadata) {
        case Mp3Metadata m:
          m.songName = "New title";
          break;
        case Mp4Metadata m:
          m.title = "New title";
          break;
        case VorbisMetadata m:
          m.title = ["New title"];
          break;
        case RiffMetadata m:
          m.title = "New title";
          break;
        case ApeMetadata m:
          m.title = "New title";
      }
    },
  );

// Or use extension methods for common metadata updates
  updateMetadata(
    track,
    (metadata) {
      metadata.setTitle("New title");
      metadata.setArtist("New artist");
      metadata.setAlbum("New album");
      metadata.setTrackNumber(1);
      metadata.setYear(DateTime(2014));
      metadata.setLyrics("I'm singing");
      metadata.setGenres(["Rock", "Metal", "Salsa"]);
      metadata.setPictures([
        Picture(Uint8List.fromList([]), "image/png", PictureType.coverFront)
      ]);
    },
  );
}
```

`updateMetadata` reads the existing format-specific metadata, applies the
callback, then writes it back to the same file. For an already constructed
metadata object, use `writeMetadata` directly:

```dart
import 'dart:io';

import 'package:audio_metadata_reader/audio_metadata_reader.dart';

final metadata = Mp3Metadata()..songName = "New title";
writeMetadata(File("Pieces.mp3"), metadata);
```

The common setter extension also provides `setTrackTotal` and `setCD`. Some
formats do not support every field; unsupported setters are intentionally
ignored for those formats.

MP4 metadata can also contain `Chapter` markers. OGG, Opus and AIFF/AIFC are
currently read-only; metadata writing is supported for MP3, MP4, FLAC, WAV and
APE files.

## Performance

On my laptop with an SSD, the library can process metadata from **3,392 tracks in under 200ms** — assuming covers aren't fetched. With covers, it's around **400ms**.

```dart
import 'dart:io';
import 'package:audio_metadata_reader/audio_metadata_reader.dart';

void main() {
  final folder = Directory(r"music folder")
      .listSync(recursive: true)
      .whereType<File>()
      .where(
        (file) => supportedFileExtensions.any(
          (ext) => file.path.toLowerCase().endsWith(ext),
        ),
      )
      .toList();

print("Number of tracks: ${folder.length}");

final start = DateTime.now();

for (final file in folder) {
    readMetadata(file, getImage: false);
  }

final end = DateTime.now();
  print("Duration: ${end.difference(start)}");
}
```

## Anonymize a Music Track

If you need to report an issue or test the library without sharing private audio, you can anonymize a track by replacing its audio with white noise using `ffmpeg`:

```bash
ffmpeg -i <your_track> -f lavfi -t 5 -i "anoisesrc=color=white:duration=5" -map_metadata 0 -map 1:a -t 5 <output_track>
```

audio_metadata_reader

audio_metadata_reader 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

audio_metadata_reader

audio_metadata_reader 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README