Share your audio-spatial experiences, wherever you are.

A Hack'n'Roll 2020 Project by Team Doki Doki Tanama Club (@Q-gabe and @seanlowjk). ♫

Drop The Beat - Redefining how we share the music we love. ❤️

Ever felt that serene peace during a train ride or on a smooth drive at the hustle and bustle, just listening to your favourite track? Or maybe, that pulse of adrenaline blasting your favourite EDM hits while gaming it out at a LAN shop?

So have we! For Hack'n'Roll 2020, our team built an application that enables anyone to share that audio-spatial experience with others easily on the go. And so we proudly we present our multi-platform mobile application Drop The Beat!

Main Features ✨

• Geolocation-tagging with your favourite songs 🌏
  • 'Drop' your songs onto your current location to capture your favourite audio-spatial moment!
• Share your experience in real-time! 🕐
  • Drops are updated with our backend in real-time to share your tags with others instantly!
• Song search powered by Spotify 🎵
  • Choose from the entire 50+ million songs available from Spotify to drop!
• Cross-platform 📱
  • iOS and Android ready!
• Many more planned features! 👷🔜
  • Drop The Beat is currently in development and we hope to bring many more features soon!

Drop The Beat's Roadmap! 🗺️

• We plan to increase the interactivity of our application with Spotify, so that Droppers can enjoy an even better user experience (Direct linking to songs, album crawling, etc.).
• We hope to provide a temporary in-app broadcast channel (DropParties 👑) for Droppers who are in the near vicinity to join, and stream music together! (Think Silent Disco but modular in design!)
• Our idea banks are full and we are excited to work on the Drop The Beat even further!

Getting Started 🎇

As Drop The Beat is still currently in very early development, we have yet to release a build-ready Android apk or Apple app, and as such are using purely debug builds as of right now. This is in-line with our goal of establishing a proof-of-concept of Drop The Beat and making it for the deadline of the initial hackathon. As development continues, we hope to be able to ship a full release of the application soon.

However, if you are a developer looking to test the application, here are the steps required to get a debugging environment set up to run our current debug build:

• 1. Install the Flutter SDK according to the Flutter Installation Guide. Ensure that flutter doctor -v shows no errors for the platform that you intend to test on (Android or iOS).
• 2. Clone this repository and navigate to it on your computer.
• 3. Follow the instructions as specified in the links below to set up either an emulator or an actual device to run the application in debug mode:
  • 3.1. Android Setup
  • 3.2. iOS Setup
• 4. Running flutter run will launch Drop The Beat on your emulator/device. To install a portable debug version of the application on your connected device, ensure the device is connected and run flutter install.

Development and Contributions 👾

We built Drop The Beat with:

• Firebase - Back-end for geolocation tags.
• Flutter - Front-end mobile framework using Dart.
• Google Maps API - Geolocation Processing.
• Spotify API - Song search Processing.

We welcome contributors to work on Drop The Beat together with us! Feel free to make various improvements as you see fit, no matter how small! Changes will be subject to approval however through pull requests.

Contributors

👾 Author	🍺 Roles
Q-gabe	Front-end, API Development, Flutter Admiral
seanlowjk	Back-end, API Development, Baron of Firebase

Hackathon and Learning Experience 💻

Click here for the project's Devpost to learn more about what we went through in the 24 hours in building Drop The Beat!

License 📝

This project is licensed under the MIT License - see the LICENSE file for details.