Gestion des sessions

Créer et rattacher

tmux                        # new session
tmux new -s work            # new named session
tmux attach -t work         # attach to session
tmux attach -dt work        # detach others, attach

Commandes de session

tmux ls	Lister toutes les sessions
tmux kill-session -t work	Supprimer une session nommée
tmux kill-server	Arrêter le serveur tmux et toutes les sessions
tmux rename-session -t old new	Renommer une session
Prefix d	Se détacher de la session courante
Prefix $	Renommer la session courante
Prefix s	Lister les sessions (interactif)

Le préfixe par défaut est Ctrl-b

Fenêtres

Raccourcis clavier des fenêtres

Prefix c	Créer une nouvelle fenêtre
Prefix ,	Renommer la fenêtre courante
Prefix &	Fermer la fenêtre courante (confirmation)
Prefix n	Fenêtre suivante
Prefix p	Fenêtre précédente
Prefix 0-9	Passer à la fenêtre par numéro
Prefix w	Lister les fenêtres (sélecteur interactif)
Prefix l	Basculer vers la dernière fenêtre active

Commandes de fenêtres

tmux new-window -t work     # new window in session
tmux swap-window -t 0       # move window to index 0
tmux move-window -t 3       # renumber to index 3

Volets

Diviser et fermer

Prefix %	Diviser horizontalement (gauche \| droite)
Prefix "	Diviser verticalement (haut / bas)
Prefix x	Fermer le volet courant (confirmation)
Prefix !	Détacher le volet dans sa propre fenêtre
Prefix z	Basculer le zoom du volet (fenêtre entière)

Redimensionner les volets

Prefix Ctrl-Arrow	Redimensionner d'une cellule
Prefix Alt-Arrow	Redimensionner de cinq cellules
Prefix Space	Faire défiler les dispositions

Dispositions : even-horizontal, even-vertical, main-horizontal, main-vertical, tiled

Navigation

Se déplacer entre les volets

Prefix Arrow	Aller au volet dans la direction
Prefix o	Passer au volet suivant
Prefix q	Afficher les numéros de volets, puis appuyer sur le numéro
Prefix {	Échanger le volet avec le précédent
Prefix }	Échanger le volet avec le suivant

Se déplacer entre les sessions

Prefix (	Passer à la session précédente
Prefix )	Passer à la session suivante
Prefix s	Sélecteur de session (vue arborescente)
Prefix w	Sélecteur de fenêtres toutes sessions confondues

Mode copie

Entrer et naviguer

Prefix [	Entrer en mode copie
q	Quitter le mode copie
Arrow / hjkl	Déplacer le curseur (mode vi)
Ctrl-u / Ctrl-d	Page précédente / suivante
g / G	Aller au début / à la fin
/	Rechercher en avant
?	Rechercher en arrière
n / N	Correspondance suivante / précédente

Sélectionner et copier

Space	Démarrer la sélection (mode vi)
Enter	Copier la sélection et quitter
Prefix ]	Coller le tampon
v	Basculer la sélection rectangulaire (mode vi)

Activer le mode vi : set -g mode-keys vi

Configuration

Paramètres courants (~/.tmux.conf)

set -g mouse on                 # enable mouse
set -g base-index 1             # windows start at 1
set -g renumber-windows on      # renumber on close
set -g default-terminal "tmux-256color"
set -g history-limit 50000

Recharger la configuration

tmux source-file ~/.tmux.conf   # from shell
# or Prefix : then type:
source-file ~/.tmux.conf

Barre de statut

Options de la barre de statut

set -g status-position top
set -g status-style "bg=black,fg=white"
set -g status-left "[#S] "
set -g status-right "%H:%M %d-%b"
set -g status-interval 5

Variables de format

#S	Nom de la session
#I	Index de la fenêtre
#W	Nom de la fenêtre
#P	Index du volet
#H	Nom d'hôte
#T	Titre du volet

Raccourcis clavier

Liaisons personnalisées

# change prefix to Ctrl-a
unbind C-b
set -g prefix C-a
bind C-a send-prefix
# vim-style pane navigation
bind h select-pane -L
bind j select-pane -D
bind k select-pane -U
bind l select-pane -R

Syntaxe de liaison

bind X command	Lier Prefix + X à la commande
bind -n M-Left prev	Lier sans préfixe (Alt-Gauche)
bind -r H resize-pane -L 5	Liaison répétable
unbind X	Supprimer une liaison
Prefix ?	Lister toutes les liaisons clavier actuelles

Scripts

Dispositions scriptées

tmux new-session -d -s dev
tmux send-keys -t dev "vim" Enter
tmux split-window -h -t dev
tmux send-keys -t dev "npm run dev" Enter
tmux attach -t dev

Commandes utiles

tmux send-keys -t sess 'cmd' Enter	Envoyer des frappes à une session
tmux capture-pane -p	Afficher le contenu du volet sur stdout
tmux display-message '#S'	Afficher un message / variable
tmux set-environment -g VAR val	Définir une variable d'environnement
tmux list-keys	Lister toutes les liaisons clavier

Modèles courants

~/.tmux.conf recommandé

set -g mouse on
set -g base-index 1
set -g mode-keys vi
set -g status-position top
set -g history-limit 50000
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"

Recettes rapides

Survive SSH disconnect	`tmux new -s work` → déconnecter → `tmux attach -t work`
Share session	Les deux utilisateurs `tmux attach -t same` (lecture seule : `-r`)
Save scrollback	`tmux capture-pane -S -3000 -p > log.txt`
Kill stuck pane	Prefix x, ou `tmux kill-pane -t %N`
Reorder windows	`:swap-window -s 3 -t 1`

RÉFÉRENCE RAPIDE TMUX