{"id":28233,"library":"spotipy-tui","title":"SpotipyTUI","description":"A text-based user interface (TUI) for controlling the Spotify desktop client, built on spotipy. Version 1.0.5; no recent activity, last release 2023. Low cadence.","status":"active","version":"1.0.5","language":"python","source_language":"en","source_url":"https://github.com/JonShepChen/SpotipyTUI","tags":["spotify","tui","cli","music"],"install":[{"cmd":"pip install spotipy-tui","lang":"bash","label":"pip install"}],"dependencies":[],"imports":[{"note":"The main class is SpotipyTUI, not main; main is a function inside the module.","wrong":"from spotipy_tui import main","symbol":"SpotipyTUI","correct":"from spotipy_tui import SpotipyTUI"}],"quickstart":{"code":"from spotipy_tui import SpotipyTUI\nimport os\nclient_id = os.environ.get('SPOTIPY_CLIENT_ID', '')\nclient_secret = os.environ.get('SPOTIPY_CLIENT_SECRET', '')\nredirect_uri = 'http://localhost:8888/callback'\ntui = SpotipyTUI(client_id=client_id, client_secret=client_secret, redirect_uri=redirect_uri)\ntui.run()","lang":"python","description":"Initialize and run the TUI using Spotify credentials from environment variables."},"warnings":[{"fix":"Ensure Spotify desktop app is open and playing on the same machine.","message":"Requires the Spotify desktop client running. The TUI controls the local client, not the web API.","severity":"gotcha","affected_versions":"all"},{"fix":"Check spotipy docs for updated scopes; manually set scope in scope parameter.","message":"Uses spotipy with the 'user-modify-playback-state' scope, which may be deprecated. Some endpoints may stop working.","severity":"deprecated","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Set environment variables SPOTIPY_CLIENT_ID and SPOTIPY_CLIENT_SECRET from Spotify Developer Dashboard.","cause":"Missing or invalid Spotify API credentials (SPOTIPY_CLIENT_ID, SPOTIPY_CLIENT_SECRET).","error":"SpotifyClientError: 401 - Unauthorized"},{"fix":"Run 'pip install spotipy-tui' then import as 'from spotipy_tui import SpotipyTUI'.","cause":"Package not installed; name is hyphenated but import uses underscore.","error":"ModuleNotFoundError: No module named 'spotipy_tui'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}