{"id":13550386,"url":"https://github.com/hnarayanan/shpotify","last_synced_at":"2025-05-14T06:11:22.910Z","repository":{"id":6894736,"uuid":"8144412","full_name":"hnarayanan/shpotify","owner":"hnarayanan","description":"A command-line interface to Spotify.","archived":false,"fork":false,"pushed_at":"2025-02-02T19:46:50.000Z","size":149,"stargazers_count":2030,"open_issues_count":45,"forks_count":152,"subscribers_count":24,"default_branch":"main","last_synced_at":"2025-04-12T20:43:24.056Z","etag":null,"topics":["applescript","bash","command-line","macos","music","shell","spotify","utility"],"latest_commit_sha":null,"homepage":"https://harishnarayanan.org/projects/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hnarayanan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"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},"funding":{"github":"hnarayanan"}},"created_at":"2013-02-11T19:08:44.000Z","updated_at":"2025-04-11T05:32:58.000Z","dependencies_parsed_at":"2023-01-13T14:09:36.616Z","dependency_job_id":"491d3521-de11-4d05-b61e-f4ac42f02f30","html_url":"https://github.com/hnarayanan/shpotify","commit_stats":{"total_commits":142,"total_committers":31,"mean_commits":4.580645161290323,"dds":0.5422535211267605,"last_synced_commit":"b51c0bed1c5fed5e328d27ea41ea186b2932fd27"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hnarayanan%2Fshpotify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hnarayanan%2Fshpotify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hnarayanan%2Fshpotify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hnarayanan%2Fshpotify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hnarayanan","download_url":"https://codeload.github.com/hnarayanan/shpotify/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254079852,"owners_count":22011270,"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":["applescript","bash","command-line","macos","music","shell","spotify","utility"],"created_at":"2024-08-01T12:01:32.441Z","updated_at":"2025-05-14T06:11:22.846Z","avatar_url":"https://github.com/hnarayanan.png","language":"Shell","funding_links":["https://github.com/sponsors/hnarayanan"],"categories":["Shell"],"sub_categories":[],"readme":"# shpotify\n\n*shpotify* is a simple Bash/Apple script to control\n [Spotify](https://www.spotify.com) from the command line on a Mac.\n\nIf you find this interesting, you should [follow me on\nTwitter](https://twitter.com/copingbear) to learn about the other\nthings I do.\n\n## Installation\n\n[Download and install](http://www.spotify.com/download) the Spotify\ndesktop application if you haven’t already.\n\n### With Homebrew\n\nThe easiest way to install shpotify is by using the [Homebrew package\nmanager](http://brew.sh):\n\n````\nbrew install shpotify\n````\n\n### Manual installation\n\nIf you don’t use Homebrew, you can install the script manually by\nfollowing a few simple steps:\n\n1. Fetch a copy of this repository, either with git or [download the\n   zip archive](https://github.com/hnarayanan/shpotify/archive/master.zip).\n\n2. Navigate to the folder where you fetched the repository (unzip if\n   needed) and make sure the file called `spotify` is executable:\n   ````\n   cd shpotify\n   chmod +x spotify\n   ````\n\n3. Copy the file `spotify` to a convenient location in your `PATH`, or\n   set your `PATH` to include the folder where the file is located.\n\n### Connecting to Spotify’s API\n\nshpotify needs to connect to Spotify’s API in order to find music by\nname. It is very likely you want this feature!\n\nTo get this to work, you first need to sign up (or into) Spotify’s\ndeveloper site and [create an *Application*][spotify-dev]. Once you’ve\ndone so, you can find its `Client ID` and `Client Secret` values and\nenter them into your shpotify config file at `${HOME}/.shpotify.cfg`.\n\nBe sure to quote your values and don’t add any extra spaces. When\ndone, it should look like the following (but with your own values):\n\n````\nCLIENT_ID=\"abc01de2fghijk345lmnop\"\nCLIENT_SECRET=\"qr6stu789vwxyz\"\n````\n\n## Usage\n\nWith shpotify you can control Spotify with the following commands:\n````\nspotify play                       Resumes playback where Spotify last left off.\nspotify play \u003csong name\u003e           Finds a song by name and plays it.\nspotify play album \u003calbum name\u003e    Finds an album by name and plays it.\nspotify play artist \u003cartist name\u003e  Finds an artist by name and plays it.\nspotify play list \u003cplaylist name\u003e  Finds a playlist by name and plays it.\nspotify play uri \u003curi\u003e             Play songs from specific uri.\n\nspotify next                       Skips to the next song in a playlist.\nspotify prev                       Returns to the previous song in a playlist.\nspotify replay                     Replays the current track from the beginning.\nspotify pos \u003ctime\u003e                 Jump to a specific time (in seconds) in the current song.\nspotify pause                      Pauses (or resumes) Spotify playback.\nspotify stop                       Stops playback.\nspotify quit                       Stops playback and quits Spotify.\n\nspotify vol up                     Increases the volume by 10%.\nspotify vol down                   Decreases the volume by 10%.\nspotify vol \u003camount\u003e               Sets the volume to an amount between 0 and 100.\nspotify vol [show]                 Shows the current volume.\n\nspotify status                     Shows the play status, including the current song details.\nspotify status artist              Shows the currently playing artist.\nspotify status album               Shows the currently playing album.\nspotify status track               Shows the currently playing track.\n\nspotify share                      Displays the current song's Spotify URL and URI.\nspotify share url                  Displays the current song's Spotify URL and copies it to the clipboard.\nspotify share uri                  Displays the current song's Spotify URI and copies it to the clipboard.\n\nspotify toggle shuffle             Toggles shuffle playback mode.\nspotify toggle repeat              Toggles repeat playback mode.\n````\n\n## Authors and contributing\n\nshpotify is primarily written and maintained by [Harish\nNarayanan](https://harishnarayanan.org).\n\nSince it’s an open source project, it contains numerous contributions\nfrom many helpful people, including:\n\n* Jorge Colindres\n* Thomas Pritchard\n* iLan Epstein\n* Gabriele Bonetti\n* Sean Heller\n* Eric Martin\n* Peter Fonseca\n\nIf you’re interested in contributing too, please consider addressing\nsome of the [issues people have previously\nreported](https://github.com/hnarayanan/shpotify/issues) and\n[submitting a pull\nrequest](https://help.github.com/articles/using-pull-requests/). **Thank\nyou!**\n\n## Copyright and license\n\nCopyright (c) 2012–2025 [Harish Narayanan](https://harishnarayanan.org).\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n\n[spotify-dev]: https://developer.spotify.com/dashboard/create\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhnarayanan%2Fshpotify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhnarayanan%2Fshpotify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhnarayanan%2Fshpotify/lists"}