audio_service
Flutter plugin to play audio in the background while the screen is off.
0.18.19
207K downloads/mo
#838 most downloaded on pub.dev
ryanheise/audio_service
What this package is like to depend on
Last release 1 months ago
29 Jun 2026
Release timing varies
gaps range from 2 weeks to 1.2 years
Nearly every release is documented
notes for 78 of 78 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
81 releases · first in 2018
1 release in the last 12 months
see the full history below
Release timeline
81 releases · Nov 2018 to Jun 2026
2019
2020
2021
2022
2023
2024
2025
2026
Releases
latest 60 of 81-
0.18.1929 Jun 2026 -
0.18.1811 Apr 2025Release notes
Open source →- Fix setPlaybackState entitlement issue on iOS.
- Fix Android stopForeground deprecation warning.
- Bump compile/target SDK to 35 on Android.
- Bump minSdk to 19 on Android.
- bump AGP to 8.5.2.
-
0.18.1704 Feb 2025 -
0.18.1614 Dec 2024Release notes
Open source →- Support MPNowPlayingInfoPropertyIsLiveStream on IOS (@MuradSh, @celsoft).
-
0.18.1517 Jul 2024Release notes
Open source →- Add deep link support for FlutterFragmentActivity (@jan-milovanovic).
- Fix JDK 21 compile error.
-
0.18.1410 Jul 2024 -
0.18.1329 Mar 2024Release notes
Open source →- Fix Android NPE in sendNotificationClicked and onConnected.
- Catch and broadcast async platform exceptions.
- Support js '>=0.6.3 <0.8.0'
- Fix setAndroidPlaybackInfo call blocking (@julianscheel).
- Pass through missing extras to playFrom.../prepareFrom... (@Ruchit2759).
-
0.18.1212 Sep 2023 -
0.18.1128 Aug 2023Release notes
Open source →- Support custom media controls (@defsub)
- Support fast forward, rewind and stop when targeting Android 13 (@defsub)
-
0.18.1031 May 2023Release notes
Open source →- Add support for AGP 8 (@theskyblockman).
- Update AGP to 7.3.0.
- Update minimum flutter version to 3.0.
-
0.18.901 Jan 2023Release notes
Open source →- Fix cache bug in AudioServiceFragmentActivity (@Mordtimer).
- Add Android Auto manifest entry for example app (@ColinSchmale).
-
0.18.816 Dec 2022 -
0.18.717 Jul 2022Release notes
Open source →- Fix stopForeground bug on Android SDK < 24.
- Migrate to androidx.media 1.6.0 (@snipd-mikel)
- Propagate MediaItem extras to Android Auto (@snipd-mikel)
- Update progress bar in Android Auto (@snipd-mikel)
-
0.18.627 Jun 2022 -
0.18.521 Jun 2022Release notes
Open source →- Add AudioServiceFragmentActivity (@deimantasa).
- Support
content://art URIs in notification on Android (@nt4f04uNd). - Document Android foregroundServiceType.
-
0.18.427 Feb 2022Release notes
Open source →- Fix Android FlutterJNI error after quick relaunch.
- Fix Android NPE when destroying additional FlutterEngines.
-
0.18.324 Dec 2021 -
0.18.208 Dec 2021Release notes
Open source →- Guard against NPE when Android service is destroyed quickly.
- Migrate to flutter_lints.
- Queue messages from platform if init() called late.
- Fix deep linking on Android (@vishna/@ryanheise).
-
0.18.116 Oct 2021Release notes
Open source →- Remove iOS notification on stop.
- Fix setSpeed action on iOS.
- Eliminate redundant notification updates on Android.
- Handle null album and artist on web (@nt4f04uNd).
- Fix multithreaded crash in notification tap (@nt4f04uNd).
- Fix regression to show album art on lock screen (@nt4f04uNd).
- Add playlist/shuffle/loop example.
-
0.18.011 Sep 2021Release notes
Open source →- Use a single isolate for easier communication.
- Replace BackgroundAudioTask by AudioHandler.
- Replace AudioService.start by AudioService.init.
- Android Auto support.
- Android 11 media session resumption support.
- Federated plugin model.
- Composable audio handlers (@yringler).
- More callbacks:
- prepareFromSearch
- prepareFromUri
- playFromSearch
- playFromUri
- addQueueItems
- removeQueueItemAt
- setCaptioningEnabled
- getMediaItem
- search
- androidSetRemoteVolume
- androidAdjustRemoteVolume
- More state:
- queueTitle
- ratingStyle
- androidPlaybackInfo
- customState
- Default platform implementation for Windows/Linux (@keaganhilliard)
- iOS/macOS control center bug fixes (@nt4f04uNd)
- Fix queue index out of bounds bug (@kcrebound)
- Fix bug when starting foreground service from background (@chengyuhui)
- Make MediaItem.album nullable (@letiagoalves)
- Code quality:
- Unit tests (@suragch, @nt4f04uNd)
- Strong-mode and pedantic lints, code consistency (@nt4f04uNd)
- Improve artUri performance on Android (@nt4f04uNd)
- Better detection of browser support (@nt4f04uNd)
-
0.18.0-beta.110 Sep 2021 pre-releaseNothing published for this version
-
0.18.0-beta.012 Jul 2021 pre-releaseNothing published for this version
-
0.17.129 May 2021 -
0.17.027 Mar 2021 -
0.17.0-nullsafety.004 Mar 2021 pre-releaseNothing published for this version
-
0.16.228 Jan 2021Release notes
Open source →- Fix positionStream bug when seek is interrupted by onStop.
- Fix JS name clash for MediaMetadata.
- Update NowPlayingInfo speed correctly on iOS (@ryotayama).
-
0.16.2+124 Feb 2021 -
0.16.103 Jan 2021 -
0.16.023 Dec 2020Release notes
Open source →- setState parameters default to previous state.
- Change updateTime from Duration to DateTime.
- Rename newStartRating to newStarRating.
- Declare type of MediaItem.extras (@hacker1024).
- Unit tests.
- Fix compile error on macOS.
- Update dependencies.
-
0.15.309 Nov 2020Release notes
Open source →- Add positionStream and runningStream.
- Add androidShowNotificationBadge option (@aleexbt).
-
0.15.213 Oct 2020Release notes
Open source →- Process connect/disconnect/start requests in a queue.
- Guard against null setState arguments.
- Range check in onSkipToPrevious (@snaeji).
-
0.15.104 Oct 2020Release notes
Open source →- Fix loading of file:// artUri values.
- Allow booleans/doubles in MediaItems.
- Silently ignore duplicate onStop requests.
-
0.15.012 Sep 2020Release notes
Open source →- Web support (@keaganhilliard)
- macOS support (@hacker1024)
- Route next/previous buttons to onClick on Android (@stonega)
- Correctly scale skip intervals for control center (@subhash279)
- Handle repeated stop/start calls more robustly.
- Fix Android 11 bugs.
-
0.14.130 Aug 2020 -
0.14.026 Aug 2020Release notes
Open source →- audio session management now handled by audio_session (see Migration Guide).
- Exceptions in background audio task are logged and forwarded to client.
-
0.13.009 Aug 2020Release notes
Open source →- All BackgroundAudioTask callbacks are now async.
- Add default implementation of onSkipToNext/onSkipToPrevious.
- Bug fixes.
-
0.12.009 Aug 2020Release notes
Open source →- Add setRepeatMode/setShuffleMode.
- Enable iOS Control Center buttons based on setState.
- Support seek forward/backward in iOS Control Center.
- Add default behaviour to BackgroundAudioTask.
- Bug fixes.
- Simplify example.
-
0.11.226 Jun 2020 -
0.11.125 Jun 2020Release notes
Open source →- Allow setting the iOS audio session category and options.
- Allow AudioServiceWidget to recognise swipe gesture on iOS.
- Check for null title and album on Android.
-
0.11.012 Jun 2020Release notes
Open source →- Breaking change: onStop must await super.onStop to shutdown task.
- Fix Android memory leak.
-
0.10.009 Jun 2020Release notes
Open source →- Replace androidStopOnRemoveTask with onTaskRemoved callback.
- Add onClose callback.
- Breaking change: new MediaButtonReceiver in AndroidManifest.xml.
-
0.9.001 Jun 2020Release notes
Open source →- New state model: split into playing + processingState.
- androidStopForegroundOnPause ties foreground state to playing state.
- Add MediaItem.toJson/fromJson.
- Add AudioService.notificationClickEventStream (Android).
- Add AudioService.updateMediaItem.
- Add AudioService.setSpeed.
- Add PlaybackState.bufferedPosition.
- Add custom AudioService.start parameters.
- Rename replaceQueue -> updateQueue.
- Rename Android-specific start parameters with android- prefix.
- Use Duration type for all time values.
- Pass fastForward/rewind intervals through to background task.
- Allow connections from background contexts (e.g. android_alarm_manager).
- Unify iOS/Android focus APIs.
- Bug fixes and dependency updates.
-
0.8.004 May 2020Release notes
Open source →- Allow UI to await the result of custom actions.
- Allow background to broadcast custom events to UI.
- Improve memory management for art bitmaps on Android.
- Convenience methods: replaceQueue, playMediaItem, addQueueItems.
- Bug fixes and dependency updates.
-
0.7.215 Apr 2020Release notes
Open source →- Shutdown background task if task killed by IO (Android).
- Bug fixes and dependency updates.
-
0.7.110 Apr 2020Release notes
Open source →- Add AudioServiceWidget to auto-manage connections.
- Allow file URIs for artUri.
-
0.7.007 Apr 2020Release notes
Open source →- Support skip forward/backward in command center (iOS).
- Add 'extras' field to MediaItem.
- Artwork caching and preloading supported on Android+iOS.
- Bug fixes.
-
0.6.224 Feb 2020 -
0.6.105 Feb 2020 -
0.6.030 Jan 2020 -
0.5.728 Dec 2019 -
0.5.625 Dec 2019 -
0.5.518 Dec 2019 -
0.5.405 Dec 2019 -
0.5.301 Dec 2019 -
0.5.225 Nov 2019 -
0.5.123 Nov 2019 -
0.5.022 Nov 2019 -
0.4.210 Nov 2019 -
0.4.129 Sep 2019 -
0.4.027 Sep 2019