{"id":13740710,"url":"https://github.com/danjeltahko/spotify-tmux","last_synced_at":"2025-05-08T20:32:25.250Z","repository":{"id":200115864,"uuid":"704243678","full_name":"danjeltahko/spotify-tmux","owner":"danjeltahko","description":"Spotify plugin for tmux to add \u0026 start playing your favorite playlists \u0026 albums.","archived":false,"fork":false,"pushed_at":"2024-01-17T18:14:37.000Z","size":784,"stargazers_count":24,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-15T10:42:51.139Z","etag":null,"topics":["plugin","spotify","tmux"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/danjeltahko.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2023-10-12T21:05:36.000Z","updated_at":"2024-08-19T02:56:45.000Z","dependencies_parsed_at":null,"dependency_job_id":"0b68a939-af84-43ae-b3ec-52dfb8a74bda","html_url":"https://github.com/danjeltahko/spotify-tmux","commit_stats":null,"previous_names":["danjeltahko/spotify-tmux"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danjeltahko%2Fspotify-tmux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danjeltahko%2Fspotify-tmux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danjeltahko%2Fspotify-tmux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danjeltahko%2Fspotify-tmux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danjeltahko","download_url":"https://codeload.github.com/danjeltahko/spotify-tmux/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253145019,"owners_count":21861168,"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":["plugin","spotify","tmux"],"created_at":"2024-08-03T04:00:51.481Z","updated_at":"2025-05-08T20:32:24.745Z","avatar_url":"https://github.com/danjeltahko.png","language":"Shell","funding_links":[],"categories":["Plugins"],"sub_categories":[],"readme":"# Spotify Tmux Plugin\n\nControl Spotify directly from your tmux session. Compatible with macOS.\n\n![add playlist demo](./assets/demo.gif)\n\n## Features\n\n* Control basic Spotify functions like play, pause, next, and previous.\n* Toggle shuffle and repeat modes.\n* Bind Spotify playlists/albums/tracks to specific keys (1-9) for quick access.\n* Display currently playing track, artist, album, and playback state in the tmux status bar.\n* Configure your own keybindings.\n\n## Installation with Tmux Plugin Manager (TPM)\n\n1. Add the plugin to your tmux.conf:\n```bash\nset -g @plugin 'danjeltahko/spotify-tmux'\n```\n2. Press prefix + \u003ckbd\u003eI\u003c/kbd\u003e to install the plugin.\n\n## Usage\n\nOnce installed, you can use the key bindings to control Spotify. By default, the Spotify prefix is set to prefix + \u003ckbd\u003eS\u003c/kbd\u003e.\n\nPress the Spotify prefix followed by the configured keybinding:\n\n| Key | Action                     |\n|-----|----------------------------|\n| o   | Open Spotify               |\n| s   | Toggle shuffle             |\n| r   | Toggle repeat              |\n| p   | Play/Pause                 |\n| l   | Next track                 |\n| h   | Previous track             |\n| a   | Add a playlist             |\n| 1-9 | Play playlists 1 through 9 |\n| ?   | Show your saved playlists  |\n\n\u003e **Caution: When adding a new playlist/album with \u003ckbd\u003espotifyprefix+a\u003c/kbd\u003e, do not use \u003ckbd\u003e:\u003c/kbd\u003e in the naming.** *The playlist file separates the ID, name and Spotify link using \u003ckbd\u003e:\u003c/kbd\u003e. So using \u003ckbd\u003e:\u003c/kbd\u003e in the name will result in playback issues. Instead, please use \u003ckbd\u003e-\u003c/kbd\u003e for example.*\n\n## Configuration\n\nYou can customize keybindings and other settings by setting tmux options in your tmux.conf:\n\n```bash\nset -g @spotify-open \"o\"\nset -g @spotify-shuffle \"s\"\nset -g @spotify-open \"o\"\nset -g @spotify-shuffle \"s\"\nset -g @spotify-repeat \"r\"\nset -g @spotify-playpause \"p\"\nset -g @spotify-next \"l\"\nset -g @spotify-prev \"h\"\nset -g @spotify-add-playlist \"a\"\nset -g @spotify-show-playlists \"?\"\n```\nFor example, to change the key binding to prefix + \u003ckbd\u003eShift\u003c/kbd\u003e + \u003ckbd\u003eJ\u003c/kbd\u003e, you'd add:\n\n```bash\nset -g @spotifyprefix \"J\"\n```\n\n### Status Bar Options\n\nThe following options can be interpolated in `status-right` or `status-left`:\n\n- `#{spotify_track}`: Displays the currently playing track.\n- `#{spotify_artist}`: Displays the currently playing artist.\n- `#{spotify_album}`: Displays the currently playing album.\n- `#{spotify_state}`: Displays the Spotify state (shuffle, repeat).\n\nExample:\n```bash\nset -g status-right \"#{spotify_track} | #{spotify_artist} | #{spotify_album} | #{spotify_state}\"\n```\n\nYou can also customize the icons that represent each state by setting tmux options in tmux.conf.\n```bash\nset -g @spotify-shuffle-icon \"†\"\nset -g @spotify-playing-icon \"\"\nset -g @spotify-repeat-icon \"Ω\"\n```\n\n## Requirements\n* macOS with the Spotify application installed.\n* AppleScript support (osascript command available).\n* In order to have the icons displayed correctly please use / update your favorite [nerd font](https://www.nerdfonts.com/font-downloads).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanjeltahko%2Fspotify-tmux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanjeltahko%2Fspotify-tmux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanjeltahko%2Fspotify-tmux/lists"}