Tmux Minithemes

December 27, 2025 · View on GitHub

Minimal and elegant theme system for tmux with multiple color schemes and customizable layouts.

TPM License


1000

1001

1002

1003

✨ Features

  • Session Information: Displays session name with visual prefix highlighting
  • Window & Pane Counts: Shows the number of windows and panes with custom icons
  • Current Directory: Displays the current working directory (shortens ~/ from home)
  • User & Host: Shows username and hostname
  • Prefix Highlighting: Visual feedback when tmux prefix is active
  • Customizable Borders: Themed pane borders and active pane highlighting
  • Multiple Layouts: Choose between simple and modern visual styles
  • Rich Color Schemes: 9 pre-defined themes with carefully chosen color palettes

📥 Installation

Install manually

Clone the repo somewhere and source it in .tmux.conf:

run-shell "/path/to/tmux-minithemes.tmux"

NOTE: Options should be set before sourcing.

Install using TPM

set -g @plugin 'pavlemmm/tmux-minithemes'

Then press prefix + I to install the plugin.

🎨 Themes

Tokyo Night (default)

set -g @tmux_minithemes_theme 'tokyonight'

Blue and orange color scheme inspired by the popular Tokyo Night theme.

Gold

set -g @tmux_minithemes_theme 'gold'

Warm yellow and pink color scheme.

Everforest

set -g @tmux_minithemes_theme 'everforest'

Green nature-inspired color palette.

Gruvbox

set -g @tmux_minithemes_theme 'gruvbox'

Retro warm colors from the popular Gruvbox theme.

Catppuccin

set -g @tmux_minithemes_theme 'catppuccin'

Pastel blue and orange color scheme.

Nord

set -g @tmux_minithemes_theme 'nord'

Cool blue and gray color palette.

Dracula

set -g @tmux_minithemes_theme 'dracula'

Purple and pink dark theme.

One Dark

set -g @tmux_minithemes_theme 'onedark'

Blue and red theme inspired by VS Code's One Dark.

Rose Pine

set -g @tmux_minithemes_theme 'rosepine'

Rose, pink, and purple color scheme.

🎯 Styles

Simple Style (default)

Clean separator-based layout with minimal visual clutter.

set -g @tmux_minithemes_style 'simple'

Modern Style

Arrow-based powerline layout for a more dynamic appearance.

set -g @tmux_minithemes_style 'modern'

⚙️ Customization

You can customize various aspects of the theme to suit your preferences.

Theme and Style

# Set theme (see available themes above)
set -g @tmux_minithemes_theme 'tokyonight'

# Set style (simple or modern)
set -g @tmux_minithemes_style 'simple'

Arrow and Separator Icons

set -g @tmux_minithemes_right_arrow_icon ''
set -g @tmux_minithemes_left_arrow_icon ''
set -g @tmux_minithemes_right_separator_icon ''
set -g @tmux_minithemes_left_separator_icon ''
set -g @tmux_minithemes_secondary_separator_modern ''
set -g @tmux_minithemes_secondary_separator_simple ''

Content Icons

set -g @tmux_minithemes_user_icon ' '
set -g @tmux_minithemes_folder_icon ' '
set -g @tmux_minithemes_windows_icon ' '
set -g @tmux_minithemes_panes_icon '󰝘 '

📋 Requirements

📄 License

MIT License