Skip to main content

flutter_radio_player 5.0.0-dev.2 copy "flutter_radio_player: ^5.0.0-dev.2" to clipboard
flutter_radio_player: ^5.0.0-dev.2 copied to clipboard

Online Radio Player for Flutter with background playback, lock screen controls, and streaming support for Android and iOS.

5.0.0-dev.2 #

  • Breaking: the 5.0 API replaces the 4.x one. There is no compatibility layer.
    • FlutterRadioPlayer.instance is the only way to get the player; the public constructor and dispose() are gone. One player per process, shared by every Flutter engine.
    • setSources(sources, {initialIndex, autoPlay}) replaces initialize. It keeps a playing station that is still in the list (matched by RadioSource.id) and opens no connection until playback is requested.
    • play({index}) replaces jumpToSourceAtIndex and always plays; next()/previous() replace nextSource()/previousSource() and keep the play state. New stop() and setOptions(RadioPlayerOptions).
    • Every command completes after the native player applied it, with state already updated. Only invalid arguments throw (RangeError, ArgumentError).
    • isPlayingStream, nowPlayingStream, volumeStream, getVolume() and VolumeInfo are removed; use state, stateStream, or the player as a ValueListenable.
    • RadioPlayerState gains sources, isPlaying, isLoading and isReconnecting; currentSource is a getter. Default volume is 1.0.
    • RadioSource gains id and headers (headers are not sent yet). NowPlayingInfo.title is non-null and gains artist/song.
  • New RadioPlayerBuilder widget and package:flutter_radio_player/testing.dart with FakeRadioPlayer.
  • Not in this pre-release yet: reconnect, per-source headers, live resume after a long pause, and Android Auto / CarPlay.

5.0.0-dev.1 #

First 5.0 pre-release. Build requirements change; the Dart API and behaviour are the same as 4.2.0.

  • Requires Dart 3.12 and Flutter 3.44 or later.
  • Android: minSdk 24, Java 17, compileSdk 36. The plugin no longer applies the Kotlin Gradle Plugin (kotlin-android) and has no buildscript of its own, following Flutter's built-in Kotlin migration. It builds in apps that use built-in Kotlin and in apps that still apply the Kotlin Gradle Plugin.
  • Android: Media3 1.11.1, pinned to that exact version.
  • iOS: iOS 15 or later. Apps created with Flutter 3.44 or earlier must raise the Podfile platform and IPHONEOS_DEPLOYMENT_TARGET to 15.0.
  • iOS: the Swift package declares the FlutterFramework dependency. CocoaPods stays supported.

4.2.0 #

  • Added FlutterRadioPlayer.instance, state and stateStream; the public constructor is unchanged, but every instance drives the same native player. New stateStream listeners first receive the latest state. state is eventually consistent.
  • Re-exports RadioPlayerState, PlaybackStatus, RadioPlayerError and RadioPlayerErrorCode. Playback errors now appear as status == error with state.error. Android emits network and unknown; iOS also emits invalidSource; the other codes are reserved in 4.x.
  • isPlayingStream, nowPlayingStream and volumeStream are single shared streams derived from the state: several listeners work, identical consecutive values are no longer emitted, and they do not replay.
  • play(), pause(), playOrPause(), nextSource(), previousSource() and jumpToSourceAtIndex() before initialize() or after dispose() are ignored and log a warning; initialize() need not be awaited first. dispose() followed by initialize() works repeatedly on both platforms.
  • A user-initiated play() or playOrPause() after a failure retries the current source.
  • Android: tapping the notification opens the launcher activity; playback pauses when headphones are unplugged; setVolume() before initialize() is ignored; dispose() stops the service and the state returns to idle.
  • iOS: the audio session is activated when playback starts, not at launch; an early play() before initialize() is now ignored (it used to take effect once a stream was loaded); after an interruption playback resumes only if it was active before; a source without artwork no longer shows the previous source's artwork; switching to an invalid source stops the previous stream and reports invalidSource; isPlayingStream is no longer true while nothing is loaded.
  • initialize([]) leaves the player with no sources: the current stream stops and the state is idle. On Android this replaces the old behaviour of pausing and keeping the previous list.
  • Requires platform packages 4.2.0.
  • Docs: added a "Player state" section, corrected the Android permission note (INTERNET must be declared by the app) and the example link.

4.1.0 #

  • Platform calls are now backed by Pigeon @async: returned Futures complete only after the underlying operation actually runs, instead of completing synchronously while work was silently buffered. Public Dart API is unchanged.

4.0.2 #

  • Added Swift Package Manager support for iOS
  • Android: upgraded Media3 to 1.10.0, compileSdk to 36, aligned Kotlin to 2.1.20

4.0.1 #

  • Added dartdoc comments to all public API elements
  • Added example app for pub.dev scoring

4.0.0 #

  • BREAKING: Full rewrite with federated plugin architecture (monorepo)
  • BREAKING: Replaced List<Map<String, String>> with typed RadioSource model
  • BREAKING: Renamed stream getters (getPlaybackStream() → isPlayingStream, etc.)
  • BREAKING: Renamed prevSource() → previousSource()
  • BREAKING: getVolume() now returns Future<double> (non-nullable)
  • Added Pigeon for type-safe platform channels (replaces manual method/event channels)
  • iOS: Replaced SwiftAudioEx with direct AVFoundation (no third-party deps)
  • iOS: Raised minimum deployment target to 14.0
  • iOS: Implemented playOrPause() (was missing)
  • iOS: Added artwork URL support (was asset-only)
  • iOS: Fixed volume event double-emission bug
  • Added dispose() method on both platforms
  • Added CI/CD via GitHub Actions
  • Removed kotlinx-serialization dependency on Android

3.0.2 #

  • Added foreground title when title was provided along with artist title

3.0.1 #

  • Added missing method jumpToSourceIndex(index)

3.0.0 #

  • Completely Rewritten from scratch with backward compatibility in-mind
  • Now supports album arts in both iOS and Android platforms
  • Better support for platform native companion playbacks like watchOS, wearOS, CarPlay, and Android Auto
  • Multiple bugfixes and enhancements from previous versions

2.0.3 #

  • Bugfixes for Android 14+

2.0.2 #

  • Fixed compiling error.

2.0.1 #

  • Updated for better rating

2.0.0 #

  • Completely Rewritten from scratch with backward compatibility in-mind
  • Supports multiple media-sources
  • Better Events / Reactivity
  • Better watchOS / WearOS support
  • Better native control support
  • New methods to control the player better

1.1.0 #

  • Updated to NULL-SAFETY
  • Updated exo-player version
  • Bug fixes and improvements

1.0.7 #

  • Fixed media meta-data on iOS

1.0.6 #

  • Fixed media meta-data bug and dynamic URL changing issue.

1.0.5 #

Fixed bugs, reorganized code and improved documentation.

  • Added setUrl method to dynamically change the playing URL.
  • Improved documentation.

1.0.4 #

Fixed bugs and slightly improved documentation.

  • Fixed an issue where player failed to bind to the application context.
  • Fixed an issue with EventSink.
  • Fixed a typo in the pubspec

1.0.3 #

  • Fixed pubpec

1.0.2 #

  • Fixed pubpec

1.0.1 #

  • Fixed pubpec

1.0.0 #

  • Updated Read me.

0.0.1 #

  • Initial Release of FlutterRadioPlayer
137
likes
160
points
244
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

Online Radio Player for Flutter with background playback, lock screen controls, and streaming support for Android and iOS.

Repository (GitHub)
View/report issues

License

MIT (license)

Dependencies

flutter, flutter_radio_player_android, flutter_radio_player_ios, flutter_radio_player_platform_interface

More

Packages that depend on flutter_radio_player

Packages that implement flutter_radio_player