InTune Application

Original link:

https://github.com/anzaruoft/MusicIntelliJence.git

Authors:

Anzar Alvi (anzaruoft), Hugo Hudson (hudsonhu22), Maryam Hassan (maryamhassan1), Benjamin Konishi (PromiscuousSquirrel).

Table of Contents:

1. Introduction
2. Features
3. User Stories
4. Installation Instructions
5. Usage Guide
6. Feedback
7. Contributions

Project Description:

InTune is a music-focused application designed for music enthusiasts, particularly teenagers and young adults. It integrates with Spotify to allow users to discover songs, rate music, and view other friends ratings and profiles.

Features:

• Spotify Api Integration: - Search for Songs via Spotify.
• Music Rating System: Rate and review songs on a scale of 1-5, and add an optional comment.
• Observe other people's profiles.
• Personalize the experience with options for password management.

User Stories:

1. Maryam listens to a song she hasn’t heard in a long time, and she remembers rating it on INTUNE a while back. She wants to see what her old rating was before she makes an opinion, she opens the app, logs in and realizes it took her awhile to remember her password! She changes her password, relogs back in, and checks to see her old rating on her feed. None of her friends have rated any songs, so they dont show up on the feed.

2. Hugo is looking for new songs to listen to, but he does not want to listen to a bad one. He cannot remember the songs he used to like, so he goes on his own profile, and views his past top songs to find something to jam out to. Hugo also views his lists of his friends, but he has none!

3. Anzar loves this new song released by a Spotify artist and he wants to support him. He opens up the application and searches the song up by pressing "+" on the main page of the application, then searching for the song. He then leaves a great rating and comment on the song!

4. Benny overhears Greg and Darnell laughing about their funny InTune usernames at Church. Benny really likes Darnell's username and wants to check that Darnell's username is taken on the InTune app. He quickly writes down the username and clicks the profile search button ins the InTune feed page, and types in Darnell's username. Benny was very happy to find that the username was not taken.

Installation Instructions:

1. Clone the Repository.
2. Install Dependencies.
3. Run the Application.
4. Make sure Server works
5. Make sure Spotify API works.

Usage Guides:

Technical Requirements:

• OS
• Dependencies: ensure all required libraries are Common Technicalities:
• Make sure you are connected to a valid Spotify Account.
• Missing Dependencies: please ensure all dependencies required for the program are installed by running pom.xml.

How to use:

1. Log in: enter username and password, then press Username. Takes you to the Feed page.
2. Search for Songs" Click the "Rate" button, enter the song name, and then rate and add a comment.
3. Change Password: Click on the "Change Password" button, re-enter your new password, and log out. Log in with your new password.
4. Search for other profiles:

Feedback:

We encourage constructive criticism! Rules for feedback:

1. Be nice, respectful, with no hurtful comments. Bullying will not be tolerated.
2. Provide instructions and steps to fix any bugs. What to Expect:
3. 5 business days for acknowledgement.
4. 10 business days if feedback gets resolved.

Contributions:

We encourage and welcome contributions from software developer. In order to contribute:

1. Fork the Repository - creating your own copy.
2. Submit a Pull request - describe changes and add documentation.
3. Review Process - It will take 10 business days to allow for a minimum of 2 team members to review the pull request.