A simple soundboard app, with:
- Quotes laid out as a scrollable grid of captioned image tiles. Tapping on one plays the sound bite.
- A search bar, allowing quotes to be filtered by their content and by other metadata such as the TV show they're from
- 'Play random' floating action button, which will play a random quote of those returned by the current search
- Ability to share a quote (e.g. to WhatsApp) by long-pressing on it
This project uses asdf to manage the necessary tools. To get set up, run (from the root of the repo):
./init-asdf.shThis will prompt you to install asdf and set up the required plugins. Once flutter is setup, run flutter pub get to grab the project dependencies.
If you want to fork this project to make your own soundboard, here are all the things you might want to change and how to do it.
- App icon: This project uses flutter_launcher_icons for this. To change it, edit the corresponding section in
pubspec.yamlthen run:
flutter pub run flutter_launcher_icons- Splash screen: This project uses flutter_native_splash. There is again a section of pubspec to update, after which you should run:
dart run flutter_native_splash:create- App name: Search+replace the string YOUR_NAME_HERE
- Audio clips: These should be in mp3 format and added to the root of the assets/ folder
- Images for the clips.
- At least one per 'source' of audio, but can add more if you want more granularity than that
- Must be square, at least 200x200 pixels in size and in PNG format. Add to assets/images/
- Quote metadata is all joined up in
quotes_list.dart
The app is a lot more user-friendly if you normalise the various audio clips, so they play at a similar volume. To do this, you can use the normalize-audio package:
./scripts/normalise-audio.sh- To regenerate Mockito mock files (*.mocks.dart):
flutter pub run build_runner build && dart format --line-length 120 .- To run integration tests, start up an emulator and then run:
flutter test integration_test