Skip to main content

​
Getting started

The Dracula tmux theme can be configured using options in your .tmux.conf file. Configuration works regardless of whether you use $HOME/.tmux.conf or $XDG_CONFIG_HOME/tmux/tmux.conf.

​
Enabling plugins

To enable plugins, set up the @dracula-plugins option in your .tmux.conf file. Separate each plugin name with a space. The order you define plugins determines their display order on the status bar from left to right. 
set -g @dracula-plugins "cpu-usage gpu-usage ram-usage"
Plugin names used in @dracula-plugins match the names in the documentation table of contents and plugin headlines.

​
Plugin colors

You can customize background and foreground colors for each plugin: 
# Available colors: white, gray, dark_gray, light_purple, dark_purple, cyan, green, orange, red, pink, yellow
set -g @dracula-cpu-usage-colors "pink dark_gray"
For more fine-grained color customization, see the Color theming documentation.

​
Refresh rate

Adjust how frequently the status bar updates (in seconds):
​
@dracula-refresh-rate
number
default:"5"
The refresh rate for the status bar in seconds. Affects plugins like cpu-usage, gpu-usage, mpc, spotify-tui, and others.
set -g @dracula-refresh-rate 5

​
Window flags

Enable or disable tmux window flags in the status bar:
​
@dracula-show-flags
boolean
default:"false"
Show window flags in the status bar (*, -, #, etc.).
set -g @dracula-show-flags true

​
Empty plugins

Control whether plugins with no data should still display:
​
@dracula-show-empty-plugins
boolean
default:"true"
Hide plugins when they have no data to display.
set -g @dracula-show-empty-plugins false

​
Padding configuration

Customize the padding around plugins with any character or whitespace: 
set -g @dracula-left-pad ' ° '
set -g @dracula-right-pad ' ° '
​
@dracula-left-pad
string
default:"' '"
Padding character(s) on the left side of plugins. Set to false to remove padding.
​
@dracula-right-pad
string
default:"' '"
Padding character(s) on the right side of plugins. Set to false to remove padding.
When setting padding to false, use the literal value false, not an empty string.

​
Border contrast

Enable high contrast for pane borders:
​
@dracula-border-contrast
boolean
default:"false"
Enable high contrast pane borders for better visibility.
set -g @dracula-border-contrast true

​
Next steps

Status bar options

Configure window flags, refresh rate, and padding

Powerline

Enable and customize powerline symbols

Left icon

Customize the left icon with hostname or session name

Build docs developers (and LLMs) love

Get started for freeTalk to us