audio_query #

A Flutter plugin for querying audio files (songs, music, recordings) from device storage on Android and iOS. Easily retrieve metadata such as title, artist, album, duration, and more.

Features #

• Query all audio files on the device
• Retrieve detailed metadata for each audio file (title, artist, album, duration, etc.)
• Cross-platform support: Android & iOS
• Simple, easy-to-use API

Getting Started #

Installation #

Add audio_query to your pubspec.yaml:

dependencies:
  audio_query: ^0.0.1

Then run:

flutter pub get

Usage

Import the package:

import 'package:audio_query/audio_query.dart';


Fetch audio files:

void fetchAudios() async {
  final audioQuery = AudioQuery();
  final audios = await audioQuery.getAudios();
  
  for (var audio in audios) {
    print('Title: ${audio.title}, Artist: ${audio.artist}');
  }
}

See the example/ directory for a complete working example.

Platform-specific Setup #

Android #

Add the following permission to your AndroidManifest.xml:

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

For Android 13+ (API level 33+), you may need to request: android.permission.READ_MEDIA_AUDIO.

iOS #

Add the following key to your Info.plist:

<key>NSAppleMusicUsageDescription</key>
<string>This app needs access to your music library.</string>

API Reference #

Future<List<AudioItemModel>> getAudios()

Returns a list of AudioItemModel objects representing audio files available on the device.

Contributing #

Contributions are welcome! Please open issues or submit pull requests on GitHub.

License #

See the LICENSE file for details.