# README [![](https://www.canardoux.xyz/tau/doc/images/banner5.svg)](http://www.canardoux.xyz/tau/doc/pages/flutter-sound/api/topics/readme.html) [![pub version](https://img.shields.io/pub/v/flutter_sound.svg)](http://www.canardoux.xyz/tau/doc/pages/flutter-sound/api/topics/readme.html) * **Flutter Sound user: your** [**documentation is there**](http://www.canardoux.xyz/tau_sound/doc/pages/flutter-sound/api/topics/readme.html) * **The** [**CHANGELOG file is here**](http://www.canardoux.xyz/tau_sound/doc/pages/flutter-sound/api/topics/changelog.html) ![Demo](https://user-images.githubusercontent.com/27461460/77531555-77c9ec00-6ed6-11ea-9813-320f943b08cc.gif) ## Overview Flutter Sound is a Flutter package allowing you to play and record audio for : * Android * iOS * Flutter Web Maybe, one day, we will be supported by Linux, Macos, and even (why not) Windows. But this is not top of our priorities. Flutter Sound provides both a high level API and widgets for: * play audio * record audio Flutter Sound can be used to play a beep from an asset all the way up to implementing a complete media player. The API is designed so you can use the supplied widgets or roll your own. ## Features The Flutter Sound package includes the following features * Play and Record flutter sound or music with various codecs. * Play local or remote files specified by their URL. * Play assets. * Play audio using the built in SoundPlayerUI Widget. * Roll your own UI utilising the Flutter Sound api. * Record audio using the builtin SoundRecorderUI Widget. * Roll your own Recording UI utilising the Flutter Sound api. * Support for releasing/resuming resources when the app pauses/resumes. * Record to a Dart Stream * Playback from a Dart Stream * The App playback can be controled from the device lock screen or from an Apple watch ## Changelog You can find the [changes here](http://www.canardoux.xyz/tau_sound/doc/pages/flutter-sound/api/topics/changelog.html) ## Documentation The [documentation is here](http://www.canardoux.xyz/tau_sound/doc/pages/flutter-sound/api/topics/readme.html) ## License Flutter Sound is copyrighted by Dooboolab (2018, 2019, 2020). Flutter Sound is released under a license with a *copyleft* clause: the LGPL-V3 license. This means that if you modify some of Flutter Sound code you must publish your modifications under the LGPL license too. ## Help Maintenance Flutter Sound is a fundamental building block needed by almost every flutter project. I'm looking to make Flutter Sound the go to project for Flutter Audio with support for each of the Flutter supported platforms. Flutter Sound is a large and complex project which requires me to maintain multiple hardware platforms and test environments. We greatly appreciate any contributions to the project which can be as simple as providing feedback on the API or documentation. My friend Hyo has been maintaining quite many repos these days and he is burning out slowly. If you could help him cheer up, buy him a cup of coffee will make his life really happy and get much energy out of it. As a side effect, we will know that Flutter Sound is important for you, that you appreciate our job and that you can show it with a little money. [![Paypal](https://www.paypalobjects.com/webstatic/mktg/Logo/pp-logo-100px.png)](https://paypal.me/dooboolab) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://canardoux.gitbook.io/tau/master.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.