tmux-gruvbox-lite

A clean, Gruvbox-inspired tmux configuration without a dedicated Gruvbox theme plugin.

This setup keeps the look and feel of Gruvbox using native tmux styling, while still using a small set of useful plugins for navigation, window icons, and CPU/RAM stats.

Preview

Features

• Gruvbox-like dark palette
• Native tmux status bar styling
• Powerline-style separators
• Vim-style pane navigation with h, j, k, l
• Secondary prefix with Ctrl-s
• Mouse support
• True color support
• CPU, RAM, and GPU RAM indicators
• Nerd Font window names
• Vim/tmux navigation integration

Requirements

• tmux
• Git
• A Nerd Font installed and enabled in your terminal
• TPM, the tmux plugin manager

Plugins

This config uses:

• tmux-plugins/tpm
• christoomey/vim-tmux-navigator
• joshmedeski/tmux-nerd-font-window-name
• tmux-plugins/tmux-cpu

Installation

Clone the repository:

git clone https://github.com/guisfus/tmux-gruvbox-lite.git ~/.config/tmux-gruvbox-lite

Back up your current tmux config:

cp ~/.tmux.conf ~/.tmux.conf.backup

Copy the config:

cp ~/.config/tmux-gruvbox-lite/.tmux.conf ~/.tmux.conf

Install TPM if you do not already have it:

git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

Reload tmux:

tmux source-file ~/.tmux.conf

Install plugins from inside tmux:

prefix + I

By default, your prefix is still Ctrl-b, and the secondary prefix is Ctrl-s.

Quick install

You can also run:

./install.sh

The install script backs up your existing ~/.tmux.conf before copying the new one.

Key bindings

Binding	Action
prefix + r	Reload ~/.tmux.conf
prefix + h	Select pane left
prefix + j	Select pane down
prefix + k	Select pane up
prefix + l	Select pane right
Ctrl-s	Secondary prefix

Notes

This configuration does not use a Gruvbox tmux theme plugin. All colors are defined directly in .tmux.conf.

The status bar uses Nerd Font icons and Powerline separators, so it looks best with a Nerd Font such as JetBrainsMono Nerd Font, Hack Nerd Font, or FiraCode Nerd Font.

License

MIT