This app provides a personalized, interactive experience of your Spotify music listening habits. By logging into your Spotify account, you can access a colorful and detailed presentation of your music tastes. Built to capture the spirit of Spotify's annual "Wrapped" feature, this app offers flexibility, customization, and social sharing options to create a fun and engaging experience year-round.
- View creative, detailed summaries of your listening habits, generated from your Spotify account data.
- Utilize an LLM API to dynamically describe the lifestyle and preferences associated with your music taste. Compare this personalized insight with a friend's during a Duo-Wrapped session.
- Customize your experience with options like toggling dark mode and changing notification preferences. Manage your account, save past Spotify Wrapped summaries, update login information, or delete your account if needed.
- Search for friends and view what they’re currently listening to. Profiles are sorted alphabetically, and you can view a friend’s top tracks by tapping on their profile.
- Play a fun quiz game where you identify artists based on their images, extracted from the Spotify API. Compete against the clock with each question timed to 10 seconds, and track your high scores.
To run this app locally, follow these steps:
-
Clone the Repository:
git clone https://github.com/username/repository-name.git
-
Open the Project in Android Studio:
- Open Android Studio.
- Select File > Open.
- Navigate to the project directory and select it to open.
-
Install Dependencies:
- Android Studio should automatically sync and install necessary dependencies. If not, go to File > Sync Project with Gradle Files.
-
Set Up Spotify API Credentials:
- Create a
local.propertiesfile in the root of the project (if it doesn’t already exist). - Add your Spotify API credentials to a
.envfile (or directly in your code if configured) and reference it appropriately in your codebase.SPOTIFY_CLIENT_ID=your_client_id SPOTIFY_CLIENT_SECRET=your_client_secret
- Create a
-
Run the App:
- Select an Android emulator or connect a physical device.
- Click the Run button (green play icon) in the toolbar, or select Run > Run 'app' from the menu.
- Android Studio will build and deploy the app to your selected device or emulator.
-
Login with Spotify:
- Once the app is running on your device, you can log in with your Spotify account to explore the features.
If you'd like to contribute, feel free to open a pull request. We welcome bug fixes, feature requests, and other improvements.
all designs are done in figma