spotify-profile-monitor 3.1__tar.gz → 3.2__tar.gz

{spotify_profile_monitor-3.1/spotify_profile_monitor.egg-info → spotify_profile_monitor-3.2}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: spotify_profile_monitor
-Version: 3.1
-Summary: Tool implementing real-time tracking of Spotify users activities and profile changes including playlists
+Version: 3.2
+Summary: Track Spotify profile, follower and playlist changes in real time
 Author-email: Michal Szymanski <misiektoja-pypi@rm-rf.ninja>
 License-Expression: GPL-3.0-or-later
 Project-URL: Homepage, https://github.com/misiektoja/spotify_profile_monitor
@@ -9,6 +9,15 @@ Project-URL: Source, https://github.com/misiektoja/spotify_profile_monitor
 Project-URL: Changelog, https://github.com/misiektoja/spotify_profile_monitor/blob/main/RELEASE_NOTES.md
 Keywords: spotify,monitoring,tracking,real-time,playlists,osint
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: POSIX :: Linux
@@ -29,38 +38,61 @@ Dynamic: license-file
 
 # spotify_profile_monitor
 
-OSINT tool for real-time monitoring of **Spotify users' activities and profile changes including playlists**.
+<p align="left">
+  <img src="https://img.shields.io/github/v/release/misiektoja/spotify_profile_monitor?style=flat-square&color=blue" alt="GitHub Release" />
+  <img src="https://img.shields.io/pypi/v/spotify_profile_monitor?style=flat-square&color=teal" alt="PyPI Version" />
+  <img src="https://img.shields.io/github/stars/misiektoja/spotify_profile_monitor?style=flat-square&color=magenta" alt="GitHub Stars" />
+  <img src="https://img.shields.io/badge/python-3.6+-blueviolet?style=flat-square" alt="Python Versions" />
+  <img src="https://img.shields.io/github/license/misiektoja/spotify_profile_monitor?style=flat-square&color=blue" alt="License" />
+  <img src="https://img.shields.io/github/last-commit/misiektoja/spotify_profile_monitor?style=flat-square&color=green" alt="Last Commit" />
+  <img src="https://img.shields.io/badge/maintenance-active-brightgreen?style=flat-square" alt="Maintenance" />
+</p>
 
-✨ If you want to track Spotify friends' music activity, check out another tool I developed: [spotify_monitor](https://github.com/misiektoja/spotify_monitor).
+Powerful Spotify tool for real-time tracking of profile changes, playlist updates, follower growth, collaborators and more - delivered straight to your terminal or inbox.
 
-🛠️ If you're looking for debug tools to get Spotify Web Player access tokens and extract secret keys: [click here](#debugging-tools)
+### 🚀 Quick Install
+```sh
+pip install spotify_profile_monitor
+```
+
+<p align="center">
+   <img src="https://raw.githubusercontent.com/misiektoja/spotify_profile_monitor/refs/heads/main/assets/spotify_profile_monitor.png" alt="spotify_profile_monitor_screenshot" width="90%"/>
+</p>
 
 <a id="features"></a>
 ## Features
 
-- **Real-time tracking** of Spotify user activities and profile changes:
-   - addition/removal of **followings and followers**
-   - addition/removal of **playlists**
-   - addition/removal of **tracks in playlists** (including collaborator info for newly added tracks)
-   - **playlists name and description** changes
-   - **number of likes** for playlists
-   - **number of collaborators** for playlists
-   - **profile picture** changes
-   - **username** changes
-- **Email notifications** for various events (as listed above)
-- **Attaching changed profile pictures** directly to email notifications
-- **Displaying the profile picture** right in your terminal (if you have `imgcat` installed)
-- Additional functionalities on top of the monitoring mode allowing to display **detailed info about the user**, **list of followers & followings**, **recently played artists** and possibility to **search for users** in Spotify catalog with specific names
-- Ability to **display and export** the list of tracks for a specific playlist (including **Liked Songs** for the user who owns the Spotify access token)
-- **Saving all profile changes** (including playlists) with timestamps to the **CSV file**
-- **Clickable** **Spotify**, **Apple Music**, **YouTube Music**, **Amazon Music**, **Deezer**, **Tidal**, **Genius Lyrics**, **AZLyrics**, **Tekstowo.pl**, **Musixmatch** and **Lyrics.com** search URLs printed in the console and included in email notifications (configurable per service)
-- Support for **hybrid authentication approach** to get a **Spotify access token** (`sp_dc cookie`/`desktop client` + `OAuth app`, or standalone `OAuth app`/`OAuth user`)
-- Possibility to **control the running copy** of the script via signals
-- **Functional, procedural Python** (minimal OOP)
+### 👤 Profile Monitoring
+- **Real-time tracking**: Monitor Spotify user activities and profile changes.
+- **Social Network**: Detect addition/removal of **followings** and **followers**.
+- **Identity Changes**: Track **profile picture** and **username** changes.
+
+### 📜 Playlist Tracking
+- **Content Updates**: Monitor addition/removal of **tracks in playlists**.
+- **Collaborator Info**: Identify who added which track in **collaborative playlists**.
+- **Social Proof**: Monitor **likes** and **collaborators** count for playlists.
+- **Metadata**: Track **name** and **description** changes.
+
+### 📊 Advanced Tools
+- **Deep Insights**: Display detailed info about users, followers and followings.
+- **Historical Data**: View **recently played artists** and **search for users** by name.
+- **Export Power**: Display and export tracks from any playlist (including **Liked Songs**).
+- **Global Search**: Instant links to **Spotify, YouTube Music, Apple Music, Tidal, lyrics** and more.
+
+### 🔔 Smart Interactions
+- **Instant Alerts**: Detailed **Email notifications** for all profile and playlist changes.
+- **Visual Reports**: Attach changed profile pictures directly to emails.
+- **Terminal Graphics**: Display profile pictures right in your terminal (via `imgcat`).
+
+### ⚙️ Power Features
+- **Auth Flexibility**: Hybrid support for `sp_dc` cookie, Desktop Client and OAuth.
+- **CSV Logging**: Save all changes with full timestamps to a CSV file.
+- **Flexible Config**: Support for files, dotenv and environment variables.
+- **Signal Control**: Manage the running script via system signals (`SIGHUP`, `USR1`, etc.).
 
-<p align="center">
-   <img src="https://raw.githubusercontent.com/misiektoja/spotify_profile_monitor/refs/heads/main/assets/spotify_profile_monitor.png" alt="spotify_profile_monitor_screenshot" width="100%"/>
-</p>
+✨ If you want to track Spotify friends' music activity, check out another tool I developed: [spotify_monitor](https://github.com/misiektoja/spotify_monitor).
+
+🛠️ If you're looking for debug tools to get Spotify Web Player access tokens and extract secret keys: [click here](#debugging-tools)
 
 <a id="table-of-contents"></a>
 ## Table of Contents
@@ -185,10 +217,15 @@ Most settings can be configured via command-line arguments.
 If you want to have it stored persistently, generate a default config template and save it to a file named `spotify_profile_monitor.conf`:
 
 ```sh
+# On macOS, Linux or Windows Command Prompt (cmd.exe)
 spotify_profile_monitor --generate-config > spotify_profile_monitor.conf
 
+# On Windows PowerShell (recommended to avoid encoding issues)
+spotify_profile_monitor --generate-config spotify_profile_monitor.conf
 ```
 
+> **IMPORTANT**: On **Windows PowerShell**, using redirection (`>`) can cause the file to be encoded in UTF-16, which will lead to "null bytes" errors when running the tool. It is highly recommended to provide the filename directly as an argument to `--generate-config` to ensure UTF-8 encoding.
+
 Edit the `spotify_profile_monitor.conf` file and change any desired configuration options (detailed comments are provided for each).
 
 **New in v3.1:** The tool now uses a hybrid authentication approach. OAuth app credentials (`SP_APP_CLIENT_ID`, `SP_APP_CLIENT_SECRET`) are required for playlist and user information retrieval when using either `cookie` or `client` token source methods. See [Spotify OAuth App](#spotify-oauth-app) section for setup instructions.

spotify_profile_monitor-3.1/PKG-INFO → spotify_profile_monitor-3.2/README.md

@@ -1,66 +1,60 @@
-Metadata-Version: 2.4
-Name: spotify_profile_monitor
-Version: 3.1
-Summary: Tool implementing real-time tracking of Spotify users activities and profile changes including playlists
-Author-email: Michal Szymanski <misiektoja-pypi@rm-rf.ninja>
-License-Expression: GPL-3.0-or-later
-Project-URL: Homepage, https://github.com/misiektoja/spotify_profile_monitor
-Project-URL: Source, https://github.com/misiektoja/spotify_profile_monitor
-Project-URL: Changelog, https://github.com/misiektoja/spotify_profile_monitor/blob/main/RELEASE_NOTES.md
-Keywords: spotify,monitoring,tracking,real-time,playlists,osint
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Classifier: Operating System :: Microsoft :: Windows
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Operating System :: MacOS :: MacOS X
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests>=2.0
-Requires-Dist: python-dateutil>=2.8
-Requires-Dist: urllib3>=2.0.7
-Requires-Dist: pyotp>=2.9.0
-Requires-Dist: pytz>=2020.1
-Requires-Dist: tzlocal>=4.0
-Requires-Dist: python-dotenv>=0.19
-Requires-Dist: spotipy>=2.24.0
-Requires-Dist: wcwidth>=0.2.7
-Dynamic: license-file
-
 # spotify_profile_monitor
 
-OSINT tool for real-time monitoring of **Spotify users' activities and profile changes including playlists**.
+<p align="left">
+  <img src="https://img.shields.io/github/v/release/misiektoja/spotify_profile_monitor?style=flat-square&color=blue" alt="GitHub Release" />
+  <img src="https://img.shields.io/pypi/v/spotify_profile_monitor?style=flat-square&color=teal" alt="PyPI Version" />
+  <img src="https://img.shields.io/github/stars/misiektoja/spotify_profile_monitor?style=flat-square&color=magenta" alt="GitHub Stars" />
+  <img src="https://img.shields.io/badge/python-3.6+-blueviolet?style=flat-square" alt="Python Versions" />
+  <img src="https://img.shields.io/github/license/misiektoja/spotify_profile_monitor?style=flat-square&color=blue" alt="License" />
+  <img src="https://img.shields.io/github/last-commit/misiektoja/spotify_profile_monitor?style=flat-square&color=green" alt="Last Commit" />
+  <img src="https://img.shields.io/badge/maintenance-active-brightgreen?style=flat-square" alt="Maintenance" />
+</p>
 
-✨ If you want to track Spotify friends' music activity, check out another tool I developed: [spotify_monitor](https://github.com/misiektoja/spotify_monitor).
+Powerful Spotify tool for real-time tracking of profile changes, playlist updates, follower growth, collaborators and more - delivered straight to your terminal or inbox.
 
-🛠️ If you're looking for debug tools to get Spotify Web Player access tokens and extract secret keys: [click here](#debugging-tools)
+### 🚀 Quick Install
+```sh
+pip install spotify_profile_monitor
+```
+
+<p align="center">
+   <img src="https://raw.githubusercontent.com/misiektoja/spotify_profile_monitor/refs/heads/main/assets/spotify_profile_monitor.png" alt="spotify_profile_monitor_screenshot" width="90%"/>
+</p>
 
 <a id="features"></a>
 ## Features
 
-- **Real-time tracking** of Spotify user activities and profile changes:
-   - addition/removal of **followings and followers**
-   - addition/removal of **playlists**
-   - addition/removal of **tracks in playlists** (including collaborator info for newly added tracks)
-   - **playlists name and description** changes
-   - **number of likes** for playlists
-   - **number of collaborators** for playlists
-   - **profile picture** changes
-   - **username** changes
-- **Email notifications** for various events (as listed above)
-- **Attaching changed profile pictures** directly to email notifications
-- **Displaying the profile picture** right in your terminal (if you have `imgcat` installed)
-- Additional functionalities on top of the monitoring mode allowing to display **detailed info about the user**, **list of followers & followings**, **recently played artists** and possibility to **search for users** in Spotify catalog with specific names
-- Ability to **display and export** the list of tracks for a specific playlist (including **Liked Songs** for the user who owns the Spotify access token)
-- **Saving all profile changes** (including playlists) with timestamps to the **CSV file**
-- **Clickable** **Spotify**, **Apple Music**, **YouTube Music**, **Amazon Music**, **Deezer**, **Tidal**, **Genius Lyrics**, **AZLyrics**, **Tekstowo.pl**, **Musixmatch** and **Lyrics.com** search URLs printed in the console and included in email notifications (configurable per service)
-- Support for **hybrid authentication approach** to get a **Spotify access token** (`sp_dc cookie`/`desktop client` + `OAuth app`, or standalone `OAuth app`/`OAuth user`)
-- Possibility to **control the running copy** of the script via signals
-- **Functional, procedural Python** (minimal OOP)
+### 👤 Profile Monitoring
+- **Real-time tracking**: Monitor Spotify user activities and profile changes.
+- **Social Network**: Detect addition/removal of **followings** and **followers**.
+- **Identity Changes**: Track **profile picture** and **username** changes.
+
+### 📜 Playlist Tracking
+- **Content Updates**: Monitor addition/removal of **tracks in playlists**.
+- **Collaborator Info**: Identify who added which track in **collaborative playlists**.
+- **Social Proof**: Monitor **likes** and **collaborators** count for playlists.
+- **Metadata**: Track **name** and **description** changes.
+
+### 📊 Advanced Tools
+- **Deep Insights**: Display detailed info about users, followers and followings.
+- **Historical Data**: View **recently played artists** and **search for users** by name.
+- **Export Power**: Display and export tracks from any playlist (including **Liked Songs**).
+- **Global Search**: Instant links to **Spotify, YouTube Music, Apple Music, Tidal, lyrics** and more.
+
+### 🔔 Smart Interactions
+- **Instant Alerts**: Detailed **Email notifications** for all profile and playlist changes.
+- **Visual Reports**: Attach changed profile pictures directly to emails.
+- **Terminal Graphics**: Display profile pictures right in your terminal (via `imgcat`).
+
+### ⚙️ Power Features
+- **Auth Flexibility**: Hybrid support for `sp_dc` cookie, Desktop Client and OAuth.
+- **CSV Logging**: Save all changes with full timestamps to a CSV file.
+- **Flexible Config**: Support for files, dotenv and environment variables.
+- **Signal Control**: Manage the running script via system signals (`SIGHUP`, `USR1`, etc.).
 
-<p align="center">
-   <img src="https://raw.githubusercontent.com/misiektoja/spotify_profile_monitor/refs/heads/main/assets/spotify_profile_monitor.png" alt="spotify_profile_monitor_screenshot" width="100%"/>
-</p>
+✨ If you want to track Spotify friends' music activity, check out another tool I developed: [spotify_monitor](https://github.com/misiektoja/spotify_monitor).
+
+🛠️ If you're looking for debug tools to get Spotify Web Player access tokens and extract secret keys: [click here](#debugging-tools)
 
 <a id="table-of-contents"></a>
 ## Table of Contents
@@ -185,10 +179,15 @@ Most settings can be configured via command-line arguments.
 If you want to have it stored persistently, generate a default config template and save it to a file named `spotify_profile_monitor.conf`:
 
 ```sh
+# On macOS, Linux or Windows Command Prompt (cmd.exe)
 spotify_profile_monitor --generate-config > spotify_profile_monitor.conf
 
+# On Windows PowerShell (recommended to avoid encoding issues)
+spotify_profile_monitor --generate-config spotify_profile_monitor.conf
 ```
 
+> **IMPORTANT**: On **Windows PowerShell**, using redirection (`>`) can cause the file to be encoded in UTF-16, which will lead to "null bytes" errors when running the tool. It is highly recommended to provide the filename directly as an argument to `--generate-config` to ensure UTF-8 encoding.
+
 Edit the `spotify_profile_monitor.conf` file and change any desired configuration options (detailed comments are provided for each).
 
 **New in v3.1:** The tool now uses a hybrid authentication approach. OAuth app credentials (`SP_APP_CLIENT_ID`, `SP_APP_CLIENT_SECRET`) are required for playlist and user information retrieval when using either `cookie` or `client` token source methods. See [Spotify OAuth App](#spotify-oauth-app) section for setup instructions.

{spotify_profile_monitor-3.1 → spotify_profile_monitor-3.2}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "spotify_profile_monitor"
-version = "3.1"
-description = "Tool implementing real-time tracking of Spotify users activities and profile changes including playlists"
+version = "3.2"
+description = "Track Spotify profile, follower and playlist changes in real time"
 readme = "README.md"
 license = "GPL-3.0-or-later"
 license-files = ["LICEN[CS]E*"]
@@ -24,6 +24,15 @@ dependencies = [
 ]
 classifiers = [
   "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.6",
+  "Programming Language :: Python :: 3.7",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Operating System :: OS Independent",
   "Operating System :: Microsoft :: Windows",
   "Operating System :: POSIX :: Linux",

spotify_profile_monitor-3.1/README.md → spotify_profile_monitor-3.2/spotify_profile_monitor.egg-info/PKG-INFO

@@ -1,37 +1,98 @@
+Metadata-Version: 2.4
+Name: spotify_profile_monitor
+Version: 3.2
+Summary: Track Spotify profile, follower and playlist changes in real time
+Author-email: Michal Szymanski <misiektoja-pypi@rm-rf.ninja>
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://github.com/misiektoja/spotify_profile_monitor
+Project-URL: Source, https://github.com/misiektoja/spotify_profile_monitor
+Project-URL: Changelog, https://github.com/misiektoja/spotify_profile_monitor/blob/main/RELEASE_NOTES.md
+Keywords: spotify,monitoring,tracking,real-time,playlists,osint
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.0
+Requires-Dist: python-dateutil>=2.8
+Requires-Dist: urllib3>=2.0.7
+Requires-Dist: pyotp>=2.9.0
+Requires-Dist: pytz>=2020.1
+Requires-Dist: tzlocal>=4.0
+Requires-Dist: python-dotenv>=0.19
+Requires-Dist: spotipy>=2.24.0
+Requires-Dist: wcwidth>=0.2.7
+Dynamic: license-file
+
 # spotify_profile_monitor
 
-OSINT tool for real-time monitoring of **Spotify users' activities and profile changes including playlists**.
+<p align="left">
+  <img src="https://img.shields.io/github/v/release/misiektoja/spotify_profile_monitor?style=flat-square&color=blue" alt="GitHub Release" />
+  <img src="https://img.shields.io/pypi/v/spotify_profile_monitor?style=flat-square&color=teal" alt="PyPI Version" />
+  <img src="https://img.shields.io/github/stars/misiektoja/spotify_profile_monitor?style=flat-square&color=magenta" alt="GitHub Stars" />
+  <img src="https://img.shields.io/badge/python-3.6+-blueviolet?style=flat-square" alt="Python Versions" />
+  <img src="https://img.shields.io/github/license/misiektoja/spotify_profile_monitor?style=flat-square&color=blue" alt="License" />
+  <img src="https://img.shields.io/github/last-commit/misiektoja/spotify_profile_monitor?style=flat-square&color=green" alt="Last Commit" />
+  <img src="https://img.shields.io/badge/maintenance-active-brightgreen?style=flat-square" alt="Maintenance" />
+</p>
 
-✨ If you want to track Spotify friends' music activity, check out another tool I developed: [spotify_monitor](https://github.com/misiektoja/spotify_monitor).
+Powerful Spotify tool for real-time tracking of profile changes, playlist updates, follower growth, collaborators and more - delivered straight to your terminal or inbox.
 
-🛠️ If you're looking for debug tools to get Spotify Web Player access tokens and extract secret keys: [click here](#debugging-tools)
+### 🚀 Quick Install
+```sh
+pip install spotify_profile_monitor
+```
+
+<p align="center">
+   <img src="https://raw.githubusercontent.com/misiektoja/spotify_profile_monitor/refs/heads/main/assets/spotify_profile_monitor.png" alt="spotify_profile_monitor_screenshot" width="90%"/>
+</p>
 
 <a id="features"></a>
 ## Features
 
-- **Real-time tracking** of Spotify user activities and profile changes:
-   - addition/removal of **followings and followers**
-   - addition/removal of **playlists**
-   - addition/removal of **tracks in playlists** (including collaborator info for newly added tracks)
-   - **playlists name and description** changes
-   - **number of likes** for playlists
-   - **number of collaborators** for playlists
-   - **profile picture** changes
-   - **username** changes
-- **Email notifications** for various events (as listed above)
-- **Attaching changed profile pictures** directly to email notifications
-- **Displaying the profile picture** right in your terminal (if you have `imgcat` installed)
-- Additional functionalities on top of the monitoring mode allowing to display **detailed info about the user**, **list of followers & followings**, **recently played artists** and possibility to **search for users** in Spotify catalog with specific names
-- Ability to **display and export** the list of tracks for a specific playlist (including **Liked Songs** for the user who owns the Spotify access token)
-- **Saving all profile changes** (including playlists) with timestamps to the **CSV file**
-- **Clickable** **Spotify**, **Apple Music**, **YouTube Music**, **Amazon Music**, **Deezer**, **Tidal**, **Genius Lyrics**, **AZLyrics**, **Tekstowo.pl**, **Musixmatch** and **Lyrics.com** search URLs printed in the console and included in email notifications (configurable per service)
-- Support for **hybrid authentication approach** to get a **Spotify access token** (`sp_dc cookie`/`desktop client` + `OAuth app`, or standalone `OAuth app`/`OAuth user`)
-- Possibility to **control the running copy** of the script via signals
-- **Functional, procedural Python** (minimal OOP)
+### 👤 Profile Monitoring
+- **Real-time tracking**: Monitor Spotify user activities and profile changes.
+- **Social Network**: Detect addition/removal of **followings** and **followers**.
+- **Identity Changes**: Track **profile picture** and **username** changes.
+
+### 📜 Playlist Tracking
+- **Content Updates**: Monitor addition/removal of **tracks in playlists**.
+- **Collaborator Info**: Identify who added which track in **collaborative playlists**.
+- **Social Proof**: Monitor **likes** and **collaborators** count for playlists.
+- **Metadata**: Track **name** and **description** changes.
+
+### 📊 Advanced Tools
+- **Deep Insights**: Display detailed info about users, followers and followings.
+- **Historical Data**: View **recently played artists** and **search for users** by name.
+- **Export Power**: Display and export tracks from any playlist (including **Liked Songs**).
+- **Global Search**: Instant links to **Spotify, YouTube Music, Apple Music, Tidal, lyrics** and more.
+
+### 🔔 Smart Interactions
+- **Instant Alerts**: Detailed **Email notifications** for all profile and playlist changes.
+- **Visual Reports**: Attach changed profile pictures directly to emails.
+- **Terminal Graphics**: Display profile pictures right in your terminal (via `imgcat`).
+
+### ⚙️ Power Features
+- **Auth Flexibility**: Hybrid support for `sp_dc` cookie, Desktop Client and OAuth.
+- **CSV Logging**: Save all changes with full timestamps to a CSV file.
+- **Flexible Config**: Support for files, dotenv and environment variables.
+- **Signal Control**: Manage the running script via system signals (`SIGHUP`, `USR1`, etc.).
 
-<p align="center">
-   <img src="https://raw.githubusercontent.com/misiektoja/spotify_profile_monitor/refs/heads/main/assets/spotify_profile_monitor.png" alt="spotify_profile_monitor_screenshot" width="100%"/>
-</p>
+✨ If you want to track Spotify friends' music activity, check out another tool I developed: [spotify_monitor](https://github.com/misiektoja/spotify_monitor).
+
+🛠️ If you're looking for debug tools to get Spotify Web Player access tokens and extract secret keys: [click here](#debugging-tools)
 
 <a id="table-of-contents"></a>
 ## Table of Contents
@@ -156,10 +217,15 @@ Most settings can be configured via command-line arguments.
 If you want to have it stored persistently, generate a default config template and save it to a file named `spotify_profile_monitor.conf`:
 
 ```sh
+# On macOS, Linux or Windows Command Prompt (cmd.exe)
 spotify_profile_monitor --generate-config > spotify_profile_monitor.conf
 
+# On Windows PowerShell (recommended to avoid encoding issues)
+spotify_profile_monitor --generate-config spotify_profile_monitor.conf
 ```
 
+> **IMPORTANT**: On **Windows PowerShell**, using redirection (`>`) can cause the file to be encoded in UTF-16, which will lead to "null bytes" errors when running the tool. It is highly recommended to provide the filename directly as an argument to `--generate-config` to ensure UTF-8 encoding.
+
 Edit the `spotify_profile_monitor.conf` file and change any desired configuration options (detailed comments are provided for each).
 
 **New in v3.1:** The tool now uses a hybrid authentication approach. OAuth app credentials (`SP_APP_CLIENT_ID`, `SP_APP_CLIENT_SECRET`) are required for playlist and user information retrieval when using either `cookie` or `client` token source methods. See [Spotify OAuth App](#spotify-oauth-app) section for setup instructions.

{spotify_profile_monitor-3.1 → spotify_profile_monitor-3.2}/spotify_profile_monitor.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """
 Author: Michal Szymanski <misiektoja-github@rm-rf.ninja>
-v3.1
+v3.2
 
 OSINT tool implementing real-time tracking of Spotify users activities and profile changes including playlists:
 https://github.com/misiektoja/spotify_profile_monitor/
@@ -19,7 +19,7 @@ spotipy
 wcwidth (optional, needed by TRUNCATE_CHARS feature)
 """
 
-VERSION = "3.1"
+VERSION = "3.2"
 
 # ---------------------------
 # CONFIGURATION SECTION START
@@ -192,6 +192,12 @@ RECENTLY_PLAYED_ARTISTS_LIMIT_INFO = 15
 # To avoid false alarms, we delay notifications until this happens PLAYLISTS_DISAPPEARED_COUNTER times in a row
 PLAYLISTS_DISAPPEARED_COUNTER = 3
 
+# Occasionally, the Spotify API glitches and returns incomplete/empty playlists list
+# (e.g. network issues, API transient failures or playlists temporarily not visible)
+# To avoid false alarms, we delay playlist change notifications until the same change is seen
+# PLAYLISTS_CHANGE_COUNTER times in a row (set to 0 to disable this protection)
+PLAYLISTS_CHANGE_COUNTER = 2
+
 # Occasionally, the Spotify API glitches and returns an empty list of user followers / followings
 # To avoid false alarms, we delay notifications until this happens FOLLOWERS_FOLLOWINGS_DISAPPEARED_COUNTER times in a row
 FOLLOWERS_FOLLOWINGS_DISAPPEARED_COUNTER = 3
@@ -331,7 +337,6 @@ SECRET_CIPHER_DICT = {
 # Remote or local URL used to fetch updated secrets needed for TOTP generation
 # Set to empty string to disable
 # If you used "spotify_monitor_secret_grabber.py --secretdict > secretDict.json" specify the file location below
-# SECRET_CIPHER_DICT_URL = "https://github.com/Thereallo1026/spotify-secrets/blob/main/secrets/secretDict.json?raw=true"
 SECRET_CIPHER_DICT_URL = "https://github.com/xyloflake/spot-secrets-go/blob/main/secrets/secretDict.json?raw=true"
 # SECRET_CIPHER_DICT_URL = file:///C:/your_path/secretDict.json
 # SECRET_CIPHER_DICT_URL = "file:///your_path/secretDict.json"
@@ -564,6 +569,7 @@ RECENTLY_PLAYED_ARTISTS_LIMIT_INFO = 0
 PLAYLISTS_DISAPPEARED_COUNTER = 0
 FOLLOWERS_FOLLOWINGS_DISAPPEARED_COUNTER = 0
 COLLABORATORS_CHANGE_COUNTER = 0
+PLAYLISTS_CHANGE_COUNTER = 0
 USER_AGENT = ""
 LIVENESS_CHECK_INTERVAL = 0
 CHECK_INTERNET_URL = ""
@@ -648,6 +654,10 @@ GLITCH_CACHE = {}
 COLLABORATORS_BASELINE_CACHE = {}
 COLLABORATORS_PENDING_CACHE = {}
 
+# Tracks transient playlists glitches to suppress false alerts
+PLAYLISTS_BASELINE_CACHE = {}
+PLAYLISTS_PENDING_CACHE = {}
+
 LIVENESS_CHECK_COUNTER = LIVENESS_CHECK_INTERVAL / SPOTIFY_CHECK_INTERVAL
 
 stdout_bck = None
@@ -774,7 +784,8 @@ class Logger(object):
         self.logfile = open(filename, "a", buffering=1, encoding="utf-8")
 
     def write(self, message):
-        self.logfile.write(message)
+        # Expand tabs for file output (stdout remains untouched)
+        self.logfile.write(message.expandtabs(8))
         if (TRUNCATE_CHARS):
             message = truncate_string_per_line(message, TRUNCATE_CHARS)
         self.terminal.write(message)
@@ -1691,6 +1702,8 @@ def fetch_and_update_secrets():
             path = os.path.expanduser(os.path.expandvars(raw_path))
 
             print(f"Loading Spotify web-player TOTP secrets from file: {path}")
+            if os.path.getsize(path) == 0:
+                raise ValueError(f"Secret file is empty: {path}")
             with open(path, "r", encoding="utf-8") as f:
                 secrets = json.load(f)
             print("─" * HORIZONTAL_LINE)
@@ -1698,21 +1711,26 @@ def fetch_and_update_secrets():
             print(f"Fetching Spotify web-player TOTP secrets from URL: {SECRET_CIPHER_DICT_URL}")
             response = req.get(SECRET_CIPHER_DICT_URL, timeout=FUNCTION_TIMEOUT, verify=VERIFY_SSL)
             response.raise_for_status()
+            if not response.text.strip():
+                raise ValueError("Fetched payload is empty")
             secrets = response.json()
             print("─" * HORIZONTAL_LINE)
 
         if not isinstance(secrets, dict) or not secrets:
-            raise ValueError("fetch_and_update_secrets(): Fetched payload not a non-empty dict")
+            raise ValueError("Fetched payload not a non-empty dict")
 
         for key, value in secrets.items():
             if not isinstance(key, str) or not key.isdigit():
-                raise ValueError(f"fetch_and_update_secrets(): Invalid key format: {key}")
+                raise ValueError(f"Invalid key format: {key}")
             if not isinstance(value, list) or not all(isinstance(x, int) for x in value):
-                raise ValueError(f"fetch_and_update_secrets(): Invalid value format for key {key}")
+                raise ValueError(f"Invalid value format for key {key}")
 
         SECRET_CIPHER_DICT = secrets
         return True
 
+    except json.JSONDecodeError as e:
+        print(f"fetch_and_update_secrets(): Failed to parse secrets (invalid JSON format): {e}")
+        return False
     except Exception as e:
         print(f"fetch_and_update_secrets(): Failed to get new secrets: {e}")
         return False
@@ -5301,6 +5319,13 @@ def spotify_profile_monitor_uri(user_uri_id, csv_file_name, playlists_to_skip):
                                 else:
                                     # No change vs stable baseline; clear any pending candidate
                                     if p_uri in COLLABORATORS_PENDING_CACHE:
+                                        # If we had a pending change and we're back to stable baseline, this was a transient glitch that resolved - suppress notification
+                                        suppress_collab_notification = True
+                                        # Update the old values to match current stable baseline so the notification condition check fails
+                                        p_collaborators_old = len(stable_ids)
+                                        p_collaborators_list_old = stable_map
+                                        p_collaborators = len(current_ids)
+                                        p_collaborators_list = (p_collaborators_list or {}) if isinstance(p_collaborators_list, dict) else {}
                                         try:
                                             del COLLABORATORS_PENDING_CACHE[p_uri]
                                         except Exception:
@@ -5622,11 +5647,97 @@ def spotify_profile_monitor_uri(user_uri_id, csv_file_name, playlists_to_skip):
             if not error_while_processing:
                 list_of_playlists_old = list_of_playlists
 
-            if playlists_count != playlists_old_count:
+            # Suppress transient playlist glitches by confirming changes across multiple checks  and keep a stable
+            # baseline to avoid baseline poisoning
+            global PLAYLISTS_BASELINE_CACHE
+            global PLAYLISTS_PENDING_CACHE
+
+            # Helper to extract URI strings from playlist dict list for comparison
+            def extract_playlist_uris(playlist_list):
+                if not playlist_list:
+                    return frozenset()
+                return frozenset(
+                    p.get("uri") if isinstance(p, dict) else p
+                    for p in playlist_list
+                    if p
+                )
+
+            user_playlists_key = f"user:{user_uri_id}"
+            stable_entry = PLAYLISTS_BASELINE_CACHE.get(user_playlists_key)
+            if stable_entry is None:
+                # Initialize baseline from previously persisted playlist snapshot (if available)
+                stable_uris = extract_playlist_uris(playlists_old)
+                stable_count = playlists_old_count
+                # Store both the URI set (for comparison) and the full list (for restoration)
+                PLAYLISTS_BASELINE_CACHE[user_playlists_key] = {"uris": stable_uris, "count": stable_count, "playlist_list": list(playlists_old) if playlists_old else []}
+                stable_entry = PLAYLISTS_BASELINE_CACHE[user_playlists_key]
+
+            stable_uris = stable_entry.get("uris") or frozenset()
+            stable_count = stable_entry.get("count", 0)
+            stable_playlist_list = stable_entry.get("playlist_list") or []
+            current_uris = extract_playlist_uris(playlists)
+            suppress_playlists_notification = False
+
+            if current_uris != stable_uris:
+                # Playlists have changed vs stable baseline
+                # Skip PLAYLISTS_CHANGE_COUNTER protection when dropping to 0 - let PLAYLISTS_DISAPPEARED_COUNTER handle that case
+                dropping_to_zero = len(current_uris) == 0
+
+                if not dropping_to_zero:
+                    pending = PLAYLISTS_PENDING_CACHE.get(user_playlists_key)
+                    if pending and pending.get("new_uris") == current_uris:
+                        pending["streak"] = int(pending.get("streak", 0)) + 1
+                    else:
+                        pending = {"new_uris": current_uris, "new_count": len(current_uris), "streak": 1, "first_seen_ts": time.time(), "playlist_list": list(playlists) if playlists else []}
+                        PLAYLISTS_PENDING_CACHE[user_playlists_key] = pending
+
+                    if PLAYLISTS_CHANGE_COUNTER and int(pending.get("streak", 0)) < int(PLAYLISTS_CHANGE_COUNTER):
+                        print(f"* Spotify API: suspected transient playlist change for user '{username}' ({stable_count} -> {len(current_uris)}), streak {pending.get('streak')}/{PLAYLISTS_CHANGE_COUNTER}; will confirm next check\n")
+                        print(f"Check interval:\t\t\t{display_time(SPOTIFY_CHECK_INTERVAL)} ({get_range_of_dates_from_tss(int(time.time()) - SPOTIFY_CHECK_INTERVAL, int(time.time()), short=True)})")
+                        print_cur_ts("Timestamp:\t\t\t")
+                        suppress_playlists_notification = True
+                    else:
+                        # Change confirmed - update variables for notification
+                        # Restore playlists_old from the stored dict list, not from URI strings
+                        playlists_old = stable_playlist_list
+                        playlists_old_count = stable_count
+                        playlists_count = len(current_uris)
+                        # playlists already contains current dict list, no change needed
+
+                        # Update stable baseline and clear pending
+                        PLAYLISTS_BASELINE_CACHE[user_playlists_key] = {
+                            "uris": current_uris,
+                            "count": playlists_count,
+                            "playlist_list": list(playlists) if playlists else []
+                        }
+                        try:
+                            del PLAYLISTS_PENDING_CACHE[user_playlists_key]
+                        except Exception:
+                            pass
+                # else: dropping to 0, let PLAYLISTS_DISAPPEARED_COUNTER handle it below
+            else:
+                # No change vs stable baseline; clear any pending candidate
+                if user_playlists_key in PLAYLISTS_PENDING_CACHE:
+                    # If we had a pending change and we're back to stable baseline, this was a transient glitch that resolved - suppress notification
+                    suppress_playlists_notification = True
+                    # Update the old values to match current stable baseline so the notification condition check fails
+                    playlists_old_count = stable_count
+                    playlists_old = stable_playlist_list
+                    playlists_count = len(current_uris)
+                    # playlists already contains current dict list, no change needed
+                    print(f"* Spotify API: Playlists for user '{username}' reverted to baseline ({stable_count}) after transient glitch; suppressing notification\n")
+                    print(f"Check interval:\t\t\t{display_time(SPOTIFY_CHECK_INTERVAL)} ({get_range_of_dates_from_tss(int(time.time()) - SPOTIFY_CHECK_INTERVAL, int(time.time()), short=True)})")
+                    print_cur_ts("Timestamp:\t\t\t")
+                    try:
+                        del PLAYLISTS_PENDING_CACHE[user_playlists_key]
+                    except Exception:
+                        pass
+
+            if not suppress_playlists_notification and playlists_count != playlists_old_count:
                 if playlists_count == 0:
                     playlists_zeroed_counter += 1
                     if playlists_zeroed_counter == PLAYLISTS_DISAPPEARED_COUNTER:
-                        print(f"* Spotify API: Playlists count dropped from {playlists_old_count} to 0 and has been 0 for {playlists_zeroed_counter} checks; accepting 0 as the new baseline")
+                        print(f"* Spotify API: Playlists count dropped from {playlists_old_count} to 0 and has been 0 for {playlists_zeroed_counter} checks; accepting 0 as the new baseline\n")
                         spotify_print_changed_followers_followings_playlists(
                             username, playlists, playlists_old, playlists_count, playlists_old_count, "Playlists", "for", "Added playlists to profile", "Added Playlist", "Removed playlists from profile", "Removed Playlist", playlists_file, csv_file_name, PROFILE_NOTIFICATION, True, sp_accessToken)
                         print(f"Check interval:\t\t\t{display_time(SPOTIFY_CHECK_INTERVAL)} ({get_range_of_dates_from_tss(int(time.time()) - SPOTIFY_CHECK_INTERVAL, int(time.time()), short=True)})")
@@ -5634,13 +5745,15 @@ def spotify_profile_monitor_uri(user_uri_id, csv_file_name, playlists_to_skip):
                         playlists_old_count = playlists_count
                         playlists_old = playlists
                         playlists_zeroed_counter = 0
+                        # Update baseline after accepting 0 as new baseline
+                        PLAYLISTS_BASELINE_CACHE[user_playlists_key] = {"uris": frozenset(), "count": 0, "playlist_list": []}
                     elif playlists_zeroed_counter < PLAYLISTS_DISAPPEARED_COUNTER:
-                        print(f"* Spotify API: Playlists count dropped from {playlists_old_count} to 0, streak {playlists_zeroed_counter}/{PLAYLISTS_DISAPPEARED_COUNTER}; old count and list retained")
+                        print(f"* Spotify API: Playlists count dropped from {playlists_old_count} to 0, streak {playlists_zeroed_counter}/{PLAYLISTS_DISAPPEARED_COUNTER}; old count and list retained\n")
                         print(f"Check interval:\t\t\t{display_time(SPOTIFY_CHECK_INTERVAL)} ({get_range_of_dates_from_tss(int(time.time()) - SPOTIFY_CHECK_INTERVAL, int(time.time()), short=True)})")
                         print_cur_ts("Timestamp:\t\t\t")
                 else:
                     if playlists_old_count == 0 and playlists_zeroed_counter >= PLAYLISTS_DISAPPEARED_COUNTER:
-                        print(f"* Spotify API: Playlists count recovered to {playlists_count}; previously was 0 for {playlists_zeroed_counter} checks (old baseline was {playlists_old_count})")
+                        print(f"* Spotify API: Playlists count recovered to {playlists_count}; previously was 0 for {playlists_zeroed_counter} checks (old baseline was {playlists_old_count})\n")
 
                     spotify_print_changed_followers_followings_playlists(username, playlists, playlists_old, playlists_count, playlists_old_count, "Playlists", "for", "Added playlists to profile", "Added Playlist", "Removed playlists from profile", "Removed Playlist", playlists_file, csv_file_name, PROFILE_NOTIFICATION, True, sp_accessToken)
                     print(f"Check interval:\t\t\t{display_time(SPOTIFY_CHECK_INTERVAL)} ({get_range_of_dates_from_tss(int(time.time()) - SPOTIFY_CHECK_INTERVAL, int(time.time()), short=True)})")
@@ -5648,14 +5761,20 @@ def spotify_profile_monitor_uri(user_uri_id, csv_file_name, playlists_to_skip):
                     playlists_old_count = playlists_count
                     playlists_old = playlists
                     playlists_zeroed_counter = 0
+                    # Update baseline after confirmed change
+                    PLAYLISTS_BASELINE_CACHE[user_playlists_key] = {
+                        "uris": extract_playlist_uris(playlists),
+                        "count": playlists_count,
+                        "playlist_list": list(playlists) if playlists else []
+                    }
 
-            elif playlists_count == playlists_old_count:
+            elif not suppress_playlists_notification and playlists_count == playlists_old_count:
                 if playlists_count == 0:
                     playlists_zeroed_counter = 0
                     playlists_old = playlists
                 else:
                     if playlists_zeroed_counter > 0:
-                        print(f"* Spotify API: Playlists count recovered to {playlists_count} (matching old baseline) after a streak of {playlists_zeroed_counter} checks")
+                        print(f"* Spotify API: Playlists count recovered to {playlists_count} (matching old baseline) after a streak of {playlists_zeroed_counter} checks\n")
                         print(f"Check interval:\t\t\t{display_time(SPOTIFY_CHECK_INTERVAL)} ({get_range_of_dates_from_tss(int(time.time()) - SPOTIFY_CHECK_INTERVAL, int(time.time()), short=True)})")
                         print_cur_ts("Timestamp:\t\t\t")
                     playlists_zeroed_counter = 0
@@ -5674,7 +5793,22 @@ def main():
     global CLI_CONFIG_PATH, DOTENV_FILE, LOCAL_TIMEZONE, LIVENESS_CHECK_COUNTER, SP_DC_COOKIE, SP_APP_CLIENT_ID, SP_APP_CLIENT_SECRET, SP_USER_CLIENT_ID, SP_USER_CLIENT_SECRET, LOGIN_REQUEST_BODY_FILE, CLIENTTOKEN_REQUEST_BODY_FILE, REFRESH_TOKEN, LOGIN_URL, USER_AGENT, DEVICE_ID, SYSTEM_ID, USER_URI_ID, CSV_FILE, PLAYLISTS_TO_SKIP_FILE, FILE_SUFFIX, DISABLE_LOGGING, SP_LOGFILE, PROFILE_NOTIFICATION, SPOTIFY_CHECK_INTERVAL, SPOTIFY_ERROR_INTERVAL, FOLLOWERS_FOLLOWINGS_NOTIFICATION, ERROR_NOTIFICATION, DETECT_CHANGED_PROFILE_PIC, DETECT_CHANGES_IN_PLAYLISTS, GET_ALL_PLAYLISTS, imgcat_exe, SMTP_PASSWORD, SP_SHA256, stdout_bck, APP_VERSION, CPU_ARCH, OS_BUILD, PLATFORM, OS_MAJOR, OS_MINOR, CLIENT_MODEL, TOKEN_SOURCE, ALARM_TIMEOUT, pyotp, CLEAN_OUTPUT, USER_AGENT, SP_APP_TOKENS_FILE, SP_USER_TOKENS_FILE, TRUNCATE_CHARS
 
     if "--generate-config" in sys.argv:
-        print(CONFIG_BLOCK.strip("\n"))
+        config_content = CONFIG_BLOCK.strip("\n") + "\n"
+        # Check if a filename was provided after --generate-config
+        try:
+            idx = sys.argv.index("--generate-config")
+            if idx + 1 < len(sys.argv) and not sys.argv[idx + 1].startswith("-"):
+                # Write directly to file (bypasses PowerShell UTF-16 encoding issue on Windows)
+                output_file = sys.argv[idx + 1]
+                with open(output_file, "w", encoding="utf-8") as f:
+                    f.write(config_content)
+                print(f"Config written to: {output_file}")
+                sys.exit(0)
+        except (ValueError, IndexError):
+            pass
+        # No filename provided - write to stdout using buffer to ensure UTF-8
+        sys.stdout.buffer.write(config_content.encode("utf-8"))
+        sys.stdout.buffer.flush()
         sys.exit(0)
 
     if "--version" in sys.argv:
@@ -5715,8 +5849,11 @@ def main():
     )
     conf.add_argument(
         "--generate-config",
-        action="store_true",
-        help="Print default config template and exit",
+        dest="generate_config",
+        nargs="?",
+        const=True,
+        metavar="FILENAME",
+        help="Print default config template and exit (on Windows PowerShell, specify a filename to avoid redirect encoding issues)",
     )
     conf.add_argument(
         "--env-file",