tmux-plugin-playerctl

A tmux plugin for using playerctl to display MPRIS meta-data about the music currently playing.

Pre-requisites

Make sure you have playerctl & bash installed.

# If you're in Arch
sudo pacman -S playerctl

See playerctl's instructions to get more details about installing it in other OS.

Installation

Installation with Tmux Plugin Manager (recommended)

Add plugin to the list of TPM plugins in .tmux.conf:

set -g @plugin 'richin13/tmux-plugin-playerctl'

Hit prefix + I to fetch the plugin and source it.

If format strings are added to status-right, they should now be visible.

Manual installation

Clone the repository

git clone https://github.com/richin13/tmux-plugin-playerctl ~/path/to/local/repo

Add the following line to your .tmux.conf:

run-shell ~/path/to/local/repo/playerctl.tmux

Usage

The currently available options are:

• #{playerctl_artist}: Display the song's artist information
• #{playerctl_title}: Display the song's title information
• #{playerctl_album}: Display the song's album information
• #{playerctl_full}: Display the song info in the format [Artist] - [Title]
• #{playerctl_short}: Display the song info in the format [Artist] - [Title] but trimmed to a max number of characters (default: 30)
• #{playerctl_status}: Display the player's status (default: Playing = ▶, Paused = ⏸, Stopped = ⏹)

Just add the desired option to your .tmux.conf like this:

set -g status-right   "#{playerctl_status} #{playerctl_full}"

Settings

Available settings for playerctl_short (shown values are the defaults):

#: Number of characters to show
set -g @short_length "30"

#: Character(s) to append at the end of the trimmed song name
set -g @short_append_chars "..."

Available settings for playerctl_status:

#: Shown values are the defaults

#: Character to show when the player is playing
set -g @status_playing "▶"

#: Character to show when the player is paused
set -g @status_paused "⏸"

#: Character to show when the player is stopped
set -g @status_stopped "⏹"

License

See LICENSE