Skip to main content
Media widgets show information about currently playing music and provide optional remote control functionality.

​
Spotify TUI

Displays music information from spotify-tui (spt). Requires spotify-tui to be installed.

​
Basic configuration

set -g @dracula-plugins "spotify-tui"

​
Requirements

This widget requires spotify-tui to be installed and configured.

​
Options

​
@dracula-spotify-tui-format
string
default:"%f %s %t - %a"
Display format using spotify-tui format specifiers:
  • %f - Flags (playing/paused status)
  • %s - Playback state
  • %t - Track title
  • %a - Artist name
  • %b - Album name
  • %p - Current position
  • %d - Track duration
​
@dracula-spotify-tui-max-len
number
default:"0"
Maximum length of the displayed text. Set to 0 for unlimited length.
​
@dracula-refresh-rate
number
default:"5"
Update interval in seconds.

​
Usage examples

# Default format
set -g @dracula-plugins "spotify-tui"

# Custom format (artist - title)
set -g @dracula-spotify-tui-format "%a - %t"

# Limit display length
set -g @dracula-spotify-tui-max-len 40

# Update more frequently
set -g @dracula-refresh-rate 2

​
MPC

Displays music information from MPD (Music Player Daemon) via mpc.

​
Basic configuration

set -g @dracula-plugins "mpc"

​
Requirements

This widget requires MPD and mpc to be installed and configured.

​
Options

​
@dracula-mpc-format
string
default:"%title% - %artist%"
Display format using mpc format specifiers:
  • %title% - Track title
  • %artist% - Artist name
  • %album% - Album name
  • %track% - Track number
  • %time% - Track duration
  • %file% - File path
  • %position% - Position in playlist
​
@dracula-refresh-rate
number
default:"5"
Update interval in seconds.

​
Usage examples

# Default format
set -g @dracula-plugins "mpc"

# Show track number and title
set -g @dracula-mpc-format "%track%. %title%"

# Show all details
set -g @dracula-mpc-format "%artist% - %title% [%album%]"

​
Playerctl

Displays music information from any MPRIS-compatible media player via playerctl.

​
Basic configuration

set -g @dracula-plugins "playerctl"

​
Requirements

This widget requires playerctl to be installed. Works with Spotify, VLC, Chrome, Firefox, and other MPRIS-compatible players.

​
Options

​
@dracula-playerctl-format
string
default:"► {{ artist }} - {{ title }}"
Display format using playerctl format syntax:
  • {{ artist }} - Artist name
  • {{ title }} - Track title
  • {{ album }} - Album name
  • {{ status }} - Playback status
  • {{ position }} - Current position
  • {{ duration }} - Track duration
  • {{ playerName }} - Player name

​
Usage examples

# Default format with play icon
set -g @dracula-plugins "playerctl"

# Show player name
set -g @dracula-playerctl-format "{{ playerName }}: {{ title }}"

# Detailed format
set -g @dracula-playerctl-format "{{ artist }} - {{ title }} [{{ album }}]"

​
macOS player

Displays music from native macOS media players with optional remote control.

​
Basic configuration

set -g @dracula-plugins "mac-player"

​
Supported players

Native players:
  • Spotify
  • Apple Music
Browser players (requires Google Chrome or Safari):
  • youtube.com/watch
  • open.spotify.com
For browser players, the active tab must match one of the supported URLs.

​
Options

​
@dracula-mac-player-play-icon
string
default:"♪ "
Icon displayed when music is playing.
​
@dracula-mac-player-pause-icon
string
default:"❚❚ "
Icon displayed when music is paused.
​
@dracula-mac-player-length
number
default:"25"
Maximum length of the displayed text.
​
@dracula-mac-player-remote
boolean
default:"false"
Enable remote control functionality.
​
@dracula-mac-player-app
string
default:""
Specify which app to control: “Music” or “Spotify”.

​
Remote control options

​
@dracula-mac-player-remote-play-pause
string
default:"P"
Key binding for play/pause (used with prefix).
​
@dracula-mac-player-remote-back
string
default:"R"
Key binding for back/previous track (used with prefix).
​
@dracula-mac-player-remote-next
string
default:"N"
Key binding for next track (used with prefix).

​
Usage examples

# Basic display
set -g @dracula-plugins "mac-player"
set -g @dracula-mac-player-length 30

# Enable remote control for Spotify
set -g @dracula-mac-player-remote true
set -g @dracula-mac-player-app "Spotify"

# Custom icons and keybinds
set -g @dracula-mac-player-play-icon "▶ "
set -g @dracula-mac-player-pause-icon "⏸ "
set -g @dracula-mac-player-remote-play-pause "Space"
set -g @dracula-mac-player-remote-next "."
set -g @dracula-mac-player-remote-back ","

​
Default keybinds

When remote control is enabled:
  • <prefix> + P - Play/Pause
  • <prefix> + R - Back to position 0/previous track
  • <prefix> + N - Next track

​
Spotify player (spr)

Displays music information from spotify-player with optional remote control.

​
Basic configuration

set -g @dracula-plugins "spr"

​
Requirements

This widget requires spotify-player to be installed. For remote control, install spotify-player-daemon.

​
Options

​
@dracula-spr-play-icon
string
default:"♪ "
Icon displayed when music is playing.
​
@dracula-spr-pause-icon
string
default:"❚❚ "
Icon displayed when music is paused.
​
@dracula-spr-remote
boolean
default:"false"
Enable remote control functionality (requires spotify-player-daemon).
​
@dracula-refresh-rate
number
default:"5"
Update interval in seconds.

​
Remote control options

​
@dracula-spr-remote-play-pause
string
default:"P"
Key binding for play/pause (used with prefix).
​
@dracula-spr-remote-back
string
default:"R"
Key binding for back/previous track (used with prefix).
​
@dracula-spr-remote-next
string
default:"N"
Key binding for next track (used with prefix).

​
Usage examples

# Basic display
set -g @dracula-plugins "spr"

# Enable remote control
set -g @dracula-spr-remote true

# Custom icons and keybinds
set -g @dracula-spr-play-icon "▶ "
set -g @dracula-spr-pause-icon "⏸ "
set -g @dracula-spr-remote-play-pause "p"
set -g @dracula-spr-remote-next "n"
set -g @dracula-spr-remote-back "b"

# Faster updates
set -g @dracula-refresh-rate 2

​
Default keybinds

When remote control is enabled:
  • <prefix> + P - Play/Pause
  • <prefix> + R - Back to position 0/previous track
  • <prefix> + N - Next track
The remote control feature may limit widget display on macOS.

​
Complete example

# Spotify player with remote control
set -g @dracula-plugins "spr"

# Enable remote control
set -g @dracula-spr-remote true

# Custom icons
set -g @dracula-spr-play-icon "▶ "
set -g @dracula-spr-pause-icon "⏸ "

# Custom keybinds (Vim-style)
set -g @dracula-spr-remote-play-pause "Space"
set -g @dracula-spr-remote-next "l"
set -g @dracula-spr-remote-back "h"

# Update every 2 seconds
set -g @dracula-refresh-rate 2

# Styling
set -g @dracula-spr-colors "pink dark_gray"

​
Tips for media widgets

Only enable one media widget at a time unless you use multiple music players simultaneously. Each widget checks for its specific player and displays nothing if the player isn’t running.
Use shorter format strings or set maximum lengths to prevent long song titles from taking too much status bar space.

Build docs developers (and LLMs) love

Get started for freeTalk to us