{"id":21001716,"url":"https://github.com/v4lli/rspotify","last_synced_at":"2025-09-04T06:38:37.382Z","repository":{"id":145948720,"uuid":"8662931","full_name":"v4lli/rspotify","owner":"v4lli","description":"UNIX Spotify Remote (plus opt. Mac OS Server) ","archived":false,"fork":false,"pushed_at":"2013-09-16T15:36:21.000Z","size":102,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-13T13:44:47.755Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"wtfpl","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/v4lli.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}},"created_at":"2013-03-09T00:43:55.000Z","updated_at":"2024-07-05T16:51:17.000Z","dependencies_parsed_at":"2023-03-23T11:05:23.399Z","dependency_job_id":null,"html_url":"https://github.com/v4lli/rspotify","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/v4lli/rspotify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v4lli%2Frspotify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v4lli%2Frspotify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v4lli%2Frspotify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v4lli%2Frspotify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/v4lli","download_url":"https://codeload.github.com/v4lli/rspotify/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v4lli%2Frspotify/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273567093,"owners_count":25128630,"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-09-04T02:00:08.968Z","response_time":61,"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":[],"created_at":"2024-11-19T08:16:16.759Z","updated_at":"2025-09-04T06:38:37.340Z","avatar_url":"https://github.com/v4lli.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"rspotify - a UNIX remote to Spotify\n====================\n\nThe shell script `rspotify` basically uses netcat to communicate with a remote host running a compatible server.\n\nSome may call this a dirty hack. I kept the client clean and compliant though (as far as you can say that with the netcat stuff, lol).\n\n![In Action](http://unimplemented.org/~valentin/rspotify.png)\n\n## Functionality\nIt doesn't use much of a protocol, except maybe TCP if you count that. Binary operations like skipping a track are done in a *binary* fashion, i.e. connecting to the respective TCP port skips to the next song.\n\nThe only real data returned is the current track, artist and album. It's formating is left to the server.\n\nThis was written for Hackathons and get-togethers where 1\u003c *nix affine people want to influence the current (Spotify) playlist connected to the big speakers.\n\n## Installation\nActually there isn't much installation required.\n\n### On the client\n...you need nothing but the rspotify script itself (and Linux, *BSD, Mac OS...). Copy it somewhere you like (preferably somewhere in your $PATH) and execute it.\n\nIt takes only two arguments. The first one is the IP of the server and the second one is the base port configured on the server (by default 21337. *What else.*).\n\n**Example**: `./rspotify 10.0.0.144 21337`\n\nYou will be asked if you want to save the two parameters so you can just use `rspotify` in the future. If you agree, those will be written to `~/.rspotifyrc`.\n\n### On the server\n\n... well, it's a little less *free* here. Until now, this repository only contains a Mac OS version. If you have a somewhat recent version of Mac OS X and Spotify installted, just navigate to the `server/` directory  and execute `./rspotify_server`. Oh, and you need to have `tmux` installed for this \"hacky\" version of a \"server\". [Get it from Brew](http://mxcl.github.com/homebrew/), for example: `brew install tmux`\n\n## Props\nTo [younix](http://github.com/younix/) for the idea, to Conceited Software for providing parts of the *Apple-Script-Spotify-Interface* and to my unbeatable commitment to procrastination.\n\nMy actual [home is inside this gitweb](http://unimplemented.org/gitweb/), but please feel free to send any pull requests here. They're very welcome and will be noticed.\n\nThis is free software, do whatever the hell you want to do with it. If you need help see my profile, you'll figure out how to reach me. :)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fv4lli%2Frspotify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fv4lli%2Frspotify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fv4lli%2Frspotify/lists"}