tmux-mpris

A tmux plugin that displays now-playing media info in the status bar using MPRIS via playerctl. Features catppuccin-style formatting.

Requirements

• Linux
• tmux 2.1+
• bash 4.0+
• playerctl

Installation

Using TPM (recommended)

Add to your ~/.tmux.conf:

set -g @plugin 'odtgit/tmux-mpris'

Then press prefix + I to install.

Manual

Clone the repository:

git clone https://github.com/odtgit/tmux-mpris ~/.tmux/plugins/tmux-mpris

Add to your ~/.tmux.conf:

run-shell ~/.tmux/plugins/tmux-mpris/mpris.tmux

Usage

Add the #{now_playing} placeholder to your status bar:

set -g status-right "#{now_playing}"

The widget displays the currently playing track from any MPRIS-compatible player (Spotify, Firefox, VLC, etc.).

Configuration

All options use catppuccin mocha colors as defaults.

Option	Default	Description
@mpris_icon	󰎆	Icon displayed in the widget
@mpris_icon_bg	#a6e3a1	Icon background color
@mpris_icon_fg	#11111b	Icon foreground color
@mpris_text_bg	#313244	Text background color
@mpris_text_fg	#cdd6f4	Text foreground color
@mpris_max_length	40	Maximum length of track info

Example configuration:

set -g @mpris_icon "♪"
set -g @mpris_max_length "30"

How It Works

The plugin uses playerctl to query MPRIS-compatible media players. It finds the first player that is currently playing and displays the artist and track title.

Results are cached for 2 seconds to minimize overhead.

License

MIT