Find the right song for the right mood, anytime.

A Hack&Roll 2021 Project by Team FlutterAway (@GabrielTeo, @todoge, @VaishakAnand and @zongxian-ctrl).

Moodsicle - Music for every mood. 🎧

Ever felt like sometimes you just couldn't find the right song? Or that the music just didnt quite fit the mood?

We were listening to some music and were pretty tired of them, and we thought "Hey, the mood's pretty sad, and we always listen to the same songs on loop. Imagine if we had a way to suggest songs based on your mood".

And that's exactly what we have done for Hack&Roll 2021! We have built an application that suggests music based on your current mood, regardless of the occasion! Never will you ever have the problem of surfing through endless tracks of songs just to find the right one again, all thanks to our multi-platform mobile application Moodsicle!

Main Features 🎵

• Song search based on mood 🤷
  • Type however you are feeling into the text box and search for the perfect song!
• Speech to text enabled 💬
  • Option to speak into the mic without typing!
• Search history 📑
  • Searched songs are stored so you can find them again anytime!
• Music data powered by Musicovery ⚡
  • Backed by a comprehensive music recommendation engine with playlist charts since 1960!
• Cross-platform 📱
  • iOS and Android ready!
• Many more planned features! ⏳
  • Moodsicle is currently in development and we hope to bring more features in the future!

Moodsicle's Roadmap! 🗺️

• We plan to include Spotify's API to link the songs to Spotify so that users can open the songs directly in Spotify.
• We hope to include an in-app music player with full standard player functionalities (users can play and listen to songs on-the-go, as well as forward / reverse / skip tracks).

Getting Started 🔰

If you want to try out Moodsicle, you can head over to our Releases to install our latest Android APK on your Android device. However, as Moodsicle is still currently in very early development, please note that we have yet to release an iOS IPA, and our releases may not be up to date with the latest version of our development as we continue to improve our application.

However, if you are a developer looking to test our application, or want to try our the latest version of our 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 to your computer and navigate to it.
• 3. Follow the instructions in the links below to set up an emulator or a physical device to run the application in debug mode:
  • 3.1. Android Setup
  • 3.2. iOS Setup
• 4. Running flutter run will launch Moodsicle on your emulator/device. To install a portable debug version of the application on your physical device, ensure the device is connected and run flutter install.

Development 🛠️

We built Moodsicle with:

• Flutter - Mobile, web and desktop UI SDK framework using Dart.
• Musicovery API - Music recommendation engine.
• Sentiment Dart - Sentiment analysis processing.
• speech_to_text - Speech recognition.
• sqflite - SQL database engine.

We welcome contributors to work on Moodsicle together with us! Feel free to make various improvements as you see fit. Changes will however be subject to approval through pull requests.

Hackathon and Learning Experience ✒️

Visit our project's Devpost to learn more about what we went through in the 24 hours in building Moodsicle!

License 📝

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