Skip to content

stoeffel/tmux-tui

Repository files navigation

tmux-tui

Build status Hackage BSD3 license

A TUI to manage tmux.

This is a TUI to manage tmux sessions.

🚧 It's currently under heavy construction and might break unexpectetly. 🚧

Usage

Installation

$ git clone [email protected]:stoeffel/tmux-tui.git
$ cabal install

I recommend setting up a keybinding to get to the TUI from anywhere.

bind -n C-h new-window -n tmux-tui -c "#{pane_current_path}" "tmux-tui"

And, if you want to switch to any open window if there is already a tmux-tui instance running use this. bind -n C-h run-shell "tmux switch-client -t :tmux-tui || tmux new-window -k -n tmux-tui -c '#{pane_current_path}' 'tmux-tui'"

Starting

tmux-tui will startup tmux if you are running the command from outside tmux. It creates a session that will be destroyed after you start or create a session.

The TUI

There are 4 panels.

Stored: Contains stored session. Stores:

  • layout
  • windows and panes
  • current path and command (might not work yet in non OSX OS) of panes. Sessions: Active sessions Windows: Windows in session or stored session. Panes: Panes dependant on focus per window or session.

There is a context sensitive help at the bottom of the screen.

General: Keybindings

Keybinding Behaviour
j,k,:arrow_up:, :arrow_down: Moving up and down in the list.
h,l,:arrow_left:, :arrow_right: Moving between panels.
q Immidiatelly exits tmux-tui.
esc Either clears filter in panel, stops pasting mode or exits tmux-tui.
/ Search in panel.
d Delete Stored/Session/Window/Pane.
y Yank Window/Pane.
p Paste Window/Pane to Session/Window/Below Pane.

Stored: Keybindings

Keybinding Behaviour
space Instantiate a session of this type.
This will ask for a session name if there is already a session with this name.

Sessions: Keybinding

Keybinding Behaviour
space Attach to session.
s Store session.
c Create a new session.
r Rename session.

Windows: Keybindings

Keybinding Behaviour
space Switch to window.
c Create a new window.
r Rename window.
J,K Move window up and down.
m Merge window with the one below.

About

TUI to manage tmux sessions 🚧

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published