spotify_profile_monitor

Powerful Spotify tool for real-time tracking of profile changes, playlist updates, follower growth, collaborators and more - delivered straight to your terminal, inbox or webhook.

🚀 Quick Install & Run

New to Python or unsure what is installed? Follow the Python install walkthrough first.

Install from PyPI:

pip install spotify_profile_monitor

Run the setup wizard:

spotify_profile_monitor --setup

The wizard asks for the target, authentication, polling interval and optional email or webhook alerts, then offers to run Doctor and start monitoring.

For the manual single-file method, optional extras and upgrade commands, see Installation.

Features

📜 Playlists

• Detect added or removed playlists and tracks.
• Track playlist names, descriptions, likes and collaborators.
• See who added each track to a collaborative playlist.

👤 Profile Changes

• Track username and profile-picture changes.
• See when followers or followed accounts are added or removed.
• View profile details and recently played artists.

🔔 Notifications and History

• Receive alerts in the terminal, by email, through Discord or through ntfy.
• Read coloured terminal output with a customizable theme, while log files stay plain text.
• Keep a timestamped CSV history of profile and playlist changes.
• Include profile pictures and optional playlist or album artwork in notifications.

🔎 Extra Tools

• List or export tracks from playlists and Liked Songs.
• Search for Spotify users by name.
• Open music and lyrics searches across Spotify, YouTube Music, Apple Music, Tidal and other services.
• Use the automatic web-player playlist backend without creating a Spotify developer app.

Common Commands

Use Quick Install & Run above for first-time setup. The table uses PyPI commands. For the manual script equivalents, see Command Format by Installation Method.

I want to...	Run this
Start monitoring with existing authentication	spotify_profile_monitor TARGET, where TARGET is a complete profile URL, spotify:user: URI or user ID
Check dependencies, authentication, connectivity and one target	spotify_profile_monitor --doctor TARGET
Import a Spotify login from a browser	Open Spotify Web Player in the browser, sign in then run spotify_profile_monitor --import-browser-cookie --browser firefox
Enter or replace securely a manually extracted SP_DC_COOKIE	Run spotify_profile_monitor --set-sp-dc and enter sp_dc at the hidden prompt
Show profile details, followers, followings and playlist statistics	spotify_profile_monitor TARGET -i
Display or export the tracks of one playlist	spotify_profile_monitor -l PLAYLIST_URL -b tracks.csv
Find a Spotify user ID by name	spotify_profile_monitor -s "user name"
Configure and test webhook alerts	Use the setup wizard or follow Webhook Settings

For authentication, token sources, targets and notification setup, see the full Setup & First Run guide.

✨ If you want to track Spotify friends' music activity, check out another tool I developed: spotify_monitor.

🛠️ For Spotify Web Player token and secret-key utilities, see Debugging Tools.