{"id":33185794,"url":"https://github.com/szktkfm/sptui","last_synced_at":"2026-01-16T20:38:31.766Z","repository":{"id":217098677,"uuid":"738041004","full_name":"szktkfm/sptui","owner":"szktkfm","description":"Spotify TUI player","archived":false,"fork":false,"pushed_at":"2025-02-02T13:50:53.000Z","size":3742,"stargazers_count":28,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-02T14:31:44.793Z","etag":null,"topics":["bubble","bubbletea","cli","go","spotify","tui"],"latest_commit_sha":null,"homepage":"","language":"Go","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/szktkfm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-02T09:21:48.000Z","updated_at":"2025-02-02T13:50:21.000Z","dependencies_parsed_at":"2024-01-16T22:01:22.334Z","dependency_job_id":"7245adda-ef49-404e-8bf3-5b47e277c3ba","html_url":"https://github.com/szktkfm/sptui","commit_stats":null,"previous_names":["szktkfm/spotui","szktkfm/sptui"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/szktkfm/sptui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/szktkfm%2Fsptui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/szktkfm%2Fsptui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/szktkfm%2Fsptui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/szktkfm%2Fsptui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/szktkfm","download_url":"https://codeload.github.com/szktkfm/sptui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/szktkfm%2Fsptui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28482267,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["bubble","bubbletea","cli","go","spotify","tui"],"created_at":"2025-11-16T05:00:20.101Z","updated_at":"2026-01-16T20:38:31.745Z","avatar_url":"https://github.com/szktkfm.png","language":"Go","readme":"# sptui\n[![Go Report Card](https://goreportcard.com/badge/github.com/szktkfm/spotui)](https://goreportcard.com/report/github.com/szktkfm/sptoui)\n\n\u003cimg src=\"assets/demo.gif\" width=\"500\"\u003e\n\n## Overview\nsptui is a Spotify TUI player, written in Go and leveraging the  [charmbracelet/bubbletea](https://github.com/charmbracelet/bubbletea)  library. \n\n## Installation\nVisit the  [GitHub Releases](https://github.com/szktkfm/sptui/releases) page for sptui and download the appropriate binary for your operating system.\n\nIf you are on NetBSD, a package is available from the [official repositories](https://pkgsrc.se/audio/sptui). To install, simply run:\n```bash\npkgin install sptui\n```\n\n## Usage\n### Connecting to Spotify’s API\nTo use sptui, you need to connect it to Spotify's API. Follow these steps:\n\n1. [Go to the Spotify Dashboard](https://developer.spotify.com/dashboard).\n2. Create a new app to obtain your Client ID and Client Secret.\n3. In `Edit Settings`, add `http://localhost:21112/callback` to the `Redirect URIs`. Don’t forget to save your changes.\n4. Set your Client ID as an environment variable `SPOTIFY_ID`. \n5. Run sptui. You will see an official Spotify URL for authentication.\n\n```bash\n# Replace your_client_id with the actual Client ID you obtained from Spotify.\nSPOTIFY_ID=your_client_id sptui\n```\n6. Open the provided URL in a web browser and log in to your Spotify account to grant the necessary permissions.\nAfter granting permission, you might be redirected to a blank page. This is normal and indicates that the authentication process is complete.\n\nOnce authenticated, you are ready to use sptui!\n\n### API Token Storage\nOnce authenticated, your Spotify API token will be stored at `${HOME}/.config/sptui/spotify_token.json`. Ensure this file is kept secure as it contains sensitive information.\n\n### Key Bindings\nHere are the key bindings for sptui:\n\n| Key       | Action                           |\n|-----------|----------------------------------|\n| `h` `j` `k` `l` | Navigate (left, down, up, right) |\n| `esc`     | Return to the previous screen           |\n| `q`       | Quit sptui                       |\n| `:play`   | Play current selection           |\n| `:pause`  | Pause playback                   |\n| `:next`   | Next track                       |\n| `:prev`   | Previous track                   |\n| `:device` | Select a device                  |\n\n","funding_links":[],"categories":["\u003ca name=\"music\"\u003e\u003c/a\u003eSound and music"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fszktkfm%2Fsptui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fszktkfm%2Fsptui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fszktkfm%2Fsptui/lists"}