audioplayers
A Flutter plugin to play multiple audio files simultaneously
6.8.1
1.2M downloads/mo
#316 most downloaded on pub.dev
bluefireteam/audioplayers
What this package is like to depend on
Last release 1 months ago
27 Jun 2026
Release timing varies
gaps range from 9 days to 6 months
Nearly every release is documented
notes for 85 of 85 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
92 releases · first in 2017
6 releases in the last 12 months
see the full history below
Release timeline
92 releases · Oct 2017 to Jun 2026Releases
latest 60 of 92-
6.8.127 Jun 2026Release notes
Open source →Prepared all packages to be released to pub.dev
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Gustl22 [email protected]Release notes
Open source →- FIX: Avoid throwing a StateError in AudioPlayer._completePrepared (#2010). (d8a4f395)
- FIX(windows): Compatibility with Visual Studio 18 (2026) (#2011). (ae5f4b96)
Pay attention to the new Windows platform requirements.
-
6.8.022 Jun 2026Release notes
Open source →Prepared all packages to be released to pub.dev
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
-
6.7.105 Jun 2026Release notes
Open source →2026-05-28
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
audioplayers-v6.7.0audioplayers_android_exo-v0.1.3+1audioplayers_web-v5.2.1audioplayers_windows-v4.3.1
-
6.7.029 May 2026 -
6.6.001 Mar 2026 -
6.5.103 Sep 2025Release notes
Open source →2025-06-15
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
audioplayers-v6.5.0audioplayers_android-v5.2.1audioplayers_android_exo-v0.1.2+1audioplayers_darwin-v6.3.0audioplayers_linux-v4.2.1audioplayers_platform_interface-v7.1.1audioplayers_web-v5.1.1audioplayers_windows-v4.2.1
-
6.5.015 Jun 2025 -
6.4.011 Mar 2025 -
6.3.006 Mar 2025Release notes
Open source →- FEAT(android): ExoPlayer for Android (#1691). (a91c5b18)
You can enable the non-endorsed plugin implementation based on ExoPlayer (Media3) by calling:flutter pub add audioplayers_android_exoin your app package folder. For more, see: https://github.com/bluefireteam/audioplayers/blob/main/feature_parity_table.md#media3-exoplayer - FEAT: Raise to Flutter 3.29.0 (#1891). (26bd6d22)
- DOCS: Fix status badge (#1899). (a0c6c4fa)
- FEAT(android): ExoPlayer for Android (#1691). (a91c5b18)
-
6.2.018 Feb 2025 -
6.1.209 Feb 2025 -
6.1.128 Jan 2025 -
6.1.027 Aug 2024 -
6.0.019 Mar 2024Release notes
Open source →- FIX: Use unique tmp location for each AudioCache (#1724). (2333cb7f)
- FIX: Race condition when playing/pausing audio (#1705). (463b2a11)
- FIX: Seek not applied in
playmethod (#1695). (f6138fef) - FIX: Propagate Stream Errors through the same Future (#1732). (00d041df)
- FIX: Wait for seek to complete (#1712). (fd33b1d0)
- FEAT: Support byte array and data URIs via mimeType (#1763). (eaf7ce86)
- FEAT(ios): Improved AudioContextConfig assertions, fix example (#1619). (df342c52)
- FEAT(web): Support compilation to Wasm (#1766). (1b1a0cf9)
- DOCS: Improve Docs (#1710). (4208463a)
- BREAKING REFACTOR: Remove deprecated methods (#1583). (8d0cbeda)
- BREAKING FEAT: FramePositionUpdater & TimerPositionUpdater (#1664). (1ea93536)
- BREAKING FEAT: Extend
AudioContextConfig.duckAudiotoAudioContextConfig.focus(#1720). (87f3cb7e) - BREAKING FEAT(ios): Improve AudioContextIOS (#1591). (25fbec05)
- BREAKING DEPS: Update min Flutter to v3.13.0, compatibility with v3.16.8 (#1715). (e4262f4c)
- BREAKING CHORE: Upgrade to Flutter 3.13.0 (#1612). (1a3de1ac)
Release notes
Open source →Note: This release has breaking changes.
- FIX: Use unique tmp location for each AudioCache (#1724). (2333cb7f)
- FIX: Race condition when playing/pausing audio (#1705). (463b2a11)
- FIX: Seek not applied in
playmethod (#1695). (f6138fef) - FIX: Propagate Stream Errors through the same Future (#1732). (00d041df)
- FIX: Wait for seek to complete (#1712). (fd33b1d0)
- FEAT: Support byte array and data URIs via mimeType (#1763). (eaf7ce86)
- FEAT(ios): Improved AudioContextConfig assertions, fix example (#1619). (df342c52)
- FEAT(web): Support compilation to Wasm (#1766). (1b1a0cf9)
- DOCS: Improve Docs (#1710). (4208463a)
- BREAKING REFACTOR: Remove deprecated methods (#1583). (8d0cbeda)
- BREAKING FEAT: FramePositionUpdater & TimerPositionUpdater (#1664). (1ea93536)
- BREAKING FEAT: Extend
AudioContextConfig.duckAudiotoAudioContextConfig.focus(#1720). (87f3cb7e) - BREAKING FEAT(ios): Improve AudioContextIOS (#1591). (25fbec05)
- BREAKING DEPS: Update min Flutter to v3.13.0, compatibility with v3.16.8 (#1715). (e4262f4c)
- BREAKING CHORE: Upgrade to Flutter 3.13.0 (#1612). (1a3de1ac)
-
5.2.114 Nov 2023Release notes
Open source → -
5.2.002 Oct 2023Release notes
Open source →- REFACTOR: Lint Swift (#1613). (737aa94f)
- REFACTOR: Lint Kotlin, C and C++ code (#1610). (05394668)
- FIX: Cancel
onPreparedSubscriptionon error (#1660). (c11dbf30) - FIX: Set playback rate only when playing (#1658). (d73c7d5c)
- FIX: Improve Error handling for Unsupported Sources (#1625). (a4d84422)
- FIX: Return null for duration and position, if not available (#1606). (2a79644a)
- FEAT(windows): Support for BytesSource on Windows (#1601). (a9e14710)
- FEAT: Allow adding custom media sources to example (#1637). (1eabe619)
- DOCS: Deploy live example app to GH pages (#1623). (fe81f3b1)
-
5.1.009 Aug 2023 -
5.0.024 Jul 2023Release notes
Open source →Note: This release has breaking changes.
- REFACTOR(windows): simplify position and duration processing (#1553). (ca63c5a4)
- FIX(example): Use kotlin version compatible with AGP8 (#1577). (8f4b1bb0)
- FIX(linux): allow reusing event channel with same name (#1555). (5471189f)
- FEAT(android): Add support for AGP 8 in example, add compileOptions to build.gradle (#1503). (7c08e4e1)
- BREAKING FIX: Default audio output to system preferences (#1563). (381c43e3)
- BREAKING CHORE: Bump Flutter to version 3.10.x (#1529). (c1296c9b)
-
4.1.029 May 2023Release notes
Open source →- REFACTOR: Adapt to flame_lint v0.2.0+2 (#1477). (e1d7fb6a)
- FIX: Timeout on setting same source twice (#1520). (5d164d1f)
- FIX: test and fix compatibility with min flutter version (#1510). (9f39e95f)
- FIX: onPrepared event to wait until player is ready / finished loading the source (#1469). (50f56365)
- FIX: rework dispose (#1480). (c64ef6d9)
- FEAT: Adapt position update interval of darwin, linux, web (#1492). (ab5bdf6a)
- DOCS: Improve docs (#1518). (4c0d5546)
-
4.0.112 Apr 2023Release notes
Open source →2024-08-26
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
-
4.0.011 Apr 2023Release notes
Open source →- FIX(linux): Handle failures of OnMediaStateChange in OnMediaError (#1731). (3a5c6dca)
- FIX: Wait for seek to complete (#1712). (fd33b1d0)
- BREAKING FEAT: FramePositionUpdater & TimerPositionUpdater (#1664). (1ea93536)
- BREAKING DEPS: Update min Flutter to v3.13.0, compatibility with v3.16.8 (#1715). (e4262f4c)
- BREAKING CHORE: Upgrade to Flutter 3.13.0 (#1612). (1a3de1ac)
Release notes
Open source →Note: This release has breaking changes.
- FIX(android): Avoid calling onDuration on position event (closes #136) (#1460). (6cfb3753)
- FEAT: replace
Platform.isXwithdefaultTargetPlatform(#1446). (6cd5656c) - FEAT(example): add invalid asset, small refactor, colored source buttons (#1445). (92a20fad)
- FEAT(android): add
setBalance(#58) (#1444). (3b5de50e) - FEAT: extract AudioContext from audio_context_config (#1440). (e59c3b9f)
- FEAT(ios): set player context globally on
setAudioContextfor iOS only (#1416). (19af364b) - FEAT(example): update app icons (#1417). (ac35df89)
- FEAT: AudioPool (moved and improved from flame_audio) (#1403). (ab15cb02)
- DOCS: update AudioCache explanation, migration guide, replace package READMEs (#1457). (b8eb1974)
- DOCS: update example app and screenshots (#1419). (c48eaf38)
- BREAKING REFACTOR: prevent from confusing and conflicting class names (#1465). (7cdb8586)
- BREAKING REFACTOR: improve separation of global audioplayer interface (#1443). (c0b3f85c)
- BREAKING FEAT: event channel (#1352). (c9fd6a76)
- BREAKING FEAT: expose classes of package
audioplayers_platform_interface(#1442). (a6f89be1)
Migration instructions
Before After deprecated AudioPlayer.global.changeLogLevel(LogLevel.info)AudioLogger.logLevel = AudioLogLevel.infodeprecated AudioPlayer.global.logLevelAudioLogger.logLeveldeprecated AudioPlayer.global.log()AudioLogger.log()orAudioLogger.error()deprecated AudioPlayer.global.info()AudioLogger.log()deprecated AudioPlayer.global.error()AudioLogger.error()GlobalPlatformInterfaceGlobalAudioScopedeprecated AudioPlayer.global.setGlobalAudioContext()AudioPlayer.global.setAudioContext()ForPlayer<>removed -
3.0.128 Jan 2023 -
3.0.024 Jan 2023 -
2.0.010 Jan 2023Release notes
Open source →- FEAT(windows): show nuget download info explicitely in verbose mode (#1449). (136028fa)
- DOCS: update AudioCache explanation, migration guide, replace package READMEs (#1457). (b8eb1974)
- DOCS: Fix LICENSE files for windows and linux (#1431). (1f84e857)
- BREAKING FEAT: event channel (#1352). (c9fd6a76)
-
1.2.001 Jan 2023Release notes
Open source →- FIX: Duration precision on Windows (#1342). (3cda1a65)
- FIX: infinity / nan on getDuration (#1298). (a4474dcf)
- FEAT: upgrade flutter to v3.0.0 and dart 2.17 to support "Super initializers" (#1355). (4af417b4)
- FEAT: local test server (#1354). (06be429a)
- FEAT: get current source (#1350). (7a10be38)
- FEAT: log path and url of sources (#1334). (8a13f96d)
- FEAT: add setBalance (#58) (#1282). (782fc9df)
- DOCS: Fix repos and homepages on pubspecs (#1349). (0bdde4d9)
- BREAKING FIX: Cache should take key to be properly cleared (#1347). (1a410bba)
Release notes
Open source →Note: This release has breaking changes.
- FIX: Duration precision on Windows (#1342). (3cda1a65)
- FIX: infinity / nan on getDuration (#1298). (a4474dcf)
- FEAT: upgrade flutter to v3.0.0 and dart 2.17 to support "Super initializers" (#1355). (4af417b4)
- FEAT: local test server (#1354). (06be429a)
- FEAT: get current source (#1350). (7a10be38)
- FEAT: log path and url of sources (#1334). (8a13f96d)
- FEAT: add setBalance (#58) (#1282). (782fc9df)
- DOCS: Fix repos and homepages on pubspecs (#1349). (0bdde4d9)
- BREAKING FIX: Cache should take key to be properly cleared (#1347). (1a410bba)
-
1.1.108 Oct 2022Release notes
Open source →- FIX: Duration precision on Windows (#1342). (3cda1a65)
- DOCS: Fix repos and homepages on pubspecs (#1349). (0bdde4d9)
2022-10-08
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
audioplayers-v1.1.1audioplayers_android-v1.1.1audioplayers_darwin-v1.0.3audioplayers_web-v2.0.1
-
1.1.026 Sep 2022Release notes
Open source →- FIX: player state not being updated to completed (#1257). (70a37afb)
- FIX: lowLatency bugs (closes #1176, closes #1193, closes #1165) (#1272). (541578cc)
- FIX: ios/macos no longer start audio when calling only setSourceUrl (#1206). (c0e97f04)
- FEAT: improve example (#1267). (a8154da1)
- FEAT: Platform integration tests 🤖 (#1128). (b0c84aab)
- DOCS: Remove 11-month old outdated doc file (#1180). (bae43cb1)
-
1.0.119 Jun 2022Release notes
Open source →- FIX: Make sure onComplete resets the position even when not looping (#1175). (6e6005ac)
-
1.0.012 Jun 2022 -
1.0.0-rc.408 May 2022 pre-releaseRelease notes
Open source →- FIX: Fix iOS code that was missing from previous push (melos vs pub get issue) (#1122). (fe737849)
-
1.0.0-rc.308 May 2022 pre-releaseRelease notes
Open source →- FEAT: Add onPlayerCompletion, onPlayerStateChanged and onDurationChanged for web (#1123). (760e0c94)
2022-05-08
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
audioplayers_linux-v1.0.0-rc.3audioplayers-v1.0.0-rc.3audioplayers_darwin-v1.0.0-rc.3audioplayers_windows-v1.0.0-rc.3
-
1.0.0-rc.230 Apr 2022 pre-release -
1.0.0-rc.101 Apr 2022 pre-releaseRelease notes
Open source →- First release after federation
2022-04-01
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
audioplayers_windows-v1.0.0-rc.1audioplayers_android-v1.0.0-rc.1audioplayers_darwin-v1.0.0-rc.1
-
0.20.112 Sep 2021 -
0.20.006 Sep 2021Release notes
Open source →- Fix android/kotlin build for old projects
- Add method to clearNotification
- Add currentPosition stream on web
- Add seek on web
- Add a proper Logger
- Make setPlaybackRate signature consistent
- Fix fatal exception on Android API < 21 in WrappedMediaPlayer.kt setAttributes
- Add clearNotification method
-
0.19.101 Jul 2021Release notes
Open source →- Add missing awaits for AudioCache
- Fix Kotlin Core version to v1.6.0
- Fix iOS warning
- Fix README link to audio_cache.md to work on pub
- Fix documentation referencing old class
- Add web support for audioPlayer.getCurrentPosition
- Add web support for audioPlayer.getDuration
- Add web support for audioPlayer.setPlaybackRate
- Fix local file playback in LOW_LATENCY mode on Android
-
0.19.013 May 2021Release notes
Open source →- Refactor Notifications code (small breaking changes)
- AudioCache for web
- Fixing basic features for Android lower than API 23
- Fixing error after playing music several times with AudioCache
- Re-organize folder and file structure on the Dart side (project layout)
- Re-organize folders into a mono-repo
- Fix several bugs
-
0.18.330 Mar 2021Release notes
Open source →- Fix Float vs Double mixup on Swift that prevent non-integer values for volume/playback
- Fix open sink issue / resource leak
-
0.18.228 Mar 2021Release notes
Open source →- Changing Android minSdk verison to 16
- Improve build processes and other small bug fixes
-
0.18.123 Mar 2021Release notes
Open source →- Fix kotlin config issue for some apps
- Fix warning from pub
- Fix iOS lock screen
- Fix setUrl method
-
0.18.018 Mar 2021 -
0.17.419 Feb 2021 -
0.17.326 Jan 2021 -
0.17.208 Jan 2021 -
0.17.131 Dec 2020Release notes
Open source →- Use better algorithm for speed modulation on iOS
- Extracted and refactored all the notifications code onto the new file
- Add more checks and make sure notifcations code is not ran when it shouldn't
- Add more useful info to the troubleshoot guide
-
0.17.018 Nov 2020 -
0.16.225 Oct 2020Release notes
Open source →- Overhauled our contributing guidelines
- Improve docs around player state
- Update dependencies versions
-
0.16.107 Sep 2020Release notes
Open source →- Fix Exception thrown when calling audioPlayer.dispose
- Fix bug with AudioCache crash on iOS
-
0.16.024 Aug 2020Release notes
Open source →- Implemented stream routing for iOS
- Call release on dispose
- Fix iOS build
- Breaking change audio cache prefix in order to allow override 'assets'
-
0.15.114 Apr 2020 -
0.15.1-beta11 Apr 2020 pre-releaseNothing published for this version
-
0.15.004 Apr 2020Release notes
Open source →- Improve loop/readme for web support
- Audio cache support for web
- Re-adding partial web support
-
0.15.0-beta.128 Mar 2020 pre-releaseNothing published for this version
-
0.15.0-beta28 Mar 2020 pre-releaseNothing published for this version
-
0.14.222 Mar 2020 -
0.14.118 Mar 2020Release notes
Open source →- Adding linter, tests and flutter_driver integration tests to a CI (github actions)
- Minor fixes to the APIs and documentation
- Fix restarting the playback of a failed AVPlayerItem
- Prevent exceptions when null values are passed to notifications center
- Prevent crash by checking if headlessServiceInitialized before invoking onNotificationBackgroundPlayerStateChanged
-
0.14.019 Jan 2020Release notes
Open source →- Adding macOs support
- ios:fix lack of seek completion handle
- ios Delay start fixed
-
0.13.705 Jan 2020 -
0.13.631 Dec 2019Release notes
Open source →- added
setPlaybackRatefeature for Android - Automatic detect address is local or remote (thanks, @saeed-golshan)
- added
-
0.13.505 Dec 2019Release notes
Open source →- fixed crash on iOS when
startHeadlessService()wasn't called onAudioPlayer(by @JesseScott)
- fixed crash on iOS when