{"id":13484701,"url":"https://github.com/ceuk/spotui","last_synced_at":"2025-03-27T16:31:11.864Z","repository":{"id":43574379,"uuid":"232529693","full_name":"ceuk/spotui","owner":"ceuk","description":"Spotify in the terminal 💻🎶","archived":false,"fork":false,"pushed_at":"2023-07-25T21:01:49.000Z","size":90,"stargazers_count":502,"open_issues_count":8,"forks_count":20,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-05-02T02:17:21.573Z","etag":null,"topics":["cli","cli-tool","music","music-player","python","python3","spotify","spotify-api","spotify-connect","spotify-tui","spotui","terminal","terminal-app","terminal-based","tui"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ceuk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"github":"ceuk"}},"created_at":"2020-01-08T09:43:27.000Z","updated_at":"2024-04-24T05:50:51.000Z","dependencies_parsed_at":"2024-01-13T19:18:19.224Z","dependency_job_id":"ac42f7f0-105c-4190-bd03-765d77787978","html_url":"https://github.com/ceuk/spotui","commit_stats":{"total_commits":65,"total_committers":7,"mean_commits":9.285714285714286,"dds":"0.46153846153846156","last_synced_commit":"2dbc92fc66864b4fbb105456348760fe65a6e31c"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ceuk%2Fspotui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ceuk%2Fspotui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ceuk%2Fspotui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ceuk%2Fspotui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ceuk","download_url":"https://codeload.github.com/ceuk/spotui/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245882344,"owners_count":20687869,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","cli-tool","music","music-player","python","python3","spotify","spotify-api","spotify-connect","spotify-tui","spotui","terminal","terminal-app","terminal-based","tui"],"created_at":"2024-07-31T17:01:30.623Z","updated_at":"2025-03-27T16:31:11.404Z","avatar_url":"https://github.com/ceuk.png","language":"Python","readme":"# SpoTUI\n![Version Badge](https://img.shields.io/pypi/v/spotui)\n![License Badge](https://img.shields.io/github/license/ceuk/spotui)\n![Code size Badge](https://img.shields.io/github/languages/code-size/ceuk/spotui)\n\nSpotify in the terminal. \n\n![screenshot](https://i.imgur.com/7syOTKb.gif)\n\nGetting Started\n-----------\n\nInstall with ```pip install spotui```\n\n**Please Note:** SpoTUI will not work with free Spotify accounts.\n\nRegister a developer application at: [https://developer.spotify.com/dashboard/login]( https://developer.spotify.com/dashboard/login). Once you create the application you'll need to edit it to add a Redirect URI. Use something like 'http://localhost:8888/callback' (it doesn't matter what you use really as long as it matches what's in your config file).\n\nRun `spotui` to generate a sample config file at ~/.config/spotui/.spotuirc or create one manually with the following:\n\n```\n[spotify_api]\nuser_name = *Your spotify username*\nclient_id = *Your application client ID*\nclient_secret = *Your application secret*\nredirect_uri = http://localhost:8888/callback\n\n[other]\nuse_nerd_fonts = yes\nconfig_version = 1 \n```\n\nOnce you're done start the app with `spotui`, log in via your browser and copy the URL of the broken web page you're taken to. *(This ugly authentication process is part of the underlying Spotipy library I use so don't blame me :stuck_out_tongue_winking_eye:)*\n\nThis app acts like a kind of remote control for Spotify. The best way to use it is in conjunction with [Spotifyd](https://github.com/Spotifyd/spotifyd) which means you won't need to actually have Spotify open. Alternatively, you can just open Spotify on your computer, phone etc. (press `d` to pick the device to play on).\n\n\n\n\nControls\n-------\n\n**Navigation**\n\n`tab` Switch section\n\n`k`/`↑` Up\n\n`j`/`↓` Down\n\n`g` Scroll to top\n\n`G` Scroll to bottom\n\n`Enter` Select\n\n`/` Search \n\n`d` Open device menu\n\n`Esc`/`q` Quit/Back\n\n**Playback**\n\n`space` Play/Pause\n\n`n` Next track\n\n`p` Previous track\n\n`→` Seek 10s forwards\n\n`←` Seek 10s backwards\n\n`s` Toggle shuffle\n\n`r` Toggle repeat\n\n\nFAQ\n----\n\n* **What do I do if something breaks?** [Raise an issue](https://github.com/ceuk/spotui/issues/new) or submit a PR to fix my crappy code :pray:\n* **Why can't I play anything?** Check you have a device selected (d) and make sure you're using a paid Spotify account\n* **I get an error page when I log into Spotify** This is correct - just copy the URL and paste it back into the terminal\n* **Podcasts aren't playing** See: #13\n\nDependencies\n-----------\n\n* [Spotipy](https://spotipy.readthedocs.io/en/latest/)\n\nLICENSE\n------\n\nMIT\n","funding_links":["https://github.com/sponsors/ceuk"],"categories":["Python","\u003ca name=\"music\"\u003e\u003c/a\u003eSound and music","Table of Contents"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fceuk%2Fspotui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fceuk%2Fspotui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fceuk%2Fspotui/lists"}