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.
## Inspiration
tmux2k was inspired by [dracula/tmux](https://github.com/dracula/tmux).
## Prerequisites
Before you begin, ensure you have met the following requirements:
- You have installed the latest version of `tmux`.
- [tpm](https://github.com/tmux-plugins/tpm) for managing `tmux` plugins.
- A [patched nerd font](https://www.nerdfonts.com/) 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:
```bash
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
```bash
# 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](https://github.com/2kabhishek/Dotfiles)
Looking for my `neovim` configs? See [nvim](https://github.com/2kabhishek/nvim)
Want the CLI experience on your Android too? Have a look at [Oh-My-Termux](https://github.com/2kabhishek/Oh-My-Termux)
