/tmux-spotify-widget

🎧 Spotify plugin for tmux

Primary LanguageShellMIT LicenseMIT

Spotify plugin for tmux (forked)

GitHub

Show a nice menu to manage the Spotify application.

tmux-spotify

Fork of tmux-spotify. Renamed to avoid conflict with another spotify tmux plgin on TPM and to override the default keybinding of prefix + s, which should be reserved for opening the session management window in tmux.

Installation

Requirements

  • macOS
  • tmux >= 3.0

With Tmux Plugin Manager

Add the plugin in .tmux.conf:

set -g @plugin 'camin-mccluskey/tmux-spotify-widget'

Press prefix + I to fetch the plugin and source it. Done.

Manual

Clone the repo somewhere. Add run-shell in the end of .tmux.conf:

run-shell PATH_TO_REPO/tmux-spotify.tmux

NOTE: this line should be placed after set-option -g status-right ....

Press prefix + : and type source-file ~/.tmux.conf. Done.

Usage

Press tmux prefix + S (for example, C-b S) and you will see a nice menu:

tmux-spotify

* Copy URL        (c) - copy Spotify URL of the current track to the clipboard
* Open Spotify    (o) - open/launch Spotify
* Play/Pause      (p) - toggle play/pause
* Previous        (b) - play the current track from the beggining or play the previous track
* Next            (n) - play the next track
* Turn on repeat  (r) - switch on/off current playlist's repeating
* Turn on shuffle (s) - switch on/off current playlist's shuffling
* Close menu      (q) - close menu

Configuring the binding

The binding may be configured via your .tmux.conf as:

set -g @spotifybinding 'X'

Other plugins

License

tmux-spotify plugin is released under the MIT License.