spotify-profile-monitor 2.5__tar.gz → 2.5.2__tar.gz

{spotify_profile_monitor-2.5 → spotify_profile_monitor-2.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spotify_profile_monitor
-Version: 2.5
+Version: 2.5.2
 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

{spotify_profile_monitor-2.5 → spotify_profile_monitor-2.5.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "spotify_profile_monitor"
-version = "2.5"
+version = "2.5.2"
 description = "Tool implementing real-time tracking of Spotify users activities and profile changes including playlists"
 readme = "README.md"
 license = "GPL-3.0-or-later"

{spotify_profile_monitor-2.5 → spotify_profile_monitor-2.5.2}/spotify_profile_monitor.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spotify_profile_monitor
-Version: 2.5
+Version: 2.5.2
 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

{spotify_profile_monitor-2.5 → spotify_profile_monitor-2.5.2}/spotify_profile_monitor.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """
 Author: Michal Szymanski <misiektoja-github@rm-rf.ninja>
-v2.5
+v2.5.2
 
 OSINT tool implementing real-time tracking of Spotify users activities and profile changes including playlists:
 https://github.com/misiektoja/spotify_profile_monitor/
@@ -18,7 +18,7 @@ python-dotenv (optional)
 spotipy (optional, needed when the token source is set to oauth_app)
 """
 
-VERSION = "2.5"
+VERSION = "2.5.2"
 
 # ---------------------------
 # CONFIGURATION SECTION START
@@ -27,15 +27,16 @@ VERSION = "2.5"
 CONFIG_BLOCK = """
 # Select the method used to obtain the Spotify access token
 # Available options:
-#   cookie    - uses the sp_dc cookie to retrieve a token via the Spotify web endpoint (recommended)
-#   oauth_app - uses the Client Credentials OAuth flow (app-level token for public data, has some limitations)
-#   client    - uses captured credentials from the Spotify desktop client and a Protobuf-based login flow (for advanced users)
+#   cookie     - uses the sp_dc cookie to retrieve a token via the Spotify web endpoint (recommended)
+#   oauth_app  - uses the Client Credentials OAuth flow (app-level token for public data, has some limitations)
+#   oauth_user - uses the Authorization Code OAuth flow (user-level token for public and private data, has some limitations)
+#   client     - uses captured credentials from the Spotify desktop client and a Protobuf-based login flow (for advanced users)
 TOKEN_SOURCE = "cookie"
 
 # ---------------------------------------------------------------------
 
 # The section below is used when the token source is set to 'cookie'
-# (to configure the alternative 'oauth_app' or 'client' methods, see the section at the end of this config block)
+# (to configure the alternative 'oauth_app', 'oauth_user' or 'client' methods, see the section at the end of this config block)
 #
 # - Log in to Spotify web client (https://open.spotify.com/) and retrieve your sp_dc cookie
 #   (use your web browser's dev console or "Cookie-Editor" by cgagnier to extract it easily: https://cookie-editor.com/)
@@ -106,19 +107,19 @@ IMGCAT_PATH = "imgcat"
 
 # SHA256 hash needed to search for Spotify users (used with -s)
 #
-# Intercept traffic when using search in the Spotify client
-# Look for requests with searchUsers or searchDesktop operation name
-# Extract the "sha256Hash" from the request
+# - Run an intercepting proxy of your choice (like Proxyman)
+# - Launch the Spotify desktop client and search for some user
+# - Look for requests with the 'searchUsers' or 'searchDesktop' operation name
+# - Display the details of one of these requests and copy the 'sha256Hash' parameter value
+#   (string marked as `XXXXXXXXXX` below) 
 #
 # Example request:
 # https://api-partner.spotify.com/pathfinder/v1/query?operationName=searchUsers&variables={"searchTerm":"user_uri_id","offset":0,"limit":5,"numberOfTopResults":5,"includeAudiobooks":false}&extensions={"persistedQuery":{"version":1,"sha256Hash":"XXXXXXXXXX"}}
-# You are interested in the string marked as "XXXXXXXXXX" here
 #
 # Provide the SP_SHA256 secret using one of the following methods:
 #   - Set it as an environment variable (e.g. export SP_SHA256=...)
 #   - Add it to ".env" file (SP_SHA256=...) for persistent use
-# Fallback:
-#   - Hard-code it in the code or config file
+#   - Fallback: hard-code it in the code or config file
 SP_SHA256 = "your_spotify_client_sha256"
 
 # Notify when user's public playlists change? (via console and email if PROFILE_NOTIFICATION / -p is enabled)
@@ -251,8 +252,7 @@ TOKEN_RETRY_TIMEOUT = 0.5  # 0.5 second
 #   - Pass it at runtime with -r / --oauth-app-creds (use SP_APP_CLIENT_ID:SP_APP_CLIENT_SECRET format - note the colon separator)
 #   - Set it as an environment variable (e.g. export SP_APP_CLIENT_ID=...; export SP_APP_CLIENT_SECRET=...)
 #   - Add it to ".env" file (SP_APP_CLIENT_ID=... and SP_APP_CLIENT_SECRET=...) for persistent use
-# Fallback:
-#   - Hard-code it in the code or config file
+#   - Fallback: hard-code it in the code or config file
 #
 # The tool automatically refreshes the access token, so it remains valid indefinitely
 SP_APP_CLIENT_ID = "your_spotify_app_client_id"
@@ -278,8 +278,7 @@ SP_APP_TOKENS_FILE = ".spotify-profile-monitor-oauth-app.json"
 #   - Pass it at runtime with -n / --oauth-user-creds (use SP_USER_CLIENT_ID:SP_USER_CLIENT_SECRET format - note the colon separator)
 #   - Set it as an environment variable (e.g. export SP_USER_CLIENT_ID=...; export SP_USER_CLIENT_SECRET=...)
 #   - Add it to ".env" file (SP_USER_CLIENT_ID=... and SP_USER_CLIENT_SECRET=...) for persistent use
-# Fallback:
-#   - Hard-code it in the code or config file
+#   - Fallback: hard-code it in the code or config file
 #
 # To use PKCE mode, set SP_USER_CLIENT_SECRET to an empty string ("")
 #
@@ -2673,7 +2672,7 @@ def spotify_get_user_followings(access_token, user_uri_id):
                 items = data.get("items", []) or []
                 for a in items:
                     if isinstance(a, dict):
-                        all_artists.append({"id": a.get("id"), "name": a.get("name"), "uri": a.get("uri")})
+                        all_artists.append({"name": a.get("name"), "uri": a.get("uri")})
                 after = data.get("cursors", {}).get("after")
                 if not after:
                     break
@@ -5567,7 +5566,8 @@ def main():
     print(f"* Ignore listed playlists:\t{bool(PLAYLISTS_TO_SKIP_FILE)}" + (f" ({PLAYLISTS_TO_SKIP_FILE})" if PLAYLISTS_TO_SKIP_FILE else ""))
     print(f"* Display profile pics:\t\t{bool(imgcat_exe)}" + (f" (via {imgcat_exe})" if imgcat_exe else ""))
     print(f"* Output logging enabled:\t{not DISABLE_LOGGING}" + (f" ({FINAL_LOG_PATH})" if not DISABLE_LOGGING else ""))
-    print(f"* Spotify token cache file:\t{({'oauth_app': SP_APP_TOKENS_FILE, 'oauth_user': SP_USER_TOKENS_FILE}.get(TOKEN_SOURCE) or 'None (memory only)')}")
+    if TOKEN_SOURCE in ('oauth_user', 'oauth_app'):
+        print(f"* Spotify token cache file:\t{({'oauth_app': SP_APP_TOKENS_FILE, 'oauth_user': SP_USER_TOKENS_FILE}.get(TOKEN_SOURCE) or 'None (memory only)')}")
     print(f"* Configuration file:\t\t{cfg_path}")
     print(f"* Dotenv file:\t\t\t{env_path or 'None'}")
     print(f"* Local timezone:\t\t{LOCAL_TIMEZONE}\n")