local_audio_scan 2.0.0

Android-only Flutter package for scanning local audio files with album art extraction.

example/lib/main.dart

import 'dart:typed_data';
import 'package:flutter/material.dart';
import 'package:local_audio_scan/local_audio_scan.dart';
import 'package:audioplayers/audioplayers.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final _localAudioScanner = LocalAudioScanner();
  final _audioPlayer = AudioPlayer();
  List<AudioTrack> _audioTracks = [];
  bool _isLoading = false;
  String _status = 'Tap the button to scan for audio files.';
  String? _currentlyPlaying;
  PlayerState _playerState = PlayerState.stopped;
  bool _filterJunkAudio = true;

  @override
  void initState() {
    super.initState();
    _audioPlayer.onPlayerStateChanged.listen((state) {
      setState(() {
        _playerState = state;
      });
    });
  }

  @override
  void dispose() {
    _audioPlayer.dispose();
    super.dispose();
  }

  Future<void> _scanAudioFiles() async {
    setState(() {
      _isLoading = true;
      _status = 'Scanning...';
    });

    try {
      final hasPermission = await _localAudioScanner.requestPermission();
      if (hasPermission) {
        final tracks = await _localAudioScanner.scanTracks(filterJunkAudio: _filterJunkAudio);
        setState(() {
          _audioTracks = tracks;
          _status = 'Found ${_audioTracks.length} tracks.';
        });
      } else {
        setState(() {
          _status = 'Permission denied.';
        });
      }
    } catch (e) {
      setState(() {
        _status = 'Error: $e';
      });
    } finally {
      setState(() {
        _isLoading = false;
      });
    }
  }

  Future<void> _play(String path) async {
    await _audioPlayer.play(DeviceFileSource(path));
    setState(() {
      _currentlyPlaying = path;
    });
  }

  Future<void> _pause() async {
    await _audioPlayer.pause();
    setState(() {
      _currentlyPlaying = null;
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Local Audio Scanner Example'),
        ),
        body: Column(
          children: [
            Padding(
              padding: const EdgeInsets.all(16.0),
              child: Column(
                children: [
                  Text(_status),
                  const SizedBox(height: 16),
                  Row(
                    mainAxisAlignment: MainAxisAlignment.center,
                    children: [
                      const Text('Filter Junk Audio'),
                      Switch(
                        value: _filterJunkAudio,
                        onChanged: (value) {
                          setState(() {
                            _filterJunkAudio = value;
                          });
                        },
                      ),
                    ],
                  ),
                  ElevatedButton(
                    onPressed: _isLoading ? null : _scanAudioFiles,
                    child: _isLoading
                        ? const CircularProgressIndicator()
                        : const Text('Scan Local Audio'),
                  ),
                ],
              ),
            ),
            Expanded(
              child: ListView.builder(
                itemCount: _audioTracks.length,
                itemBuilder: (context, index) {
                  final track = _audioTracks[index];
                  final isPlaying = _currentlyPlaying == track.filePath && _playerState == PlayerState.playing;
                  return ListTile(
                    leading: track.artwork != null
                        ? Image.memory(track.artwork as Uint8List)
                        : const Icon(Icons.music_note),
                    title: Text(track.title),
                    subtitle: Text(track.artist),
                    trailing: IconButton(
                      icon: Icon(isPlaying ? Icons.pause : Icons.play_arrow),
                      onPressed: () {
                        if (isPlaying) {
                          _pause();
                        } else {
                          _play(track.filePath);
                        }
                      },
                    ),
                  );
                },
              ),
            ),
          ],
        ),
      ),
    );
  }
}