/tmux2k

Power & Pizzazz for tmux 🥊💅

Primary LanguageShellGNU General Public License v3.0GPL-3.0

License People Stars Forks Watches Last Updated

Power & Pizzazz for tmux 🥊💅

tmux2k Demo
tmux2k full screenshot tmux2k Demo
tmux2k statusbar screenshot

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 ""

# network interface to monitor
set -g @tmux2k-network-name "en0"/"wlo1" (Mac/Linux)

# 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.

More Info

Looking for my zsh and other cli configs? See Dotfiles

Looking for my neovim configs? See nvim

Want the CLI experience on your Android too? Have a look at Oh-My-Termux

Source | Website