{"id":15294783,"url":"https://github.com/erikas-taroza/simple_audio","last_synced_at":"2025-04-08T04:19:35.841Z","repository":{"id":65084280,"uuid":"556571271","full_name":"erikas-taroza/simple_audio","owner":"erikas-taroza","description":"A simple cross-platform solution for playing audio in Flutter.","archived":false,"fork":false,"pushed_at":"2025-03-11T06:10:35.000Z","size":1292776,"stargazers_count":40,"open_issues_count":2,"forks_count":10,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-26T21:11:01.038Z","etag":null,"topics":["android","audio","audio-player","flutter","ios","linux","macos","windows"],"latest_commit_sha":null,"homepage":"https://pub.dev/packages/simple_audio","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/erikas-taroza.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-24T05:14:12.000Z","updated_at":"2025-03-11T06:10:38.000Z","dependencies_parsed_at":"2024-10-27T23:19:56.319Z","dependency_job_id":"f181daec-0086-416e-b40e-f3af655824b3","html_url":"https://github.com/erikas-taroza/simple_audio","commit_stats":{"total_commits":709,"total_committers":4,"mean_commits":177.25,"dds":0.05782792665726377,"last_synced_commit":"92c78bf601158628cc440407e35e29e4b365c467"},"previous_names":[],"tags_count":45,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikas-taroza%2Fsimple_audio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikas-taroza%2Fsimple_audio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikas-taroza%2Fsimple_audio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikas-taroza%2Fsimple_audio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/erikas-taroza","download_url":"https://codeload.github.com/erikas-taroza/simple_audio/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247773726,"owners_count":20993639,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","audio","audio-player","flutter","ios","linux","macos","windows"],"created_at":"2024-09-30T17:06:57.318Z","updated_at":"2025-04-08T04:19:35.810Z","avatar_url":"https://github.com/erikas-taroza.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simple Audio\n\nA cross-platform solution for playing audio in Flutter.\n\nThis project's goal is to be as simple as possible, meaning it offers the core functionality only (ex. play/pause).\nIt also aims to be stable and relatively bug free.\n\nI created this plugin for my music app so that I don't have to use different packages for different\nplatforms (audio_service, dart_vlc). This made it hard to deal with bugs from different packages.\n\n## Features\n\n- Simple API\n- Cross platform (Android, Linux, Windows, iOS, macOS)\n- Playback of local and online resources\n- Gapless playback and preloading\n- Volume normalization\n\n## Documentation\n\nThe documentation is hosted by `pub.dev`. You can find it [here](https://pub.dev/documentation/simple_audio/latest/simple_audio/simple_audio-library.html).\n\n## Usage\n\n- Add this plugin as a dependency in `pubspec.yaml`\n- Follow the [setup steps](https://github.com/erikas-taroza/simple_audio#setup).\n- Call `SimpleAudio.init()` in `main()` ([see below](https://github.com/erikas-taroza/simple_audio#initialization)).\n- Instantiate a `SimpleAudio` object in your player controller ([see below](https://github.com/erikas-taroza/simple_audio#create-player)).\n- Use the APIs provided in the instantiated object ([see below](https://github.com/erikas-taroza/simple_audio#open-and-play)).\n\nAn example player project is located [here](https://github.com/erikas-taroza/simple_audio/tree/master/example).\n\n### Initialization\n\n```dart\nvoid main() async {\n  WidgetsFlutterBinding.ensureInitialized();\n\n  await SimpleAudio.init();\n\n  runApp(const MyApp());\n}\n```\n\n### Create Player\n\n```dart\nfinal SimpleAudio player = SimpleAudio(shouldNormalizeVolume: false);\n```\n\n### Open and Play\n\n```dart\nplayer.playbackState.listen((state) =\u003e print(state));\nplayer.progressState.listen((state) =\u003e print(state));\n// Autoplays by default\nplayer.open(path);\n```\n\n## Setup\n\nSome platform specific things have to be set up in order for this plugin to function properly.\n\n### Windows, Linux, macOS, Android\n\nNo setup is needed.\n\n### iOS\n\nYou will have to add a dependency to your Xcode project.\n\n- Open `Runner.xcworkspace` in the `ios` folder.\n- At the top of your project hierarchy view, select the `Runner` project.\n- Select the `Runner` target, go to the `General` tab and scroll down until you see `Frameworks, Libraries, Embedded Content`\n- Press the `+` icon and add the `AudioToolbox.framework` framework. Select `Do Not Embed` under the `Embed` column.\n\n### Special Thanks\n\n- [sanihaq](https://github.com/sanihaq) - Reported multiple bugs in `simple_audio`'s first releases.\n  These bugs would not have been fixed for a long time without their help.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferikas-taroza%2Fsimple_audio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ferikas-taroza%2Fsimple_audio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferikas-taroza%2Fsimple_audio/lists"}