• v3.4 21416807a7

    v3.4 Stable

    kerem released this 2026-02-23 03:46:43 +03:00 | 8 commits to main since this release

    📅 Originally published on GitHub: Mon, 23 Feb 2026 00:58:23 GMT
    🏷️ Git tag created: Mon, 23 Feb 2026 00:46:43 GMT

    Features and Improvements:

    • NEW: Added --export-all-playlists flag to export all user's playlists to individual CSV files (named after the playlist) when using -i / --show-user-profile mode (requires pathvalidate library) (thanks @tomballgithub)
    • IMPROVE: Added graceful handling for playlists visible in user's profile, but returning 404 while getting its details (marked as [ RESTRICTED ], applies mainly for Spotify-curated playlists, closes #36)
    • NEW: Added debug mode with DEBUG_MODE config option and --debug CLI flag for technical troubleshooting output

    Bug fixes:

    • BUGFIX: Capped server-provided Retry-After for HTTP 429 responses to avoid long hangs
    • BUGFIX: Fixed fetching of TOTP secrets so it happens before retries
    Downloads
  • v3.3 30955abbbf

    v3.3 Stable

    kerem released this 2026-02-07 20:51:01 +03:00 | 37 commits to main since this release

    📅 Originally published on GitHub: Sat, 07 Feb 2026 18:00:08 GMT
    🏷️ Git tag created: Sat, 07 Feb 2026 17:51:01 GMT

    Features and Improvements:

    • IMPROVE: Implemented API endpoints adaptability to handle Spotify API changes scheduled for February 11, 2026 (token validation, user removal scraping, graceful follower count degradation, playlist handling to support new items field naming)

    Breaking changes:

    • BREAKING: Starting February 11, 2026, oauth_app alone will no longer work for monitoring users (Spotify is removing GET /users/{id} endpoint) - use cookie or client method instead
    • BREAKING: Starting February 11, 2026, oauth_user will no longer work for monitoring other users (Spotify is removing the GET /users/{id} endpoint). Self-monitoring your own account via oauth_user remains fully functional. For monitoring others, use the cookie or client method instead.
    • BREAKING: Starting March 9, 2026, oauth_user mode will require the authorized user to have a Spotify Premium account
    Downloads
  • v3.2 bc50e938ff

    v3.2 Stable

    kerem released this 2026-02-06 18:22:03 +03:00 | 43 commits to main since this release

    📅 Originally published on GitHub: Fri, 06 Feb 2026 15:30:43 GMT
    🏷️ Git tag created: Fri, 06 Feb 2026 15:22:03 GMT

    Features and Improvements:

    • NEW: Implemented playlist change retry mechanism to address occasional Spotify API glitches returning incomplete/empty playlists list; see PLAYLISTS_CHANGE_COUNTER config option (closes #31)
    • IMPROVE: Enhanced --generate-config to support writing directly to a file (e.g. spotify_profile_monitor --generate-config spotify_profile_monitor.conf). This avoids UTF-16 encoding issues on Windows PowerShell
    • IMPROVE: Expanded tabs to spaces in output log files to ensure consistent alignment across different viewers
    • IMPROVE: Enhanced error handling for empty or malformed secret files

    Bug fixes:

    • BUGFIX: Updated old collaborator state when reverting to baseline to ensure notification suppression (fixes #32)
    • BUGFIX: Suppressed collaborator notification for transient glitches when reverting to stable baseline (fixes #30)
    Downloads
  • v3.1 bf03265fbb

    v3.1 Stable

    kerem released this 2025-12-27 20:36:56 +03:00 | 67 commits to main since this release

    📅 Originally published on GitHub: Sat, 27 Dec 2025 17:55:17 GMT
    🏷️ Git tag created: Sat, 27 Dec 2025 17:36:56 GMT

    Features and Improvements:

    • NEW: Implemented hybrid authentication approach when using cookie/client methods by using secondary client credentials OAuth flow (oauth_app) for playlist/user API calls to address restrictions introduced by Spotify on 22 Dec 2025

    Bug fixes:

    • BUGFIX: Removed old TOTP versions from SECRET_CIPHER_DICT
    • BUGFIX: Updated TOTP version handling in refresh_access_token_from_sp_dc function to dynamically use the latest version and remove old TOTP versions from SECRET_CIPHER_DICT

    Breaking changes:

    • BREAKING: Removed token owner display at startup due to /v1/me endpoint limitations introduced by Spotify on 22 Dec 2025
    • BREAKING: OAuth app credentials are now required for playlist/user information retrieval when using either cookie or client token source methods
    Downloads
  • v3.0 98b1cee936

    v3.0 Stable

    kerem released this 2025-12-13 20:51:36 +03:00 | 72 commits to main since this release

    📅 Originally published on GitHub: Sat, 13 Dec 2025 17:57:20 GMT
    🏷️ Git tag created: Sat, 13 Dec 2025 17:51:36 GMT

    Features and Improvements:

    • NEW: Implemented HTML formatting for email notifications for better readability
    • IMPROVE: Enhanced notifications for added/removed playlists with detailed information including songs count, duration, creation date and last update date in both console output and email notifications
    • IMPROVE: Added progress bar for playlist processing to provide better visual feedback

    Bug fixes:

    • BUGFIX: Improved handling of transient API issues in collaborator change notifications (#17)
    Downloads
  • v2.9 7c76cb597d

    v2.9 Stable

    kerem released this 2025-11-11 17:21:31 +03:00 | 86 commits to main since this release

    📅 Originally published on GitHub: Tue, 11 Nov 2025 14:47:29 GMT
    🏷️ Git tag created: Tue, 11 Nov 2025 14:21:31 GMT

    Features and Improvements:

    • NEW: Added support for Amazon Music, Deezer and Tidal URLs in console and email outputs
    • NEW: Added support for AZLyrics, Tekstowo.pl, Musixmatch and Lyrics.com lyrics services
    • NEW: Added configuration options to enable/disable music service URLs in console and email outputs (see ENABLE_APPLE_MUSIC_URL, ENABLE_YOUTUBE_MUSIC_URL, ENABLE_AMAZON_MUSIC_URL, ENABLE_DEEZER_URL and ENABLE_TIDAL_URL config options)
    • NEW: Added configuration options to enable/disable lyrics service URLs in console and email outputs (see ENABLE_GENIUS_LYRICS_URL, ENABLE_AZLYRICS_URL, ENABLE_TEKSTOWO_URL, ENABLE_MUSIXMATCH_URL and ENABLE_LYRICS_COM_URL config options)
    Downloads
  • v2.8 cb7d4d3081

    v2.8 Stable

    kerem released this 2025-10-12 19:48:23 +03:00 | 95 commits to main since this release

    📅 Originally published on GitHub: Sun, 12 Oct 2025 17:49:41 GMT
    🏷️ Git tag created: Sun, 12 Oct 2025 16:48:23 GMT

    Features and Improvements:

    • IMPROVE: Added support for loading TOTP secrets from local files via file:// URLs
    • IMPROVE: Updated remote URL in SECRET_CIPHER_DICT_URL
    • IMPROVE: Updated spotify_monitor_secret_grabber to dump secrets in different formats. Choose what you need with the --secret, --secretbytes and --secretdict CLI flags, or go all out with the --all mode to write all secret formats to files like secrets.json, secretBytes.json and secretDict.json (thanks @tomballgithub)
    • IMPROVE: Added multi-arch Docker image build and compose support for spotify_monitor_secret_grabber - more info at 🐳 Secret Key Extraction via Docker
    • IMPROVE: Moved CLEAN_OUTPUT assignment after loading configuration files. Checks that it is used only with -l or -x
    • IMPROVE: Added info to console output when TOTP secrets are fetched from a remote URL or local file

    Bug fixes:

    • BUGFIX: Fixed -l errors if playlist provided is just the ID ((thanks @tomballgithub), fixes #25)
    Downloads
  • v2.7 246085330e

    v2.7 Stable

    kerem released this 2025-07-14 03:45:53 +03:00 | 109 commits to main since this release

    📅 Originally published on GitHub: Mon, 14 Jul 2025 01:00:22 GMT
    🏷️ Git tag created: Mon, 14 Jul 2025 00:45:53 GMT

    Features and Improvements:

    • IMPROVE: Added automatic fetching of secrets used by web-player access token endpoint (cookie mode) while generating TOTP; it avoids manual updates since Spotify started rotating them every two days

    Bug fixes:

    • BUGFIX: Fixed bugs in retry logic and error handling in spotify_get_access_token_from_sp_dc()
    Downloads
  • v2.6.1 10103e1094

    v2.6.1 Stable

    kerem released this 2025-07-10 05:36:27 +03:00 | 116 commits to main since this release

    📅 Originally published on GitHub: Thu, 10 Jul 2025 02:42:38 GMT
    🏷️ Git tag created: Thu, 10 Jul 2025 02:36:27 GMT

    Features and Improvements:

    • IMPROVE: Updated secret cipher bytes used by web-player access token endpoint (cookie mode) to v11 & v12
    • IMPROVE: Moved secret cipher bytes for web-player endpoint to configuration section
    • IMPROVE: Implemented auto-selection of highest cipher version when TOTP_VER is set to 0

    Bug fixes:

    • BUGFIX: Fixed truncation code to handle emojis with an actual width greater than one character (thanks @tomballgithub)
    Downloads
  • v2.6 9fec00166f

    v2.6 Stable

    kerem released this 2025-07-07 05:49:04 +03:00 | 125 commits to main since this release

    📅 Originally published on GitHub: Mon, 07 Jul 2025 03:08:46 GMT
    🏷️ Git tag created: Mon, 07 Jul 2025 02:49:04 GMT

    Features and Improvements:

    • NEW: Added support for manually specifying additional playlists to monitor via the ADD_PLAYLISTS_TO_MONITOR configuration option (thanks @tomballgithub)
    • NEW: Added new config option (TRUNCATE_CHARS) and flag (--truncate) to limit screen line length; set to 999 to auto-detect terminal width (thanks @tomballgithub)
    • IMPROVE: Updated secret cipher bytes used by web-player access token endpoint (cookie mode) to v9 & v10 (thanks @Thereallo1026 for reverse engineering the current secrets)

    Bug fixes:

    • BUGFIX: Fixed missing asterisk on startup screen (thanks @tomballgithub)
    Downloads