Skip to main content

​
Window flags

Tmux uses window flags to indicate the status of windows (current, last, zoomed, etc.). You can enable or disable these flags in the status bar.
​
@dracula-show-flags
boolean
default:"false"
Display tmux window flags in the status bar.Window flags include:
  • * - Current window
  • - - Last window
  • # - Window activity
  • ! - Window bell
  • ~ - Window silence
  • Z - Window zoomed
set -g @dracula-show-flags true

​
Refresh rate

Control how frequently the status bar updates. This affects dynamic plugins that display changing information like CPU usage, GPU stats, memory usage, and music players.
​
@dracula-refresh-rate
number
default:"5"
The refresh rate for the status bar in seconds. Can accept any number.Affects these plugins:
  • cpu-usage
  • gpu-usage, gpu-ram-usage, gpu-power-draw
  • mpc
  • spotify-tui
  • spr
  • terraform
  • synchronize-panes
# Update every 5 seconds (default)
set -g @dracula-refresh-rate 5

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

# Update less frequently to reduce CPU usage
set -g @dracula-refresh-rate 10
Increasing the refresh rate (using a smaller number) provides more real-time data but uses more CPU resources.

​
Border contrast

Enable high contrast for pane borders to make them more visible.
​
@dracula-border-contrast
boolean
default:"false"
Enable high contrast pane borders for better visibility when working with multiple panes.
set -g @dracula-border-contrast true

​
Empty plugins

Control whether plugins should display when they have no data.
​
@dracula-show-empty-plugins
boolean
default:"true"
Hide plugins when they return no data. Useful for keeping your status bar clean.For example, the git plugin won’t show when not in a git repository, or the battery plugin won’t show on desktop machines.
set -g @dracula-show-empty-plugins false
This works best when combined with plugins that have specific “hide” options, like @dracula-weather-hide-errors or @dracula-no-battery-label false.

​
Plugin padding

Customize the spacing around plugins in the status bar. You can use whitespace or any character for padding.
​
@dracula-left-pad
string
default:"' '"
Padding character(s) on the left side of each plugin. By default, this is one space.Set to false to remove all left padding.
​
@dracula-right-pad
string
default:"' '"
Padding character(s) on the right side of each plugin. By default, this is one space.Set to false to remove all right padding.
# One space on each side (default behavior)
set -g @dracula-left-pad ' '
set -g @dracula-right-pad ' '
When removing padding, use the literal value false, not an empty string or "false".

​
Example configuration

Here’s a complete example combining all status bar options: 
# Enable window flags
set -g @dracula-show-flags true

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

# Enable high contrast borders
set -g @dracula-border-contrast true

# Hide plugins with no data
set -g @dracula-show-empty-plugins false

# Add custom padding with dots
set -g @dracula-left-pad ' • '
set -g @dracula-right-pad ' • '

Build docs developers (and LLMs) love

Get started for freeTalk to us