What is this
tmux-tilit is a tmux plugin that adds tiling window manager like features and keybindings to tmux.
Inspiration
tmux-tilit was inspired by tmux-tilish. I wanted to add some new commadns, make the keybindings match better with tmux's defaults, hence tilit was born!
Prerequisites
Before you begin, ensure you have met the following requirements:
- You have installed the latest version of
tmuxandtpm.
Installing tmux-tilit
To get tmux-tilit, add the following to your ~/.tmux.conf:
set -g @plugin '2kabhishek/tmux-tilit'Using tmux-tilit
Keybindings
Finally, here is a list of the actual keybindings. Most are [taken from i3wm][1].
Below, a "workspace" is what tmux would call a "window" and vim would call a "tab",
while a "pane" is what i3wm would call a "window" and vim would call a "split".
| Keybinding | Description |
|---|---|
| Alt + 0-9 | Switch to workspace number 0-9 |
| Alt + Shift + 0-9 | Move pane to workspace 0-9 |
| Alt + h/j/k/l | Move focus left/down/up/right |
| Shift + Left/Right Arrow | Focus Previous/Next Window |
| Alt + Shift + h/j/k/l | Move pane left/down/up/right |
| Alt + Enter | Create a new pane at "the end" of the current layout |
| Alt + - | Horizontal Split |
| Alt + \ | Vertical Split |
| Alt + s | Switch to layout: split then vsplit |
| Alt + Shift + s | Switch to layout: only split |
| Alt + v | Switch to layout: vsplit then split |
| Alt + Shift + v | Switch to layout: only vsplit |
| Alt + t | Switch to layout: fully tiled |
| Alt + z | Switch to layout: zoom (fullscreen) |
| Alt + Shift + r | Refresh current layout |
| Alt + n | Name current workspace |
| Alt + x | Quit (close) pane |
| Alt + d | tmux dmenu launcher |
| Alt + Shift + d | Detach |
| Alt + r | Reload config |
| Alt + b | Toggle status bar |
For detailed instructions please read DOCS
How it was built
Major credits to tmux-tilish for the inspiration
tmux-tilit was built using neovim
Challenges faced
Making sure the keybindings work accross different cli programs was challenging.
What I learned
- Learned more about the tmux api.
What's next
You tell me!
Hit the ⭐ button if you found this useful.
🧰 Tooling
- dots2k — Dev Environment
- nvim2k — Personalized Editor
- sway2k — Desktop Environment
- qute2k — Personalized Browser