Skip to content

Commit

Permalink
Updated the Read Me
Browse files Browse the repository at this point in the history
  • Loading branch information
eniteCZ authored Dec 8, 2022
1 parent 513edc9 commit 57a002f
Showing 1 changed file with 32 additions and 5 deletions.
37 changes: 32 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,33 @@
# This is your readme
You are required to fill it in with documentation similar to that found in the Sequelize example for the course as part of your final project.
# Music: New Horizons
This is an INST377 final project website by Filip Radmanovic and Minghan Cai. Please visit our webpage at:

https://mingc98.github.io/Group102-01-Final-Project-Music-NewHorizon/index.html

## Broad description
While using spotify most of us search for a song we know and listen to and then either choose a playlist with what is already know or we let the algorithm take the reigns and play songs for us based on our known preferences.

The intent of the project is to provide the user with song suggestions for a particular genre that have not been generated based on their preferences, thus broadening their musical horizon. When a user selects a genre and presses the button, we show a list of 9 randomly selected songs along with the links to them on Spotify, a galery of their album covers and a chart of their length. Once a user has picked a song they can click on the link which will tak them to spotify web page where they can listen to it.



## Usage manual
This page should work on all mainstram browsers on mobile and fixed divices.

* First when you open the page, it will load a selection of genres to the dropdown menu prompting you to select a genre
* Once you have selected a genre give the page a second to retrieve a list of songs
* Then press the "Broaden my horizon" button
* You can look at the names of the songs and select whichever you like best, you will be redirected to spotify where you can listen to it.
* If you want to know more about us, please visit the "About us" link at the bottom of the page.


## API
We are using the Spotify API. For details please refer to the official documentation:

https://developer.spotify.com/documentation/web-api/

## Visualizations
We use 2 visualizations in this project:
* An image galery of album covers handled internaly by our code.
* A chart of song lengths using the chart.js library


### How to use Markdown
Markdown is a text notation system used in Discord, Whatsapp and similar to structure pages without writing HTML at all. You'll be using it for your documentation.
* [Markdown guide](https://www.markdownguide.org/cheat-sheet/)

0 comments on commit 57a002f

Please sign in to comment.