No description
Find a file
2025-10-08 22:10:05 +02:00
screenshots init 2025-10-05 19:01:18 +02:00
src changed order 2025-10-08 22:10:05 +02:00
gruvbox.tmux init 2025-10-05 19:01:18 +02:00
README.md init 2025-10-05 19:01:18 +02:00

Gruvbox Tmux

Overview

A clean Tmux theme that follow the gruvbox colors, Inspired by Tokyo Night Tmux.

Requirements

This theme has the following hard requirements:

The following are recommended for full support of all widgets and features:

  • bc (for git widgets)
  • jq, gh, glab (for git forges widgets)

Installation using TPM

In your tmux.conf add :

set -g @plugin "https://gitlab.com/motaz-shokry/gruvbox-tmux"

Configuration

Add these lines to your .tmux.conf:

Theme Flavor

set -g @gruvbox-tmux_theme "medium"  # medium | soft | Default is hard  
set -g @gruvbox-tmux_transparent 0   # 1 | 0

Terminal icons

set -g @gruvbox-tmux_terminal_icon 
set -g @gruvbox-tmux_active_terminal_icon 

Number styles

set -g @gruvbox-tmux_window_id_style hsquare  # hsquare | fsquare | sub | super | arabic | earabic
set -g @gruvbox-tmux_pane_id_style super      # hsquare | fsquare | sub | super | arabic | earabic
set -g @gruvbox-tmux_zoom_id_style dsquare    # hsquare | fsquare | sub | super | arabic | earabic

Widgets

For widgets add following lines in you .tmux.conf

Time widget

This widget is enabled by default. To disable it:

set -g @gruvbox-tmux_show_datetime 0

Time options

set -g @gruvbox-tmux_time_format 12H
Available Options
  • 24H: 18:30
  • 12H: 6:30 PM

Battery Widget

set -g @gruvbox-tmux_show_battery_widget 1     # 0 to disable
set -g @gruvbox-tmux_battery_name "BAT0"       # run `ls /sys/class/power_supply` to know
set -g @gruvbox-tmux_battery_low_threshold 25

Hostname-User Widget

set -g @gruvbox-tmux_show_hostname_user 1      # 0 to disable
set -g @gruvbox-tmux_hostname_user_format "user@host"  # user@host | host | user
set -g @gruvbox-tmux_hostname_user_color "aqua"        # any theme color like aqua, blue, green, etc.

Snapshots

Hard Light