{"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":[{"wrong":"from spotui import main","symbol":"main","correct":"import spotui"}],"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,"search_vec":"'0.1.20':19 '2021':31 'activ':27 'allow':8 'brows':9 'cli':36 'control':11 'current':17 'develop':23 'github':22 'interfac':5 'last':28 'low':26 'may':24 'music':35 'playback':16 'playlist':13 'releas':20,29 'search':14 'spotifi':7,32 'spotui':1 'termin':3,34 'tui':33 'user':4 'version':18","created_at":"2026-05-09T05:54:31.596683+00:00","updated_at":"2026-05-09T05:54:31.596683+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"spotui","cli_version":"Traceback (most recent call last):","type":"library","homepage":null,"github":"https://github.com/ceuk/spotui","docs":null,"changelog":null,"pypi":"https://pypi.org/project/spotui/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["communication"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}