Tmux2K - Power & Pizzazz for tmux 🥊💅

What is this

tmux2k is a tmux plugin for that adds powerline support and pretty colors to your tmux status bar.

Inspiration

tmux2k was inspired by dracula/tmux.

Prerequisites

Before you begin, ensure you have met the following requirements:

You have installed the latest version of tmux.
tpm for managing tmux plugins.
A patched nerd font for powerline and glyphs support.

Installing tmux2k

Using tpm

If you are a tpm user, you can install the theme and keep up to date by adding the following to your .tmux.conf file:

set -g @plugin '2kabhishek/tmux2k'

Add any configuration options below this line in your tmux config.

Activating tmux2k

Make sure run -b ~/.tmux/plugins/tpm/tpm is at the bottom of your .tmux.conf
Run tmux
Use the tpm install command: prefix + I (default prefix is ctrl+b)

Configuring tmux2k

# Tmux 2K default configs
# available plugins: battery, cpu-usage, git, gpu-usage, ram-usage, network, network-bandwidth, network-ping, weather, time
set -g @tmux2k-left-plugins "git cpu-usage ram-usage"
set -g @tmux2k-right-plugins "battery network time"
set -g @tmux2k-show-powerline true
set -g @tmux2k-show-fahrenheit false
set -g @tmux2k-military-time true
set -g @tmux2k-border-contrast true

# available colors: white, gray, dark_gray, light_purple, dark_purple, cyan, green, orange, red, pink, yellow
set -g @tmux2k-[plugin-name]-colors "[background] [foreground]"
set -g @tmux2k-cpu-usage-colors "blue dark_gray"

# it can accept `session`, `rocket`, `window`, or any character.
set -g @tmux2k-show-left-icon ""

# update powerline symbols
set -g @tmux2k-show-left-sep ""
set -g @tmux2k-show-right-sep ""

# change refresh rate
set -g @tmux2k-refresh-rate 5

How it was built

tmux2k was built using neovim, shellcheck, nerd-fonts.

What I learned

Learned a lot about the tmux and tpm ecosystem.
Did some fancy shell scripting.

What’s next

To-Do

Fix left plugins color logic
Add more section scripts

Hit the ⭐ button if you found this useful.

tmux2k repo