Collection of VocaDB related scripts.

Uses VDBpy under the hood.

Ideas, Pull Requests, etc. are welcome.

Scripts

(AT) Artist tag scripts

• AT_calculate_artist_tags_based_on_songs.py Find the most common tags for the artist based on artist's song entries
• AT_calculate_most_relevant_artists_by_a_tag.py Find the most relevant artists for a given tag based on all the tagged songs (slow)
• AT_verify_tagged_artists.py Verify if tagged artists have tagged songs

(G) Graph generators

Generate interactive graphs with Plotly based on monthly counts:

• G_monthly_comments.py
• G_monthly_edits.py
• G_monthly_users.py

Monthly counts are cached indefinitely, which enables quick regeneration.

Generated graphs are displayed in a browser window (localhost).

• G_rated_songs_by_user.py generates 2 graphs (monthly publish & rating date), cached for 7 days

(U) User tools

• U_export_dms.py Export DMs as markdown files
• U_export_rated_song_entries_as_csv.py
• U_notifications_to_songlist.py Turn song notifications into a songlist

(US) User statistics

(7d cached data)

• US_find_favourite_albums.py
• US_find_favourite_producers.py
• US_find_favourite_vocalists.py

Screenshots

Usage

1. Install Git --> git clone https://github.com/Shiroizu/VocaDB-scripts (or download ZIP & extract)

2. cd VocaDB-scripts

3. Install uv

4. uv run G_monthly_comments.py