Tmux Cheatsheet

Tmux Windows and Panes Cheatsheet

Run these shortcuts from within vim once you have created a tmux session from your terminal

Open window explorer

prefix w

Close window from the window explorer

once window explorer is open then you can hit x to close the window

Tmux windows

• prefix c - create new window
• prefix % to split windows
• prefix " split vertical
• prefix and then arrow key to move the cursor around
• prefix z to zoom in on the screen you are working in
• prefix z to get back out of zoomed version

Detach from session

Get out of the current session and go back to terminal.

• prefix d

Rename window

• prefix : rename-window .

Rename session

• prefix ,

Switch windows

prefix p - open previous window prefix n - open next windo prefix 0 or 1 or 2 to switch windows, each window has its own number prefix w - list windows

Change session

prefix s

Kill current pane

• prefix x

Resize panes

:resize-pane -D (Resizes the current pane down)
:resize-pane -U (Resizes the current pane upward)
:resize-pane -L (Resizes the current pane left)
:resize-pane -R (Resizes the current pane right)
:resize-pane -D 10 (Resizes the current pane down by 10 cells)
:resize-pane -U 10 (Resizes the current pane upward by 10 cells)
:resize-pane -L 10 (Resizes the current pane left by 10 cells)
:resize-pane -R 10 (Resizes the current pane right by 10 cells)

Tmux session cheatsheet

Prerequisites

• Tmux installed.
• The default tmux prefix is ctrl-b. Knowing this, you can now run the commands from the ‘within tmux’ section below.
• Commands that begin with tmux are to be run on the command line.

Tmux config

tmux.config

You can use the config to remap keys. see my tmux config file

Open tmux.config

vi ~/.tmux.conf

Source new tmux config file changes

:source-file ~/.tmux.conf

Create a new tmux session and give it a name

tmux new -s the_name

Attach session

Go back into an existing session.

attach -t Session

List sessions

tmux ls

Exit session

Exit the session but keep it alive so you can attach to it again.

tmux detach

Kill all sessions

tmux kill-server

Kill a specific session

first list the sessions

tmux list-sessions

or

tmux ls

Then choose one to kill

tmux kill-session -t targetSession

Scroll

Enable vi navigation keys to move the cursor around. copy and paste content from previous commands using your vim keys

prefix [

Exit scroll mode

q

Attach an existing session to your current shell window

• tmux attach -t (for target) name of session

Plugins

add plugins to your tmux config

# list plugins
set -g @plugin 'christoomey/vim-tmux-navigator'
set -g @plugin 'jimeh/tmux-themepack'
set -g @plugin 'tmux-plugins/tmux-resurrect'
set -g @plugin 'tmux-plugins/tmux-continuum'

Install plugins

• prefix, shift i

Plugin config

config plugins using tmux.config

set -g @resurrect-capture-pane-contents 'on'
set -g @continuum-restore 'on'

Troubleshooting

• macOS fix for “warning: reattach-to-user-namespace: unsupported new OS, trying as if it were 10.10”

brew upgrade reattach-to-user-namespace

more info

More information

more info

My tmux config file

# remap prefix from 'C-b' to 'C-a'
unbind C-b
set-option -g prefix C-a
bind-key C-a send-prefix


set -g default-terminal "screen-256color"

# horizonal and vertical split planes
unbind %
bind | split-window -h

unbind '"'
bind - split-window -v


# resize panes
bind -r j resize-pane -D 5
bind -r k resize-pane -U 5
bind -r l resize-pane -R 5
bind -r h resize-pane -L 5

# maximise pane
bind -r m resize-pane -X

set -g mouse on

bind-key -T copy-mode-vi 'v' send -X begin-selection
bind-key -T copy-mode-vi 'y' send -X copy-selection

unbind -T copy-mode-vi MouseDragEnd1Pane

# source config with prefix r
unbind r
bind r source-file ~/.tmux.conf

# plugin manager
set -g @plugin 'tmux-plugins/tmp'

# list plugins
set -g @plugin 'christoomey/vim-tmux-navigator'
set -g @plugin 'jimeh/tmux-themepack'

set -g @plugin 'tmux-plugins/tmux-resurrect'
set -g @plugin 'tmux-plugins/tmux-continuum'


set -g @resurrect-capture-pane-contents 'on'
set -g @continuum-restore 'on'

set -g @themepack 'powerline/default/cyan'



# keep at the bottom
run '~/.tmux/plugins/tpm/tpm'


# restore vim buffers
set -g @resurrect-processes 'vim:all'

Within Tmux

see tmux commands