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.
New to Python or unsure what is installed? Follow the Python install walkthrough first.
Install from PyPI:
pip install spotify_profile_monitorRun the setup wizard:
spotify_profile_monitor --setupThe 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.
- Detect added or removed playlists and tracks.
- Track playlist names, descriptions, likes and collaborators.
- See who added each track to a collaborative playlist.
- Track username and profile-picture changes.
- See when followers or followed accounts are added or removed.
- View profile details and recently played artists.
- 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.
- 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.
✨ 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.
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 |
| List every supported command-line flag | spotify_profile_monitor --help |
The tool runs until interrupted (Ctrl+C). Use tmux or screen for persistence, and run multiple copies to monitor several users.
Full documentation is available at misiektoja.github.io/spotify_profile_monitor:
- Installation - requirements, PyPI, manual script and upgrades
- Setup & First Run - setup wizard, browser cookie import and first run
- Configuration - config file, token sources, targets, time zone, SMTP, webhooks and secrets
- Usage - monitoring, listing, notifications, CSV export, blacklisting, intervals and signals
- Troubleshooting - the
--doctorself-check, logging levels and common problems - Debugging Tools - TOTP token testing and secret key extraction
- Testing - the offline suite, CI jobs and supply chain checks
See RELEASE_NOTES.md for details.
Bug reports, documentation fixes and code contributions are welcome. See CONTRIBUTING.md for the development setup, the checks CI enforces and what a change needs before it is merged. Participation is covered by the Code of Conduct.
Report a suspected vulnerability privately through GitHub security advisories, never as a public issue. SECURITY.md covers the reporting process, the supported versions and the security posture of stored secrets, configuration loading and untrusted Spotify text.
- misiektoja (@misiektoja)
- tomballgithub (@tomballgithub)
Licensed under GPLv3. See LICENSE. Dependency licenses are listed in THIRD_PARTY_NOTICES.md.
If the project is useful to you, you can support its development through GitHub Sponsors or Buy Me a Coffee.