tmux2k/README.md

tmux2k

Power & Pizzazz for tmux 🥊💅

tmux2k full screenshot

tmux2k statusbar screenshot

What is this

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

Features

Available Plugins:

• battery: Show battery stats and percentage
• git: Show Git branch and status information
• cpu: Show CPU usage information
• gpu: Show GPU usage information
• ram: Show RAM usage information
• network: Show network status and statistics
• bandwidth: Show network bandwidth usage
• ping: Show network ping statistics
• time: Show current time and date
• weather: Show weather information

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
set -g @tmux2k-left-plugins "git cpu ram"
set -g @tmux2k-right-plugins "battery network time"
set -g @tmux2k-show-fahrenheit false
set -g @tmux2k-military-time true

set -g @tmux2k-[plugin-name]-colors "[background] [foreground]"
set -g @tmux2k-cpu-colors "blue dark_gray"

# it can accept `session`, 'window`, or any string
set -g @tmux2k-start-icon ""

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

# update powerline symbols
set -g @tmux2k-show-powerline true
set -g @tmux2k-left-sep ""
set -g @tmux2k-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.

Inspiration

tmux2k was inspired by dracula/tmux.

What's next

To-Do

You tell me!

🧰 Tooling

• dots2k — Dev Environment
• nvim2k — Personalized Editor
• sway2k — Desktop Environment
• qute2k — Personalized Browser

🔍 More Info

• tmux-tea — Simple and powerful tmux session manager
• tmux-tilit — Turns tmux into a terminal window manager

⭐ hit the star button if you found this useful ⭐

Source | Blog | Twitter | LinkedIn | More Links | Other Projects