π Vanzi Tmux Theme
October 13, 2025 Β· View on GitHub
Vanzi Theme is a clean and minimalist tmux theme featuring both light and dark variants, optional transparency, and an active pane border highlight.
Itβs designed for a modern and balanced look across terminals, whether opaque or with a blurred background.
πΌοΈ Preview
Vanzi (dark theme)
Ivory (light theme)
β¨ Features
- π¨ Two color variants:
ivoryβ light themevanziβ dark theme
- π§ Optional background transparency
- π² Highlighted active pane border
- πͺΆ Minimal and elegant status bar
- πͺ Consistent colors for windows, panes, and messages
- π Displays current time and date on the status bar
π¦ Installation
Using TPM (Tmux Plugin Manager)
-
Open your tmux configuration file:
nvim ~/.config/tmux/tmux.conf -
Add the plugin line:
set -g @plugin 'briantarqui/vanzi-tmux-theme' -
Save and reload tmux:
tmux source ~/.config/tmux/tmux.conf -
Install the plugin inside tmux:
prefix + I(Default
prefixisCtrl + b)
βοΈ Configuration
You can customize the theme through the following tmux options:
| Option | Possible Values | Description |
|---|---|---|
@theme_variant | ivory | vanzi | Select light or dark variant |
@bg_transparency | on | off | Enable or disable transparent background |
@active_border | on | off | Enable a highlighted border on the active pane |
π§© Example Configuration
set -g @plugin 'briantarqui/vanzi-tmux-theme'
# Dark theme
set -g @theme_variant "vanzi"
# Transparent background (great with blurred terminals)
set -g @bg_transparency "on"
# Highlight the active pane border
set -g @active_border "on"
run-shell "~/.tmux/plugins/vanzi-tmux-theme/vanzi.tmux"
πͺ Quick Reload
If you make any configuration changes, reload tmux without restarting:
tmux source ~/.config/tmux/tmux.conf
π§ Internal Variables
| Variable | Description |
|---|---|
c_base, c_base_v | Base background colors |
c_text_l, c_text_m, c_text_h | Text contrast levels |
c_punk_main, c_punk_v | Accent colors |
c_border_l, c_border_m, c_border_h | Border color levels |
π§© Repository Structure
vanzi-tmux-theme/
βββ vanzi.tmux # Main theme script
βββ README.md # English documentation
π§βπ» Author
Brian Tarqui
Designer and developer.
π github.com/tarquibrian

