Skip to main content
This page provides a comprehensive reference of all widgets available in Dracula tmux. Each widget can be added to your status bar by including its name in the @dracula-plugins configuration option.
The order you define plugins in @dracula-plugins determines their order on the status bar from left to right.

​
Alphabetical widget reference

Description: Displays the number of clients attached to the current tmux session.
​
@dracula-clients-minimum
number
default:"1"
Set the minimum number of clients to show (otherwise, show nothing)
​
@dracula-clients-singular
string
default:"client"
Set the label when there is one client
​
@dracula-clients-plural
string
default:"clients"
Set the label when there are multiple clients
Example:
set -g @dracula-plugins "attached-clients"
set -g @dracula-clients-minimum 1
set -g @dracula-clients-singular client
set -g @dracula-clients-plural clients
Description: Provides information about battery charge level, charging status, and AC power connection. Detects when running on desktop PCs with no battery.
​
@dracula-battery-label
string
default:"Battery"
Display any icon or text for the battery label. Set to false to use only Nerd Font icons.
​
@dracula-show-battery-status
boolean
default:"false"
Use Nerd Font icons to display battery charge level and charging status
​
@dracula-no-battery-label
string
default:"No Battery"
Text to display when no battery is detected. Set to false to hide the widget entirely.
​
@dracula-battery-separator
string
default:" "
Separator between multiple batteries
Icons when using @dracula-show-battery-status:
  • Discharging: 󰂎 󰁺 󰁻 󰁼 󰁽 󰁾 󰁿 󰂀 󰂁 󰂂 󰁹
  • Charging: 󰢟 󰢜 󰂆 󰂇 󰂈 󰢝 󰂉 󰢞 󰂊 󰂋 󰂅
  • AC only:
  • Unknown:
Example:
set -g @dracula-plugins "battery"
set -g @dracula-battery-label "🦇 "
set -g @dracula-show-battery-status true
For multiple batteries, split labels with \n: set -g @dracula-battery-label "1:\n2:"
Description: Allows switching to an alternate list of widgets when the terminal becomes narrow. Useful for responsive layouts.
​
@dracula-narrow-plugins
string
required
Space-separated list of plugins to show in narrow mode. Must include compact-alt to switch back.
​
@dracula-compact-min-width
number
default:"140"
Terminal width threshold below which narrow mode activates
​
@dracula-config-path
string
required
Path to your tmux config file (needed to reload config when switching)
​
@dracula-compact-alt-verbose
boolean
default:"false"
Show window width and whether narrow mode is active
Never manually set @dracula-narrow-mode - this is managed automatically by the widget.
Example:
set -g @dracula-plugins "compact-alt battery network weather"
set -g @dracula-narrow-plugins "compact-alt battery network"
set -g @dracula-compact-min-width 140
set -g @dracula-config-path "$HOME/.config/tmux/tmux.conf"
Description: Shows tmux-continuum save status and timing information.
​
@dracula-continuum-mode
string
default:"countdown"
Output mode. Options:
  • countdown: T- countdown to next save
  • time: Time since last save
  • alert: Hide if no recent save
  • interval: Show continuum save interval
​
@dracula-continuum-time-threshold
number
default:"15"
Seconds threshold for showing last save in alert mode
Example:
set -g @dracula-plugins "continuum"
set -g @dracula-continuum-mode countdown
set -g @dracula-continuum-time-threshold 60
Description: Displays the CPU architecture (e.g., x86_64, arm64).
​
@dracula-cpu-arch-label
string
default:""
Label or icon to display before the CPU architecture
Example:
set -g @dracula-plugins "cpu-arch"
set -g @dracula-cpu-arch-label "󰍛 "
Description: Displays CPU usage as percentage or load average (Linux only).
​
@dracula-cpu-display-load
boolean
default:"false"
Display load average instead of percentage (Linux only). Shows 1, 5, and 15 minute averages.
​
@dracula-cpu-usage-label
string
default:"CPU"
Label or icon to display before CPU usage
Affected by global @dracula-refresh-rate setting.
Suggested Nerd Font icons: 󰻟 󰻠 󰍛 󰘚Example:
set -g @dracula-plugins "cpu-usage"
set -g @dracula-cpu-usage-label " "
set -g @dracula-cpu-display-load true
Description: Displays the current working directory path, with home directory shortened to ~.
​
@dracula-cwd-max-dirs
number
default:"0"
Maximum number of directories to display (0 = unlimited)
​
@dracula-cwd-max-chars
number
default:"0"
Maximum number of characters to display (0 = unlimited)
Example:
set -g @dracula-plugins "cwd"
set -g @dracula-cwd-max-dirs 3
set -g @dracula-cwd-max-chars 50
Description: Displays information about the current Fossil repository.
This widget is currently under development.
Description: Displays information about the current Git repository, including branch name, changes, and sync status.
​
@dracula-git-disable-status
boolean
default:"false"
Hide details of Git changes
​
@dracula-git-show-current-symbol
string
default:"✓"
Symbol to show when branch is up to date with HEAD
​
@dracula-git-show-diff-symbol
string
default:"!"
Symbol to show when branch diverges from HEAD
​
@dracula-git-no-repo-message
string
default:""
Message to show when pane has no Git repository
​
@dracula-git-no-untracked-files
boolean
default:"false"
Hide untracked files from local changes count
​
@dracula-git-show-remote-status
boolean
default:"false"
Show remote tracking branch with diverge/sync state
​
@dracula-git-show-repo-name
boolean
default:"false"
Show repository name in status bar
Avoid using bash special characters like $, *, and ! in symbol settings.
Example:
set -g @dracula-plugins "git"
set -g @dracula-git-show-current-symbol ✓
set -g @dracula-git-show-remote-status true
set -g @dracula-git-show-repo-name true
Description: Displays GPU computational usage. Part of the GPU info widget family.
​
@dracula-force-gpu
string
Force detection of specific GPU brand (e.g., “NVIDIA”). Use if auto-detection fails.
​
@dracula-gpu-usage-label
string
default:"GPU"
Label or icon to display before GPU usage
Hardware support:
  • Full support: NVIDIA GPUs on Linux with official drivers
  • Partial support: Apple M-chips on macOS, AMD and Intel on Linux
Affected by global @dracula-refresh-rate setting.
Suggested Nerd Font icons: 󰢮Example:
set -g @dracula-plugins "gpu-usage"
set -g @dracula-gpu-usage-label "󰢮 "
Description: Displays GPU VRAM usage. Part of the GPU info widget family.
​
@dracula-gpu-vram-percent
boolean
default:"false"
Display VRAM usage as percentage instead of GB
​
@dracula-gpu-vram-used-accuracy
string
default:".0f"
Decimal places for used VRAM (e.g., “.2f” for 2 decimal places)
​
@dracula-gpu-vram-total-accuracy
string
default:".0f"
Decimal places for total VRAM (e.g., “.1f” for 1 decimal place)
​
@dracula-gpu-vram-label
string
default:"VRAM"
Label or icon to display before VRAM usage
Example:
set -g @dracula-plugins "gpu-ram-usage"
set -g @dracula-gpu-vram-label "󰢮 "
set -g @dracula-gpu-vram-used-accuracy ".2f"
Description: Displays GPU power consumption. Part of the GPU info widget family.
​
@dracula-gpu-power-percent
boolean
default:"false"
Display power usage as percentage instead of watts
​
@dracula-gpu-power-label
string
default:"Power"
Label or icon to display before power draw
Example:
set -g @dracula-plugins "gpu-power-draw"
set -g @dracula-gpu-power-label "󰢮 "
Description: Displays information about the current Mercurial (hg) repository.
​
@dracula-hg-disable-status
boolean
default:"false"
Hide details of Mercurial changes
​
@dracula-hg-show-current-symbol
string
default:"✓"
Symbol to show when branch is up to date with HEAD
​
@dracula-hg-show-diff-symbol
string
default:"!"
Symbol to show when branch diverges from HEAD
​
@dracula-hg-no-repo-message
string
default:""
Message to show when pane has no Mercurial repository
​
@dracula-hg-no-untracked-files
boolean
default:"false"
Hide untracked files from local changes count
Example:
set -g @dracula-plugins "hg"
set -g @dracula-hg-show-current-symbol ✓
Description: Displays Kerberos TGT (Ticket Granting Ticket) expiration information.
​
@dracula-krbtgt-principal
string
required
The principal to check TGT expiration for (with or without REALM)
Example:
set -g @dracula-plugins "krbtgt"
set -g @dracula-krbtgt-principal "principal"
Description: Displays the current Kubernetes context.
​
@dracula-kubernetes-context-label
string
default:""
Prefix label before the context name
​
@dracula-kubernetes-hide-user
boolean
default:"false"
Hide user from the context string
​
@dracula-kubernetes-eks-hide-arn
boolean
default:"false"
Show only cluster name, hiding ARN (EKS only)
​
@dracula-kubernetes-eks-extract-account
boolean
default:"false"
Extract AWS account as prefix to cluster name (EKS only)
Example:
set -g @dracula-plugins "kubernetes-context"
set -g @dracula-kubernetes-context-label "☸ "
set -g @dracula-kubernetes-hide-user true
Description: Retrieves and displays continuous glucose monitoring (CGM) data from the LibreView API. Caches data to minimize API requests and shows latest glucose level with trend indicator.
See the libreview script in the scripts/libre.sh file for setup instructions.
Example:
set -g @dracula-plugins "libreview"
Description: Displays music information from native macOS players including Spotify, Apple Music, and browser players (YouTube, Spotify web).
​
@dracula-mac-player-play-icon
string
default:"♪ "
Icon to display when music is playing
​
@dracula-mac-player-pause-icon
string
default:"❚❚ "
Icon to display 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 keybindings
​
@dracula-mac-player-app
string
Specify app to control: “Music” or “Spotify”
​
@dracula-mac-player-remote-play-pause
string
default:"P"
Keybind for play/pause (prefix + key)
​
@dracula-mac-player-remote-back
string
default:"R"
Keybind for previous track (prefix + key)
​
@dracula-mac-player-remote-next
string
default:"N"
Keybind for next track (prefix + key)
Supported players:
  • Native: Spotify, Apple Music
  • Browser: YouTube (youtube.com/watch), Spotify Web (open.spotify.com) - requires Chrome or Safari
Example:
set -g @dracula-plugins "mac-player"
set -g @dracula-mac-player-remote true
set -g @dracula-mac-player-app "Spotify"
Description: Displays music information from Music Player Daemon (mpd) via mpc.
​
@dracula-mpc-format
string
default:"%title% - %artist%"
Format string for displayed music information
Affected by global @dracula-refresh-rate setting.
Example:
set -g @dracula-plugins "mpc"
set -g @dracula-mpc-format "%title% - %artist%"
Description: Displays network connection status: offline, ethernet connected, or WiFi with SSID. By default, only displays WiFi with internet access.
​
@dracula-network-hosts
string
default:"1.1.1.1 8.8.8.8"
Space-separated list of hosts to ping for connectivity check. Use local IPs to detect networks without internet.
​
@dracula-network-ethernet-label
string
default:"Eth"
Label or icon for ethernet connections
​
@dracula-network-offline-label
string
default:"Offline"
Label or icon when offline
​
@dracula-network-wifi-label
string
default:"WiFi"
Label or icon for WiFi connections
Suggested Nerd Font icons:
  • Ethernet: 󰈀 󰒪 󰒍 󰌗 󰌘
  • Offline: 󰖪 󱍢
  • WiFi: 󰖩 󰘊 󰒢
If iw is only in root’s PATH, WiFi connections may be detected as ethernet.
Example:
set -g @dracula-plugins "network"
set -g @dracula-network-ethernet-label "󰈀 Eth"
set -g @dracula-network-wifi-label " "
Description: Displays current upload and download speeds per second for a network interface.
​
@dracula-network-bandwidth
string
required
Network interface to monitor (e.g., “eth0”, “wlan0”, “eno0”)
​
@dracula-network-bandwidth-show-interface
boolean
default:"false"
Display the interface name alongside speeds
​
@dracula-network-bandwidth-interval
number
Refresh interval in seconds (checks as frequently as possible by default)
Example:
set -g @dracula-plugins "network-bandwidth"
set -g @dracula-network-bandwidth "wlan0"
set -g @dracula-network-bandwidth-show-interface true
set -g @dracula-network-bandwidth-interval 5
Description: Displays current ping latency to a specified server.
​
@dracula-ping-server
string
default:"google.com"
Server hostname or IP address to ping
​
@dracula-ping-rate
number
default:"5"
How often to ping, in seconds
Example:
set -g @dracula-plugins "network-ping"
set -g @dracula-ping-server "google.com"
set -g @dracula-ping-rate 5
Description: Displays your public IP address by querying ifconfig.me.
​
@dracula-network-public-ip-label
string
default:""
Label or icon to display before the IP address
Suggested Nerd Font icon: 󰖟Example:
set -g @dracula-plugins "network-public-ip"
set -g @dracula-network-public-ip-label "󰖟 "
Description: Displays whether a VPN connection is active. Fully supports Tailscale exit nodes on Linux and macOS.
​
@dracula-network-vpn-verbose
boolean
default:"false"
Show VPN IP address or Tailscale exit node name
​
@dracula-network-vpn-label
string
default:"VPN"
Label or icon to display for VPN status
Suggested Nerd Font icon: 󰌘Example:
set -g @dracula-plugins "network-vpn"
set -g @dracula-network-vpn-verbose true
set -g @dracula-network-vpn-label "󰌘 "
Description: Displays music information from playerctl.
​
@dracula-playerctl-format
string
default:"► {{ artist }} - {{ title }}"
Format string for playerctl metadata display
Example:
set -g @dracula-plugins "playerctl"
set -g @dracula-playerctl-format "►  {{ artist }} - {{ title }}"
Description: Displays system RAM usage in GB.
​
@dracula-ram-usage-label
string
default:"RAM"
Label or icon to display before RAM usage
Suggested Nerd Font icons: 󰍛 󰘚Example:
set -g @dracula-plugins "ram-usage"
set -g @dracula-ram-usage-label " "
Description: Displays music information from spotify-tui. Requires spotify-tui to be installed.
​
@dracula-spotify-tui-format
string
default:"%f %s %t - %a"
Format string for spotify-tui display
​
@dracula-spotify-tui-max-len
number
default:"0"
Maximum display length (0 = unlimited)
Affected by global @dracula-refresh-rate setting.
Example:
set -g @dracula-plugins "spotify-tui"
set -g @dracula-spotify-tui-format "%t - %a"
set -g @dracula-spotify-tui-max-len 30
Description: Displays music information from spotify-player. Requires spotify-player to be installed. Includes experimental remote control feature.
​
@dracula-spr-play-icon
string
default:"♪ "
Icon to display when music is playing
​
@dracula-spr-pause-icon
string
default:"❚❚ "
Icon to display when music is paused
​
@dracula-spr-remote
boolean
default:"false"
Enable remote control keybindings (requires spotify-player-daemon)
​
@dracula-spr-remote-play-pause
string
default:"P"
Keybind for play/pause (prefix + key)
​
@dracula-spr-remote-back
string
default:"R"
Keybind for previous track (prefix + key)
​
@dracula-spr-remote-next
string
default:"N"
Keybind for next track (prefix + key)
Affected by global @dracula-refresh-rate setting.
Remote feature is experimental and may limit widget display on macOS.
Example:
set -g @dracula-plugins "spr"
set -g @dracula-spr-remote true
Description: Displays current username@host combination, both locally and when connected via SSH.
​
@dracula-show-ssh-only-when-connected
boolean
default:"false"
Hide widget when not connected via SSH
​
@dracula-show-ssh-session-port
boolean
default:"false"
Show SSH session port number
Suggested Nerd Font icons: 󰣀Example:
set -g @dracula-plugins "ssh-session"
set -g @dracula-show-ssh-only-when-connected true
set -g @dracula-show-ssh-session-port true
Description: Displays whether tmux panes are currently synchronized.
​
@dracula-synchronize-panes-label
string
default:"Sync"
Label to display for synchronized panes
​
@dracula-synchronize-panes-refresh-rate
number
Custom refresh rate for this widget only (overrides global rate)
​
@dracula-synchronize-panes-auto-hide
boolean
default:"false"
Automatically hide label when sync is off
Widget-specific refresh rate only affects this widget, not the global @dracula-refresh-rate.
Example:
set -g @dracula-plugins "synchronize-panes"
set -g @dracula-synchronize-panes-label "Sync"
set -g @dracula-synchronize-panes-auto-hide true
set -g @dracula-synchronize-panes-refresh-rate 0.5
Description: Displays the system temperature.Example:
set -g @dracula-plugins "sys-temp"
Description: Displays Terraform workspace information.
​
@dracula-terraform-label
string
default:""
Label or icon to display before Terraform info
Affected by global @dracula-refresh-rate setting.
This widget is currently under development.
Example:
set -g @dracula-plugins "terraform"
set -g @dracula-terraform-label ""
Description: Displays current date and time with customizable format.
​
@dracula-show-timezone
boolean
default:"true"
Show timezone in display
​
@dracula-day-month
boolean
default:"false"
Swap date format to day/month instead of month/day
​
@dracula-military-time
boolean
default:"false"
Use 24-hour time format
​
@dracula-time-format
string
Custom time format string (e.g., “%F %R” for “2023-01-01 14:00”)
See the date man page for format symbols.
Example:
set -g @dracula-plugins "time"
set -g @dracula-military-time true
set -g @dracula-show-timezone false
set -g @dracula-time-format "%F %R"
Description: Displays RAM currently used by the tmux server process.
​
@dracula-tmux-ram-usage-label
string
default:""
Label or icon to display before tmux RAM usage
Suggested Nerd Font icons: 󰍛 󰘚Example:
set -g @dracula-plugins "tmux-ram-usage"
set -g @dracula-tmux-ram-usage-label " "
Description: Shows how long the system has been running.
​
@dracula-uptime-label
string
default:""
Label or icon to display before uptime
Suggested Nerd Font icon: 󱎫Example:
set -g @dracula-plugins "uptime"
set -g @dracula-uptime-label "󱎫 "
Description: Displays weather information for a specified location with temperature and forecast icon.
​
@dracula-show-fahrenheit
boolean
default:"true"
Use Fahrenheit instead of Celsius
​
@dracula-fixed-location
string
Manually set location (city name)
​
@dracula-show-location
boolean
default:"true"
Show location name in display
​
@dracula-weather-hide-errors
boolean
default:"false"
Hide error messages (prints empty string instead of “Weather Unavailable”)
Forecast icons: ☀ (sunny), ☁ (cloudy), ☂ (rainy), ❄ (snowy)
Combine with @dracula-show-empty-plugins false to hide the widget when errors occur.
Example:
set -g @dracula-plugins "weather"
set -g @dracula-show-fahrenheit false
set -g @dracula-fixed-location "Tokyo"
set -g @dracula-weather-hide-errors true
Description: Run custom bash scripts as widgets.To create a custom widget:
  1. Place your bash script in the scripts directory of the dracula/tmux plugin
  2. Add it to @dracula-plugins as custom:script-name.sh
Example:
# Create custom script at: ~/.tmux/plugins/tmux/scripts/my-widget.sh
set -g @dracula-plugins "custom:my-widget.sh"
Custom scripts are useful for testing new widget ideas or integrating project-specific information.

​
Per-widget color customization

Each widget’s foreground and background colors can be customized: 
# Available colors: white, gray, dark_gray, light_purple, dark_purple, cyan, green, orange, red, pink, yellow
set -g @dracula-[plugin-name]-colors "[background] [foreground]"

# Example:
set -g @dracula-cpu-usage-colors "pink dark_gray"
For advanced color theming, see the Color theming documentation.

Build docs developers (and LLMs) love

Get started for freeTalk to us