Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bluefireteam/audioplayers

A Flutter package to play multiple audio files simultaneously (Android/iOS/web/Linux/Windows/macOS)
https://github.com/bluefireteam/audioplayers

audio audio-player dart flame flutter hacktoberfest player

Last synced: 3 days ago
JSON representation

A Flutter package to play multiple audio files simultaneously (Android/iOS/web/Linux/Windows/macOS)

Awesome Lists containing this project

README 

        


  

    AudioPlayers

  





  A Flutter plugin to play multiple simultaneously audio files, works for Android, iOS, Linux, macOS, Windows, and web.






  

  

  

  




---





Check out the live example app.



**Note**: all the docs are kept up to date to reflect the content of the current newest release. If you are looking for older information and guidance, please checkout the [tag](https://github.com/bluefireteam/audioplayers/tags) related to the version that you are looking for.



If you are interest in migrating major versions, please check the [changelog](CHANGELOG.md) and [our migration guide](https://github.com/bluefireteam/audioplayers/blob/main/migration_guide.md).



## Getting Started



We tried to make audioplayers as simple to use as possible:



```dart

import 'package:audioplayers/audioplayers.dart';

// ...

final player = AudioPlayer();

await player.play(UrlSource('https://example.com/my-audio.wav'));

```



Please follow our [Getting Started tutorial](https://github.com/bluefireteam/audioplayers/blob/main/getting_started.md) for all high-level information you need to know.



Then, if you want to dig deeper, our code is very well documented with dartdocs, so check [our API reference](https://pub.dev/documentation/audioplayers/latest/) or the codebase itself on your IDE (or on GitHub).



If something is not clear on our docs, please send a PR to help us improve.



## Help



If you have any problems, please follow these steps before opening an issue.



1. Carefully read the [Getting Started tutorial](https://github.com/bluefireteam/audioplayers/blob/main/getting_started.md) before anything else. Re-read if necessary.

1. Check our [Troubleshooting Guide](https://github.com/bluefireteam/audioplayers/blob/main/troubleshooting.md) for solutions for most problems.

1. If you have a missing feature report or feature request, please first check the [Feature Parity Table](https://github.com/bluefireteam/audioplayers/blob/main/feature_parity_table.md) to understand our roadmap and what we know is missing. We love contributions!

1. Join [Blue Fire's Discord server](https://discord.gg/5unKpdQD78) and ask for directions. Maybe it's not a bug, or it's a known issue.

1. If you are more comfortable with StackOverflow, you can also create a question there. Add the [flutter-audioplayers tag](https://stackoverflow.com/questions/tagged/flutter-audioplayers), so that anyone following the tag can help out.

1. If the issue still persists, go to the [create an issue](https://github.com/bluefireteam/audioplayers/issues/new/choose) page and follow the step-by-step there before submitting.

1. If the step-by-step there doesn't give you any help, then proceed to create the issue **following the template**. Do not skip mandatory sections. Do not include the literal text of the template, rather replace the sections with what they should contain.



Any issues created not following the list above can be flagged or closed by our team.



## Feature Parity Table



Not all features are available on all platforms. [Click here](https://github.com/bluefireteam/audioplayers/blob/main/feature_parity_table.md) to see a table relating what features can be used on each target.



Feel free to use it for ideas for possible PRs and contributions you can help with on our roadmap! If you are submitting a PR, don't forget to update the table.



## Support



The simplest way to show us your support is by giving the project a star! :star:



You can also support us monetarily by donating through OpenCollective:





  




Through GitHub Sponsors:





  




Or by becoming a patron on Patreon:





  




**Note**: this software was made by the community, for the community, on our spare time, with no commercial affiliation.

It is provided as is and any positive contribution is appreciated.

Be kind and mindful of the free time that a battalion of people has gifted on behalf of the community to craft and maintain this.



## Contributing



All help is appreciated but if you have questions, bug reports, issues, feature requests, pull requests, etc, please first refer to our [Contributing Guide](https://github.com/bluefireteam/audioplayers/blob/main/contributing.md).



Be sure to check the [Feature Parity Table](https://github.com/bluefireteam/audioplayers/blob/main/feature_parity_table.md) to understand if your suggestion is already tracked, on the roadmap, or out of scope for this project.



Also, as always, please give us a star to help!



## Credits



This was originally a fork of [rxlabz's audioplayer](https://github.com/rxlabz/audioplayer), but since we have diverged and added more features.



Thanks for @rxlabz for the amazing work!