A tmux cheat sheet

I just started using tmux last week, and created a cheat sheet to help me remember the basic tmux commands, and I thought I'd share that here.

The cheat sheet has a few things that are specific to my configuration file, so to begin with, here is my ~/.tmux.conf file:

# use | and - to split the windows
bind-key | split-window -h
bind-key - split-window -v

# make the first window number start at 1
set -g base-index 1

# from http://endot.org/2011/12/06/my-tmux-configuration/
# keybindings to make resizing easier
bind -r C-h resize-pane -L
bind -r C-j resize-pane -D
bind -r C-k resize-pane -U
bind -r C-l resize-pane -R

Here's an HTML version of the cheat sheet:

new window ^b c
close window ^d or ^b x
kill window ^b &
next window ^b n
previous window ^b p
rename window ^b
list all windows ^b w
move to window number ^b [number]
   
split window vertically ^b %
split window horizontally ^b “
next pane ^b o
previous pane ^b ;
show pane numbers ^b q
move pane left ^b {
move pane right ^b {
swap pane locations ^b ^o
   
resize pane down ^b ^j or ^b : resize-pane XX
resize pane up ^b ^k or ^b : resize-pane -U XX
resize pane left ^b ^h or ^b : resize-pane -L
resize pane right ^b ^j or ^b : resize-pane -R
   
re-attach a detached session tmux attach
list sessions ^b s or tmux ls
   
start scroll mode ^b [
exit scroll mode q

My tmux PDF cheat sheet

Here's a PDF version of the tmux cheat sheet you can download:

Also, because I'm a tmux newbie, I may have missed some obvious, useful commands. If you think a command should be added, leave a note in the Comments section below, and I'll see what I can do. (I can make a web page as long as I need to, but I'd like to keep the PDF to one page.)

Default command key bindings

In case I missed any good commands in the list above, I just found this list of default command key bindings in the tmux man page. I rearranged the order of the commands to organize them a bit:

C-b         Send the prefix key (C-b) through to the application.

f           Prompt to search for text in open windows.
#           List all paste buffers.
-           Delete the most recently copied buffer of text.
=           Choose which buffer to paste interactively from a list.

c           Create a new window.
,           Rename the current window.
'           Prompt for a window index to select.
.           Prompt for an index to move the current window.
0 to 9      Select windows 0 to 9.
&           Kill the current window.
i           Display some information about the current window.
l           Move to the previously selected window.
n           Change to the next window.
p           Change to the previous window.
w           Choose the current window interactively.
M-n         Move to the next window with a bell or activity marker.
M-p         Move to the previous window with a bell or activity marker.

;           Move to the previously active pane.
o           Select the next pane in the current window.
x           Kill the current pane.
{           Swap the current pane with the previous pane.
}           Swap the current pane with the next pane.
!           Break the current pane out of the window.
"           Split the current pane into two, top and bottom.
%           Split the current pane into two, left and right.

C-o         Rotate the panes in the current window forwards.
            Change to the pane above, below, to the left, or to the right of the current pane.
M-1 to M-5  Arrange panes in one of the five preset layouts: even-horizontal, even-vertical, main-horizontal, main-vertical, or tiled.
C-Up, C-Down
C-Left, C-Right
            Resize the current pane in steps of one cell.
M-Up, M-Down
M-Left, M-Right
            Resize the current pane in steps of five cells.
q           Briefly display pane indexes.
M-o         Rotate the panes in the current window backwards.

:           Enter the tmux command prompt.
?           List all key bindings.

[           Enter copy mode to copy text or view the history.
Page Up     Enter copy mode and scroll one page up.
Up, Down
Left, Right
]           Paste the most recently copied buffer of text.

C-z         Suspend the tmux client.
$           Rename the current session.
s           Select a new session for the attached client interactively.
L           Switch the attached client back to the last session.
d           Detach the current client.
D           Choose a client to detach.
r           Force redraw of the attached client.

t           Show the time.
~           Show previous messages from tmux, if any.

If you're new to tmux, I hope this is helpful.

Share it!

There’s just one person behind this website; if this article was helpful (or interesting), I’d appreciate it if you’d share it. Thanks, Al.

Add new comment

The content of this field is kept private and will not be shown publicly.

Anonymous format

  • Allowed HTML tags: <em> <strong> <cite> <code> <ul type> <ol start type> <li> <pre>
  • Lines and paragraphs break automatically.
By submitting this form, you accept the Mollom privacy policy.