Make tmux powerful and pretty 🥊💅
tmux2k is a highly customizable framework designed to enhance your tmux status bar, providing you with a sleek and informative interface for your terminal sessions.
To use themes:
# use a theme
set -g @tmux2k-theme 'onedark'
# to show icons only
set -g @tmux2k-icons-only true
# to customize duo bg and fg
set -g @tmux2k-duo-fg "#1688f0" # this will get you duo blue shown above
set -g @tmux2k-duo-bg "#000000" # this will set the bg for duo theme
# to set powerline symbols
set -g @tmux2k-right-sep # alternate right status bar sep
set -g @tmux2k-win-right-sep # alternate window right sep
# to not show powerline
set -g @tmux2k-show-powerline false
# set start icon, accpets: `session`, 'window`, or any string
set -g @tmux2k-start-icon ""
text
: Default text color. Default: #282a36
bg_main
: Background color for main sections. Default: #15152a
bg_alt
: Background color for alternate sections. Default: #45455a
black
: Black color. Default: #0a0a0f
white
: White color. Default: #d5d5da
red
: Red color. Default: #ff001f
light_red
: Light red color. Default: #ff0055
green
: Green color. Default: #3dd50a
light_green
: Light green color. Default: #ccffcc
blue
: Blue color. Default: #1688f0
light_blue
: Light blue color. Default: #11dddd
yellow
: Yellow color. Default: #ffb86c
light_yellow
: Light yellow color. Default: #ffd21a
purple
: Purple color. Default: #bf58ff
light_purple
: Light purple color. Default: #ff65c6
To customize theme colors:
set -g @tmux2k-text '#cdcdcd' # change text to white
set -g @tmux2k-bg-main '#ffffff' # change bg to white
set -g @tmux2k-yellow '#f8c800' # change yellow color
You may have to restart
tmux
for some changes to reflect
battery
: Show battery stats and percentagegit
: Show Git branch and status informationcpu
: Show CPU usage informationgpu
: Show GPU usage informationram
: Show RAM usage informationnetwork
: Show network status and statisticsbandwidth
: Show network bandwidth usageping
: Show network ping statisticstime
: Show current time and dateweather
: Show weather informationwimdow
: tmux window listTo use plugins:
# set the left and right plugin sections
set -g @tmux2k-left-plugins "git cpu ram"
set -g @tmux2k-right-plugins "battery network time"
# to customize plugin colors
set -g @tmux2k-[plugin-name]-colors "[background] [foreground]"
set -g @tmux2k-cpu-colors "red black" # set cpu plugin bg to red, fg to black
# to enable compact window list size
set -g @tmux2k-compact-windows true
# change refresh rate
set -g @tmux2k-refresh-rate 5
# weather scale
set -g @tmux2k-show-fahrenheit false
# 24 hour time
set -g @tmux2k-military-time true
# network interface to watch
set -g @tmux2k-network-name "wlo1"
To add a new plugin, add a script to the scripts folder that prints something to the console.
The plugin name and script file name must match e.g: plugin named
foo
should have a file calledscripts/foo.sh
Before you begin, ensure you have met the following requirements:
tmux
.brew install bash
tmux
plugins.powerline
and glyphs support.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'
tmux
tpm
install command: prefix + I (default prefix is ctrl+b
)You can also directly clone the repo to your ~/.tmux/plugins/
folder.
I came across dracula/tmux sometime back and I wanted to create a more customizable and easy to expand solution.
tmux
and tpm
ecosystem.You tell me!
⭐ hit the star button if you found this useful ⭐
Source | Blog | Twitter | LinkedIn | More Links | Other Projects