easy_audio_player library

Easy Audio Player — drop-in Flutter audio player with background playback, notification controls, and Material 3 adaptive theming.

Usage:

void main() async {
  await EasyAudioPlayer.init(
    config: AudioPlayerConfig(
      androidNotificationChannelId: 'com.myapp.audio',
      androidNotificationChannelName: 'Music',
    ),
  );
  runApp(MyApp());
}

Classes

AudioPlayerConfig
Configuration passed to EasyAudioPlayer.init.
AudioPlayerError
AudioPlayerServiceInterface
Abstract interface implemented by both AudioPlayerService and MockAudioPlayerService. Widgets accept this type for testability.
AudioPlayerTheme
AudioTrack
EasyAudioPlayer
Entry point for the easy_audio_player package.
EasyPlayerState
ExpandedPlayer
Full-view audio player with artwork, metadata, controls, seekbar, optional waveform, and optional playlist.
MiniPlayer
A compact audio player pinned at the bottom of the screen.
PlayerBuffering
PlayerCompleted
PlayerControls
Headless control widget — renders only playback controls with no artwork, metadata, or layout opinions. Use this when you want to build a custom player UI and drive it with EasyAudioPlayer.service.
PlayerError
PlayerIdle
PlayerPaused
PlayerPlaying
WaveformWidget

Properties

isWaveformSupported → bool
Returns true if the current platform supports just_waveform.
no setter