Skip to content
pubscout

radio_player

2.3.1, released 7 months ago by cheebeez.com

Flutter plugin to play streaming audio with background support and lock screen controls.

$ flutter pub add radio_player
Source repository

What it does

A plugin to play streaming audio content (such as MP3, AAC, HLS) with background audio support and lock screen controls. It provides static methods for playback control, metadata streaming, custom metadata setup, navigation controls, and a real-time audio visualizer widget.

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

Use it when

  • Building an internet radio application that streams audio from URLs.
  • Needing background playback and lock screen media controls on Android and iOS.

Skip it when

  • Needing advanced local file playback management with complex playlist structures.
  • Working under environments that restrict CC-BY-NC-SA-4.0 licenses.

Strengths

  • Built-in support for background audio playback and lock screen controls.
  • Includes streaming metadata parsing (ICY metadata) and artwork lookup options.
  • Provides a built-in `RadioVisualizer` widget with fallback animations.

Weaknesses

  • Uses a non-commercial open-source license (CC-BY-NC-SA-4.0).
  • Relies entirely on static methods which might limit certain architectural patterns.

Setup

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

Add UIBackgroundModes (audio, processing) and optional NSAppTransportSecurity exceptions to Info.plist on iOS.

RadioPlayer.setStation(
    title: "My Awesome Radio",
    url: "YOUR_STREAM_URL_HERE",
    parseStreamMetadata: true,
);
RadioPlayer.play();

Alternatives

Packages that do the same job and could replace radio_player.

  • just_audio

    For a feature-rich, highly customizable audio player supporting multiple sources, looping, clipping, and precise position control.

  • audioplayers

    For a simpler, multi-platform audio player plugin suited for playing simple audio files or streams.

Works with

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