{"id":28226,"library":"spotifytracker","title":"SpotifyTracker","description":"Track your Spotify play history by fetching recently played tracks and storing them locally. Version 0.0.18 is in early development; releases are sporadic.","status":"active","version":"0.0.18","language":"python","source_language":"en","source_url":"https://github.com/eriktaubeneck/spotifytracker","tags":["spotify","tracking","play-history","music"],"install":[{"cmd":"pip install spotifytracker","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"HTTP requests to Spotify API","package":"requests","optional":false}],"imports":[{"note":"Common mistake: direct module import does not expose the class","wrong":"import spotifytracker","symbol":"SpotifyTracker","correct":"from spotifytracker import SpotifyTracker"}],"quickstart":{"code":"from spotifytracker import SpotifyTracker\nimport os\n\nclient_id = os.environ.get('SPOTIFY_CLIENT_ID', '')\nclient_secret = os.environ.get('SPOTIFY_CLIENT_SECRET', '')\n\nif not client_id or not client_secret:\n    raise ValueError(\"Set SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET environment variables\")\n\ntracker = SpotifyTracker(client_id, client_secret)\ntracker.run()","lang":"python","description":"Minimal example: authenticate and start tracking play history."},"warnings":[{"fix":"Ensure your Spotify app has the scope enabled and you pass correct credentials.","message":"The library requires Spotify API credentials with the 'user-read-recently-played' scope. Without it, no data is fetched and no error is raised.","severity":"gotcha","affected_versions":"all"},{"fix":"Wrap with timeout or run in a separate thread if non-blocking behavior is needed.","message":"run() blocks indefinitely; there is no built-in way to stop gracefully except KeyboardInterrupt. The library does not support async or background threads.","severity":"gotcha","affected_versions":"all"},{"fix":"Use 'access_token' instead of 'token' when instantiating SpotifyTracker.","message":"The constructor parameter 'token' was renamed to 'access_token' in v0.0.15. Old code using 'token' will break.","severity":"deprecated","affected_versions":">=0.0.15"}],"env_vars":null,"search_vec":"'0.0.18':17 'develop':21 'earli':20 'fetch':8 'histori':6,29 'local':15 'music':30 'play':5,10,28 'play-histori':27 'recent':9 'releas':22 'sporad':24 'spotifi':4,25 'spotifytrack':1 'store':13 'track':2,11,26 'version':16","created_at":"2026-05-09T05:54:23.497992+00:00","updated_at":"2026-05-09T05:54:23.497992+00:00","problems":{"verify_error":"× Failed to build `pyyaml==3.13`\n  ├─▶ The build backend returned an error\n  ╰─▶ Call to `setuptools.build_meta:__legacy__.build_wheel` failed (exit\n      status: 1)\n\n      [stderr]\n      /home/xor/.cache/uv/builds-v0/.tmplj9wMC/lib/python3.12/site-packages/setuptools/_vendor/wheel/bdist_wheel.py:4:"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"spotifytracker","cli_version":"Usage:","type":"library","homepage":null,"github":"http://github.com/eriktaubeneck/spotifytracker","docs":null,"changelog":null,"pypi":"https://pypi.org/project/spotifytracker/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["communication"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"install_fail","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-06","install_tag":null}}