{"id":13582058,"url":"https://github.com/owenthereal/spotctl","last_synced_at":"2025-08-21T01:32:10.921Z","repository":{"id":136954273,"uuid":"114968555","full_name":"owenthereal/spotctl","owner":"owenthereal","description":"A command-line interface to Spotify, written in Go","archived":false,"fork":false,"pushed_at":"2018-06-28T21:41:47.000Z","size":3650,"stargazers_count":242,"open_issues_count":11,"forks_count":16,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-08T01:42:00.821Z","etag":null,"topics":["cli","golang","spotify"],"latest_commit_sha":null,"homepage":null,"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/owenthereal.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}},"created_at":"2017-12-21T06:00:01.000Z","updated_at":"2025-02-11T21:33:46.000Z","dependencies_parsed_at":"2023-06-09T05:30:35.571Z","dependency_job_id":null,"html_url":"https://github.com/owenthereal/spotctl","commit_stats":null,"previous_names":["jingweno/spotctl"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/owenthereal/spotctl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owenthereal%2Fspotctl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owenthereal%2Fspotctl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owenthereal%2Fspotctl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owenthereal%2Fspotctl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/owenthereal","download_url":"https://codeload.github.com/owenthereal/spotctl/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owenthereal%2Fspotctl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271415022,"owners_count":24755628,"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","status":"online","status_checked_at":"2025-08-20T02:00:09.606Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["cli","golang","spotify"],"created_at":"2024-08-01T15:02:24.519Z","updated_at":"2025-08-21T01:32:10.555Z","avatar_url":"https://github.com/owenthereal.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# Spotctl\n\n`spotctl` is command-line interface to control Spotify from your favorite terminal.\n\n## Demo\n\nOne of the highlights is that `spotctl player` shows a real-time Spotify player that allows you to control it, right in your terminal!\n\n[![asciicast](https://asciinema.org/a/154262.png)](https://asciinema.org/a/154262)\n\n## Installation\n\n## Homebrew\n\nIf you're on a Mac, you can install with [Homebrew](https://brew.sh/):\n\n```\nbrew install https://raw.githubusercontent.com/jingweno/spotctl/master/Formula/spotctl.rb\n```\n\n## Download\n\nYou can download the latest release for your operating system [here](https://github.com/jingweno/spotctl/releases).\n\n## Manual Installation\n\n`spotctl` needs to connect to Spotify's API in order to control it.\nTo manually build it, you first need to sign up (or into) Spotify's developer site and [create an Application](https://developer.spotify.com/my-applications/#!/applications/create).\nOnce you've done so, you can find its Client ID and Client Secret values and run the following command:\n\n```\nSPOTIFY_CLIENT_ID=XXX SPOTIFY_CLIENT_SECRET=YYY ./bin/build\n```\n\n## Running\n\n**Please make sure the Spotify app is opened before running any `spotctl` commands**, since it talks to the Spotify API which in turns talks to the Spotify app in your local box.\nHere is a list of available commands:\n\n```\n$ spotctl -h\nA command-line interface to Spotify.\n\nUsage:\n  spotctl [command]\n\nAvailable Commands:\n  help        Help about any command\n  login       Login with your Spotify credentials\n  logout      Clear your local Spotify credentials\n  next        Skip to the next track\n  pause       Pause Spotify playback\n  play        Resume playback or play a track, album, artist or playlist by name\n  player      Show the live player panel\n  prev        Return to the previous track\n  repeat      Toggle repeat playback mode\n  shuffle     Toggle shuffle playback mode\n  status      Show the current player status\n  version     Show version.\n  vol         Set or return volume percentage\n\nFlags:\n  -h, --help   help for spotctl\n\nUse \"spotctl [command] --help\" for more information about a command.\n```\n\n## License\n\n[MIT](https://github.com/jingweno/spotctl/blob/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fowenthereal%2Fspotctl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fowenthereal%2Fspotctl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fowenthereal%2Fspotctl/lists"}