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.

✨ 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.

Before Monitoring

For manual setup you need two values:

1. A Spotify target for the person you want to monitor. The easiest form is the complete profile URL copied from Spotify. A spotify:user: URI or bare user ID is also accepted. See How to Find a Friend's Spotify Profile URL.
2. The sp_dc login cookie from the Spotify account used for monitoring. Import it from a signed-in browser with spotify_profile_monitor --import-browser-cookie --browser firefox or follow the manual cookie extraction steps. Treat this value like a password.

It is strongly recommended to use a separate Spotify account with this tool, because cookie and desktop-client access rely on internal undocumented Spotify endpoints. See Spotify access token source for all four token methods and their limitations.

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.

The tool runs until interrupted (Ctrl+C). Use tmux or screen for persistence, and run multiple copies to monitor several users.

Documentation

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 --doctor self-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

Change Log

See RELEASE_NOTES.md for details.

Contributing

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.

Security

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.

Maintainers

• misiektoja (@misiektoja)
• tomballgithub (@tomballgithub)

License

Licensed under GPLv3. See LICENSE. Dependency licenses are listed in THIRD_PARTY_NOTICES.md.

Support

If the project is useful to you, you can support its development through GitHub Sponsors or Buy Me a Coffee.