SimpleCharts

Technologies:

About the project:

SimpleCharts is a service for viewing statistics of listened tracks, top artists, albums and artists on last.fm in a more informative form.

The project is a website with the following functions:

• registration and authorization of users
• getting information from last.fm user
• saving last.fm user's information to the database
• viewing the songs you've listened to
• viewing top listened tracks per week / month / 3 months / 6 months / year
• viewing top listened artists per week / month / 3 months / 6 months / year
• viewing top listened albums per week / month / 3 months / 6 months / year
• clearing the database to load more recent information

Installing and running the project:

1. Create an account at last.fm (https://www.last.fm/).

2. Create an API account and get API tokens from last.fm API (https://www.last.fm/api/account/create?_pjax=%23content).

3. Install packages from requirements.txt file.

4. Set the environment variable DEBUG (True - for local launch).

5. Add the environment variables API_KEY and API_SECRET received from last.fm API.

6. Add the environment variable DATABASE_URL, indicating the url to the connected database.

7. Add the environment variable lastfm_username according to the name of the account owner of the last.fm API (not necessary).

8. Run the following commands from the directory:

   • Apply migrations

     python manage.py migrate
     

   • Create a superuser for access to project administration

     python manage.py createsuperuser
     

   • Start the local server

     python manage.py runserver