minimal-tmux-status

This is a theme/plugin for my Tmux Status bar. This is inspired from the zellij prefix indicator, that shows when the prefix key is pressed.

This theme was created with a focus on minimalism and essential elements, ensuring a clean and distraction-free Tmux status bar. Whether you're an experienced Tmux user or just getting started, this theme offers a seamless experience with support for the prefix key press.

📚 mtmux.semi.sh - Full Documentation

Preview

Un pressed Prefix
Pressed Prefix

Variables to Configure

My Personal Configuration

# set -g @minimal-tmux-bg "#${config.stylix.base16Scheme.base01}" (or you can use it with pywal)
set -g @minimal-tmux-use-arrow true
set -g @minimal-tmux-right-arrow ""
set -g @minimal-tmux-left-arrow ""

# These are the default values used inside the plugin to achieve the preview shown above.

set -g @minimal-tmux-fg "#000000"
set -g @minimal-tmux-bg "#698DDA"
set -g @minimal-tmux-justify "centre"
set -g @minimal-tmux-indicator-str "  tmux  "
set -g @minimal-tmux-indicator true
set -g @minimal-tmux-status "bottom"

# Enables or disables the left and right status bar
set -g @minimal-tmux-right true
set -g @minimal-tmux-left true

# expanded icon (fullscreen icon)
set -g @minimal-tmux-expanded-icon "󰊓 "

# on all tabs (default is false)
# false will make it visible for the current tab only
set -g @minimal-tmux-show-expanded-icon-for-all-tabs true

# To add or remove extra text in status bar
set -g @minimal-tmux-status-right-extra ""
set -g @minimal-tmux-status-left-extra ""

# To make the selection box rounded () or edged <>
# Default is nothing, when set to true default is edged
set -g @minimal-tmux-use-arrow true
set -g @minimal-tmux-right-arrow ""
set -g @minimal-tmux-left-arrow ""

# Not recommended to change these values
set -g @minimal-tmux-status-right "#S"
set -g @minimal-tmux-status-left "refer to code"

# If getting strings cut in left status or right
# Here 20 is the length of the characters in the string
set -g status-right-length 20
set -g status-left-length 20

Installation

As flake in Nix os

# tmux config
programs.tmux.plugins = [
  {
    plugin = pkgs.tmuxPlugins.minimal-tmux-status; # as now available in nixpkgs
    extraConfig = ''
      set -g @minimal-tmux-use-arrow true
      set -g @minimal-tmux-right-arrow ""
      set -g @minimal-tmux-left-arrow ""
    '';
  }
];

Via Tmux Plugin Manager (TPM)

I recommend using Tmux Plugin Manager (TPM) for easy installation:

1. Add the theme to your list of TPM plugins in your ~/.tmux.conf:

   set -g @plugin 'niksingh710/minimal-tmux-status'

2. Press prefix + I (capital "i", as in Install) to fetch and install the plugin.

3. Reload your Tmux configuration:

   tmux source-file ~/.tmux.conf

That's it! Your Tmux Status Theme is now installed and ready to use.

Tip

Toggle Status Bar

Add this line in your tmux config so that you can easily toggle tmux status bar with one keymap.

bind-key b set-option status

Now pressing prefix+b will toggle status bar

if "test ! -d ~/.tmux/plugins/tpm" \
   "run 'git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm && ~/.tmux/plugins/tpm/bin/install_plugins'"