Skip to content
pubscout

audio_manager

1.0.0, released 3 months ago by an unverified publisher

Flutter plugin for music playback with notification handling and desktop system controls.

WASM-ready
$ flutter pub add audio_manager
Source repository

What it does

A Flutter plugin for playing music from assets, local files, or network streams. It handles lock-screen controls, notifications on Android, Now Playing / Control Center on iOS and macOS, SMTC on Windows, and MPRIS on Linux.

AI-written summary of version 1.0.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need cross-platform audio playback supporting mobile, desktop, and web.
  • You require background audio playback with system media controls and lock-screen integration.

Skip it when

  • You need complex multi-channel audio mixing or low-latency sound effects.
  • You need fully custom notification layouts generated by your Dart code.

Strengths

  • Supports Android, iOS, web, Windows, macOS, and Linux.
  • Integrates with system media controls and notifications out-of-the-box.
  • Simple singleton interface for quick setup.

Weaknesses

  • Relies on a singleton instance, which may limit architectural flexibility.
  • Custom notification layout configuration is not exposed by the public API.
  • Desktop platforms require specific native development dependencies (like GStreamer on Linux).

Setup

Kind
Plugin (native code)
Effort
Medium
Code generation
No
Direct dependencies
1

Requires platform configuration: background audio modes and ATS settings in Info.plist for iOS, cleartext traffic and SDK version configurations for Android, entitlements on macOS, and GStreamer development packages on Linux.

AudioManager.instance.start(
	"assets/audio.mp3",
	"title",
	desc: "desc",
	cover: "assets/ic_launcher.png"
);

AudioManager.instance.playOrPause();

Alternatives

Packages that do the same job and could replace audio_manager.

  • just_audio

    Feature-rich, highly customizable audio player with support for playlist management, clipping, and gapless playback.

  • audioplayers

    Simpler and widely used audio playback plugin for playing multiple simultaneous audio sources easily.

Works with

Packages commonly used together with audio_manager: ones it builds on, ones built on it, and its own family.