{"id":28251,"library":"spotui","title":"spotui","description":"A terminal user interface for Spotify, allowing browsing and control of playlists, search, and playback. Current version 0.1.20, released on GitHub. Development may be low activity; last release in 2021.","status":"active","version":"0.1.20","language":"python","source_language":"en","source_url":"https://github.com/ceuk/spotui","tags":["spotify","tui","terminal","music","cli"],"install":[{"cmd":"pip install spotui","lang":"bash","label":"PyPI"}],"dependencies":[],"imports":[{"note":"The package does not expose a public API; after import, you must call main() to start the TUI.","wrong":"import spotui","symbol":"main","correct":"from spotui import main"}],"quickstart":{"code":"import os\nos.environ['SPOTIPY_CLIENT_ID'] = os.environ.get('SPOTIPY_CLIENT_ID', 'your_client_id')\nos.environ['SPOTIPY_CLIENT_SECRET'] = os.environ.get('SPOTIPY_CLIENT_SECRET', 'your_client_secret')\nos.environ['SPOTIPY_REDIRECT_URI'] = os.environ.get('SPOTIPY_REDIRECT_URI', 'http://localhost:8080')\n\nfrom spotui import main\nmain()","lang":"python","description":"Authenticate with Spotify API (requires env vars) and launch the TUI."},"warnings":[{"fix":"Use `from spotui import main; main()` instead of expecting module-level functions.","message":"spotui does not export a usable API; it only provides a main() function that starts the terminal interface. Importing the package does nothing by itself.","severity":"gotcha","affected_versions":"0.1.0+"},{"fix":"Set environment variables before importing spotui. Example in quickstart.","message":"The package requires Spotify API credentials via environment variables. Without SPOTIPY_CLIENT_ID, SPOTIPY_CLIENT_SECRET, and SPOTIPY_REDIRECT_URI, the application will crash on startup.","severity":"breaking","affected_versions":"0.1.0+"},{"fix":"Use a Unix-like terminal such as iTerm2, GNOME Terminal, or Windows Terminal with WSL.","message":"The TUI may not work on all terminals (requires a color-capable terminal) and has not been tested on Windows.","severity":"gotcha","affected_versions":"0.1.0+"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run `pip install spotui` to install the package.","cause":"The package is not installed or the environment is incorrect.","error":"ModuleNotFoundError: No module named 'spotui'"},{"fix":"Re-run the application; it will prompt for re-authentication.","cause":"Spotify API token expired and spotui may not handle refresh automatically.","error":"spotipy.SpotifyException: The access token expired"},{"fix":"Ensure you have an active Spotify playback device (Spotify app or web player) and try again.","cause":"This can occur if the Spotify API returns an unexpected empty response, e.g., no devices found.","error":"TypeError: 'NoneType' object is not iterable"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}