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, the Spotify login and optional notifications. Review the settings before saving them. See Setup & First Run for the browser login import and the manual cookie steps.

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, removed or renamed.
• 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.

Common Commands

Use Quick Install & Run above for first-time setup. The table uses PyPI commands. For the manual script equivalents, see Run Individual Commands.

Replace the target placeholders with a complete Spotify profile URL, a spotify:user: URI or a user ID.

Running the tool with no arguments offers the wizard if you have not saved a target. If a target is already saved, it starts monitoring that target.

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

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

For browser profiles, manual cookie extraction, email and webhook setup, see Configuration. For notification choices, listing commands and output files, see Usage.

If a run fails, start with Doctor Preflight.

Documentation

Full documentation is available at misiektoja.github.io/spotify_profile_monitor:

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

Questions, bug reports and vulnerability reports each have a place, listed in SUPPORT.md.

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