Tmux: Difference between revisions

From Leo's Notes
This page was last edited on 11 March 2020, at 22:56.
mNo edit summary
Line 2: Line 2:


== Quick Usage ==
== Quick Usage ==
When starting tmux, you create a new session. Each session can have multiple windows (numbered 0..N). Each window can split into multiple panes.
{| class="wikitable"
{| class="wikitable"
! width="30%" | Command
! width="30%" | Command
Line 12: Line 14:
| Creates a new session named session-name
| Creates a new session named session-name
|-
|-
| tmux a{{!}}attach
| <nowiki>tmux a|attach N</nowiki>
| Attaches to an existing session
| Attaches to an existing session
|-
| <nowiki>tmux a|attach -t session-name</nowiki>
| Attaches to an existing session by name
|-
|-
| tmux kill-session -t session-name
| tmux kill-session -t session-name
Line 21: Line 26:
| Kills a session by ID
| Kills a session by ID
|}
|}


=== Commands ===
=== Commands ===

Revision as of 22:56, 11 March 2020

tmux is a terminal multiplexer similar to Screen but with some cool features such as split panes.

Quick Usage

When starting tmux, you create a new session. Each session can have multiple windows (numbered 0..N). Each window can split into multiple panes.

Command Description
tmux ls Lists all tmux sessions
tmux new -s session-name Creates a new session named session-name
tmux a|attach N Attaches to an existing session
tmux a|attach -t session-name Attaches to an existing session by name
tmux kill-session -t session-name Kills a session by name
tmux kill N Kills a session by ID

Commands

All commands to tmux is prefixed with a key (Ctrl-b as opposed to Ctrl-a in screen).

General commands:

Command Description
d Detach from this session
$ Rename current session
s Lists all sessions
t Shows a clock in the current pane
? Shows key bindings
: Enters the tmux command prompt, where you can enter commands
[ Enter copy mode with. You can use Vim key bindings if you set the mode-keys in the settings (see below). Exit copy mode by pressing Enter.

Windows (tab) commands:

Command Description
c Creates a new window
w Lists windows
n Go to next window
p Go to previous window
& Kills the current window
, Name the current window

Panes (split) commands. Enable mouse (see below) to make switching and resizing panes easy.

Command Description
% Vertical split (up over down symbol)
" Horizontal split (2 quotes side by side)
x Close pane
! Close all other panes
o Swap panes
q Show pane numbers

Configuration

Configuration can be set in ~/.tmux.conf file. Some useful settings are given below.

# Enable Vim key bindings in copy-mode
setw -g mode-keys vi

# Enable mouse, useful for selecting or resizing panes
set-option -g mouse on

# make scrolling with wheels work
bind -n WheelUpPane if-shell -F -t = "#{mouse_any_flag}" "send-keys -M" "if -Ft= '#{pane_in_mode}' 'send-keys -M' 'select-pane -t=; copy-mode -e; send-keys -M'"
bind -n WheelDownPane select-pane -t= \; send-keys -M

See Also