Radio Player

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

flutter platform pub package


To use this package, add radio_player as a dependency in your pubspec.yaml file.

  radio_player: ^1.5.0

By default iOS forbids loading from non-https url. To cancel this restriction edit your .plist and add:


If necessary, add permissions to play in the background:



To create RadioPlayer instance, simply call the constructor.

RadioPlayer radioPlayer = RadioPlayer();

Configure it with your data.

radioPlayer.setChannel(title: TITLE, url: URL, imagePath: IMAGEPATH?);

Player Controls;

State Event

You can use it to show if player playing or paused.

bool isPlaying = false;
radioPlayer.stateStream.listen((value) {
    setState(() { isPlaying = value; });

Metadata Event

This Event returns the current metadata.

List<String>? metadata;
radioPlayer.metadataStream.listen((value) {
    setState(() { metadata = value; });

Image from metadata can be retrieved using getArtworkImage()


  • iOS: SDK 10.0 or later
  • Android: API Level 23 or later


Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Please make sure to update tests as appropriate.