[Under development]

1. Download your Last.fm history with: https://benjaminbenben.com/lastfm-to-csv/
2. Place your CSV file in the data folder.
3. Change your paths and username in setup.
4. Modify the BAN list in the setup file as needed.
5. Create a keys.py file with the following contents:

# Lastfm API Credentials
(API_KEY, SHRD_SECRT) = (API_KEY_STRING, API_SHARED_SECRET_STRING)
AUTH = 'AUTHOR_STRING'
# MusicBrainz agent
(MB_NM, MB_V, MB_URL) = (APP_NAME, APP_VER, APP_HOME)
(MB_USR, MB_PSW) = (MB_USER_STRING, MB_USER_PASSWORD)
# Geolocator
(GEO_USR) = (APP_NAME)

Inspired by: Analyzing Last.fm Listening History by gboeing.

1. Run Lastfm_clean.
2. Run MusicBrainz_download.
3. Download a country or region's SHP file and place it in the gis folder.
4. Run Map_mask.py with the country code.
5. Run Wordcloud_Masked.py with the country code.

### Artist Masked Wordcloud

• setup.py: Paths, username, and 'banned list' settings.
• clean.py: Routines to clean up the database.
• musicBrainz.py: Mixes the database with MB information on genres and geographies.

Héctor M. Sánchez C.