This Music Search & Recommendation system offers different functionalities to search among songs and artists and get recommendations based on genre. This application is mainly aimed for private users, who wish to discover new songs and artists, according to their preferences. However this service could be also used with the purpose of advertisement. For example, some external commercial web-app (e.g. music-industry executive companies) could integrate the service provided by this system, to analyze what people like most, and change their strategies accordingly.
SQLite is used to store data. The data can be found in the folder db (Python sqlite3). The project has been built using Python; the backend relies on the Flask-RESTful framework.
To run the project (both client and server), from the main folder (path/musicfinder/), it's sufficient to run the command:
python musicfinder.py
Once the server has started, the log message "Running on http://localhost:5000" will appear, and it will be possible to interact with the web-page at the following URL:
To test the database API for the artists resource use the following command from the main folder
python -m test.database_api_tests_artists
To test the database API for the songs resource use the following command from the main folder:
python -m test.database_api_tests_songs
To test the database API for the user's resource use the following command from the main folder:
python -m test.database_api_tests_user
To test the user REST-ful API use the following command from the main folder:
python -m test.musicfinder_api_tests
The GUI uses the library JQuery (v 1.11.2), that can be found in the folder musicfinder/musicfinder_admin/static/. The GUI uses the framework Bootstrap (v 3.3.4) located in the folder musicfinder/musicfinder_admin/static/bootstrap (the folder contains the css, fonts and javascript functions in the relative sub-folders). unittest was used for testing .
-
ENTRYPOINT = /musicfinder/api/
-
Artists = /musicfinder/api/artists/
-
Artist = /musicfinder/api/artists/artist_name/
-
Songs = /musicfinder/api/artists/artist_name/songs/
-
Song = /musicfinder/api/artists/artist_name/songs/song_title
-
Users = /musicfinder/api/users/
-
User = /musicfinder/api/users/user_name/
-
User_playlists = /musicfinder/api/users/user_name/playlists/
-
Playlist = /musicfinder/api/users/user_name/playlists/playlist_title/
-
Playlist_songs = /musicfinder/api/users/user_name/playlists/playlist_title/songs/
