Skip to main content
Widgets are modular components that display information in your tmux status bar. Dracula tmux provides a rich set of widgets for system monitoring, version control, media playback, and more.

​
How widgets work

Widgets are dynamically loaded plugins that run scripts to gather and display information. Each widget updates at a configurable refresh rate and can be customized with colors, labels, and specific options.

​
Enabling widgets

To enable widgets, add them to the @dracula-plugins option in your .tmux.conf file. Separate multiple plugins with spaces: 
set -g @dracula-plugins "cpu-usage gpu-usage ram-usage"
The order you define plugins determines their order in the status bar from left to right.
The plugin names used in configuration match the names in the documentation headers and table of contents.

​
Widget ordering

Widgets appear in the status bar in the exact order you specify them: 
# This order:
set -g @dracula-plugins "battery network time"

# Displays as: [Battery] [Network] [Time]
You can rearrange widgets by changing their order in the configuration: 
# New order:
set -g @dracula-plugins "time network battery"

# Displays as: [Time] [Network] [Battery]

​
Color customization

Each widget’s background and foreground colors can be customized individually using the pattern: 
set -g @dracula-[plugin-name]-colors "[background] [foreground]"

​
Available colors

By default, these colors are available:
  • white
  • gray
  • dark_gray
  • light_purple
  • dark_purple
  • cyan
  • green
  • orange
  • red
  • pink
  • yellow

​
Color examples

# Pink background with dark gray text
set -g @dracula-cpu-usage-colors "pink dark_gray"

# Green background with white text
set -g @dracula-battery-colors "green white"

# Cyan background with dark gray text
set -g @dracula-network-colors "cyan dark_gray"
For more advanced color customization, including custom color palettes like Catppuccin or Gruvbox, see the Color theming documentation.

​
Global options

Several options affect all widgets:

​
Refresh rate

Adjust how frequently widgets update (in seconds): 
set -g @dracula-refresh-rate 5
Lower refresh rates increase CPU usage. The default value of 5 seconds balances responsiveness with performance.

​
Hide empty plugins

Prevent empty widgets from taking up space: 
set -g @dracula-show-empty-plugins false

​
Plugin padding

Customize spacing around widgets: 
# Add custom padding
set -g @dracula-left-pad ' ° '
set -g @dracula-right-pad ' ° '

# Remove padding
set -g @dracula-left-pad false
set -g @dracula-right-pad false

​
Widget categories

Widgets are organized into several categories:
  • System widgets: Monitor CPU, RAM, battery, temperature, and uptime
  • Network widgets: Display network status, bandwidth, public IP, ping, and VPN
  • Version control widgets: Show Git, Mercurial, and Fossil repository information
  • Media widgets: Display currently playing music from various players
  • Cloud widgets: Show Kubernetes context and Terraform workspace
  • Custom widgets: Create your own widgets with custom scripts
Explore each category in the following pages to learn about available widgets and their configuration options.

Build docs developers (and LLMs) love

Get started for freeTalk to us