tmux-tilit - better tiling for tmux 🪟🪓

If you have used tmux then you already know that tmux provides ways to create multiple panes on your terminal among many other things.

You might have also felt that the default way of doing these things is kind of clumsy and doesn’t feel natural.

Introducing tmux-tilit:

tmux-tilit screenshot

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 tmux and tpm.

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

KeybindingDescription
Alt + 0-9Switch to workspace number 0-9
Alt + Shift + 0-9Move pane to workspace 0-9
Alt + hjklMove focus left/down/up/right
Alt + Shift + hjklMove pane left/down/up/right
Alt + EnterCreate a new pane at “the end” of the current layout
Alt + -Horizontal Split
Alt + </kbd>Vertical Split
Alt + sSwitch to layout: split then vsplit
Alt + Shift + sSwitch to layout: only split
Alt + vSwitch to layout: vsplit then split
Alt + Shift + vSwitch to layout: only vsplit
Alt + tSwitch to layout: fully tiled
Alt + zSwitch to layout: zoom (fullscreen)
Alt + Shift + rRefresh current layout
Alt + nName current workspace
Alt + xQuit (close) pane
Alt + dtmux dmenu launcher
Alt + rReload config

For detailed instructions please read DOCS

How it was built

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!

[Repo Link[(https://github.com/2KAbhishek/tmux-tilit)

Hit the ⭐ button if you found this useful.

More Info

Major credits to tmux-tilish

Also checkout the nice powerline plugin you see on the screenshot, tmux2k

win2k - Ultimate Dev Setup for Windows 🪟🪄

Co-author.nvim - Add commit authors from nvim 💻🪄

comments powered by Disqus