Tmux

提供: ArchWiki
2016年10月23日 (日) 18:06時点におけるKusakata (トーク | 投稿記録)による版 (同期)
ナビゲーションに移動 検索に移動

関連記事

Tmux はターミナルマルチプレクサです: 一つのスクリーンから別々のプログラムが動作する多数のターミナル (またはウィンドウ) を作成・アクセス・制御することができます。tmux はスクリーンから分離させてバックグラウンドで動作させることができ、後でまた繋ぎ直すことができます。

Tmux は GNU Screen の代わりになるものとして BSD ライセンスで配布されています。似ているところもありますが、プログラムには様々な違いが存在します。tmux の FAQ ページ を見て下さい。

インストール

公式リポジトリにある tmux パッケージをインストールしてください。任意で tmux-bash-completionAUR をインストールすることで tmux の bash 補完を使うことができます。

設定

ユーザーごとの設定ファイルは ~/.tmux.conf に、グローバルな設定ファイルは /etc/tmux.conf に配置されます。

キーバインド

デフォルトでは、コマンドのキーバインドには Ctrl-b が前に付きます。例えば、ウィンドウを縦に分割するには Ctrl-b+% を押します。

ウィンドウを複数のペインに分割した後、ペインのサイズを変更するには、プレフィックスキー (例: Ctrl-b) を押してから、Ctrl を押しながら、Left/Right/Up/Down を押します。ペイン間の移動も同じ方法で行い、矢印キーの代わりに o を使います。

ヒント: screen と同じキーバインドを使いたい場合は /usr/share/tmux/screen-keys.conf を設定ファイルにコピーしてください。

キーバインドは tmux.conf の bind と unbind コマンドで変更することができます。例えばデフォルトのプレフィックスキーである Ctrl-bCtrl-a に変更するには設定ファイルに以下のコマンドを追加します:

unbind C-b
set -g prefix C-a
bind C-a send-prefix
ヒント: 特殊文字はクォートで囲ってプレフィックスとして使ってください。Ctrl の代わりに Alt (Meta) を使うこともできます。例: set -g prefix m-'\'

さらに、ウィンドウ間の移動をする方法には以下のものもあります:

Ctrl-b l (直前に選択されていたウィンドウに移動します)
Ctrl-b w (すべてのウィンドウ、及びウィンドウの番号の一覧を表示します)
Ctrl-b <ウィンドウの番号> (指定された番号のウィンドウに移動する。なお、デフォルトでは 0 - 9 の番号が割り当てられています)
Ctrl-b q  (ペインの番号を表示する。表示された番号を入力すると対応するペインに移動できます)

Tmux にはウィンドウを探す機能とそれへのキー割り当てがあり、多数のウィンドウを容易に行き来することができます:

Ctrl-b f <ウィンドウの名前> (名前でウィンドウを検索する)
Ctrl-b w (ウィンドウの一覧からウィンドウを選択する)

コピーモード

tmux ウィンドウには複数のモードが存在します。デフォルトのモードではウィンドウにアタッチされたターミナルに直接アクセスすることができ、もうひとつのモードはコピーモードです。コピーモードではバッファを移動することができ履歴をスクロールすることが可能です。vi または emacs スタイルのキーバインドが使えます。VISUAL や EDITOR に ‘vi’ が含まれていない場合、デフォルトでは emacs のキーバインドが使われます。

コピーモードに入るには以下を実行:

Ctrl-b [

デフォルトエディタと同じようにバッファを操作することができます。

コピーモードを終了するには、以下のキーバインドのどちらかを使います:

vi モード:

q

emacs モード:

Esc

URL のブラウズ

tmux の中で URL をブラウズするには urlviewAUR をインストールして設定する必要があります。

新しいターミナルの中で:

bind-key u capture-pane \; save-buffer /tmp/tmux-buffer \; run-shell "$TERMINAL -e urlview /tmp/tmux-buffer"

新しい tmux ウィンドウの中で (新しいターミナルは不要です):

bind-key u capture-pane \; save-buffer /tmp/tmux-buffer \; new-window -n "urlview" '$SHELL -c "urlview < /tmp/tmux-buffer"'

適切なターミナルの設定

256色

256色のターミナルを使っている場合、tmux で適切なターミナルを設定する必要があります。tmux 2.1 から、tmux が適切な設定値です。tmux.conf で以下のように設定できます:

set -g default-terminal "tmux"

もしくは screenscreen-256color などに設定する場合もあります:

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

また、.bashrc に以下を追加することで強制的に tmux から256色をサポートしているターミナルを認識させることができます:

alias tmux="tmux -2"

24ビットカラー

Tmux はバージョン 2.2 から24ビットカラーをサポートしています ([1])。使用しているターミナルが24ビットカラーをサポートしている場合 (gist を参照)、ターミナルを terminal-overrides 設定に追加してください。例えば、Termite を使っているのであれば以下のように追加します:

set -ga terminal-overrides ",xterm-termite:Tc"

他のターミナルの場合、xterm-termite を適切なターミナルのタイプに置き換えてください ($TERM に保存されています)。Tc の terminfo 拡張について詳しくは tmux(1) の man ページを見てください。

xterm-keys

tmux.conf で xterm-keys を有効にするには、以下の行を追加してください:

set-option -g xterm-keys on

If you enable xterm-keys in your tmux.conf, then you need to build a custom terminfo to declare the new escape codes or applications will not know about them. Compile the following with tic and you can use "xterm-screen-256color" as your TERM:

# A screen- based TERMINFO that declares the escape sequences
# enabled by the tmux config "set-window-option -g xterm-keys".
#
# Prefix the name with xterm- since some applications inspect
# the TERM *name* in addition to the terminal capabilities advertised.
xterm-screen-256color|GNU Screen with 256 colors bce and tmux xterm-keys,

# As of Nov'11, the below keys are picked up by
# .../tmux/blob/master/trunk/xterm-keys.c:
	kDC=\E[3;2~, kEND=\E[1;2F, kHOM=\E[1;2H,
	kIC=\E[2;2~, kLFT=\E[1;2D, kNXT=\E[6;2~, kPRV=\E[5;2~,
	kRIT=\E[1;2C,

# Change this to screen-256color if the terminal you run tmux in
# doesn't support bce:
	use=screen-256color-bce,

他の設定

スクロールバックバッファを10000行に設定:

set -g history-limit 10000

ターミナルエミュレータの設定を上書き:

set -ga terminal-overrides ',xterm*:smcup@:rmcup@'
set -ga terminal-override ',rxvt-uni*:XT:Ms=\E]52;%p1%s;%p2%s\007'

マウスを切り替える:

bind-key m set-option -g mouse on \; display 'Mouse: ON'
bind-key M set-option -g mouse off \; display 'Mouse: OFF'

systemd で自動起動

起動時に tmux サーバーを立ち上げることには複数の利点が存在します。特に、新しい tmux セッションを起動する場合、既にサービスが動作していれば起動時間が短縮されます。

Furthermore, any customization attached to your tmux session will be retained and your tmux session can be made to persist even if you have never logged in, if you have some reason to do that (like a heavily scripted tmux configuration or shared user tmux sessions).

以下のサービスは特定のユーザーで tmux を起動します (tmux@username.service で起動と同じ):

/etc/systemd/system/tmux@.service
[Unit]
Description=Start tmux in detached session

[Service]
Type=forking
User=%I
ExecStart=/usr/bin/tmux new-session -s %u -d
ExecStop=/usr/bin/tmux kill-session -t %u

[Install]
WantedBy=multi-user.target
ヒント: WorkingDirectory=custom_path を追加することで作業ディレクトリをカスタマイズすることも可能です。

または、(User=%I を使わずに) 上記のファイルを systemd/ユーザーディレクトリに配置することもできます、例: ~/.config/systemd/user/tmux.service。この方法だとユーザーインスタンスの自動起動を有効にしていない場合、ログイン時に tmux サービスが起動します。

セッションの開始

~/.tmux.conf に以下のように記述することでウィンドウがプリロードされた状態で tmux でセッションを開くことができます:

new  -n WindowName Command
neww -n WindowName Command
neww -n WindowName Command

ウィンドウが分割された状態でセッションを起動するには (マルチペイン)、分割したい neww の下に splitw コマンドを追加してください:

new  -s SessionName -n WindowName Command
neww -n foo/bar foo
splitw -v -p 50 -t 0 bar
selectw -t 1 
selectp -t 0

上記の場合、ウィンドウが2つ開いて、2番目のウィンドウは foo/bar という名前で縦に半分に分割されます (50%)。bar の上で foo が実行されます。フォーカスはウィンドウ 2 (foo/bar) のトップペイン (foo) になります。

ノート: Numbering for sessions, windows and panes starts at zero, unless you have specified a base-index of 1 in your .conf

複数のセッションを管理したい場合、設定ファイルから別のセッションファイルを読み込んでください:

# initialize sessions
bind F source-file ~/.tmux/foo
bind B source-file ~/.tmux/bar

トラブルシューティング

スクロールの問題

If you have issues scrolling with Shift-Page Up/Down in your terminal, the following will remove the smcup and rmcup capabilities for any term that reports itself as anything beginning with xterm:

set -ga terminal-overrides ',xterm*:smcup@:rmcup@'

This tricks the terminal emulator into thinking Tmux is a full screen application like pico or mutt[2], which will make the scrollback be recorded properly. Beware however, it will get a bit messed up when switching between windows/panes. Consider using Tmux's native scrollback instead.

マウスのスクロール

ノート: This interferes with selection buffer copying and pasting. To copy/paste to/from the selection buffer hold the shift key.

マウスホイールでスクロールしたい場合、.tmux.conf で mode-mouse をオンにして下さい:

set -g mouse on

スクロール履歴を設定するには:

set -g history-limit 30000

tmux 2.1 からは、マウスホイールでスクロールするには ~/.tmux.conf に以下のどちらかあるいは両方を追加してみてください:

bind -T root WheelUpPane   if-shell -F -t = "#{alternate_on}" "send-keys -M" "select-pane -t =; copy-mode -e; send-keys -M"
bind -T root WheelDownPane if-shell -F -t = "#{alternate_on}" "send-keys -M" "select-pane -t =; send-keys -M"

上記の設定では一行ずつしかスクロールしませんが、以下を追加することでページ単位でスクロールすることができます:

bind -t vi-copy    WheelUpPane   page-up
bind -t vi-copy    WheelDownPane page-down
bind -t emacs-copy WheelUpPane   page-up
bind -t emacs-copy WheelDownPane page-down

UTF-8 のマウスイベントをターミナルエミュレータがサポートしていない

ターミナルエミュレータが UTF-8 のマウスイベントに対応していない場合、tmux の mouse on オプションを設定しても、ターミナルウィンドウの中で左クリックすると [M#[Ma などの文字列がプロンプトに貼り付けられてしまいます。

この問題を解決するには以下を設定:

set -g mouse-utf8 off

Shift+F6 が Midnight Commander で動作しない

Midnight Commander#Shift+F6 が動作しないを参照してください。

X クリップボードの統合

ヒント: tmux のプラグイン tmux-yank は同じような機能を提供します。

tmux のセレクションを X クリップボード (や X プライマリ/セカンダリセレクション) にコピーしたり、その逆ができます。以下の tmux 設定ファイルのスニペットは xsel プログラムを使って X クリップボード/セレクションと tmux のセレクションを効果的に統合します:

# Emacs style
bind-key -t emacs-copy M-w copy-pipe "xsel -i -p && xsel -o -p | xsel -i -b"
bind-key C-y run "xsel -o | tmux load-buffer - ; tmux paste-buffer"
# Vim style
bind-key -t vi-copy y copy-pipe "xsel -i -p && xsel -o -p | xsel -i -b"
bind-key p run "xsel -o | tmux load-buffer - ; tmux paste-buffer"

xclip could also be used for that purpose, unlike xsel it works better on printing raw bitstream that doesn't fit the current locale. Nevertheless, it is neater to use xsel instead of xclip, because xclip does not close STDOUT after it has read from tmux's buffer. As such, tmux doesn't know that the copy task has completed, and continues to wait for xclip's termination, thereby rendering tmux unresponsive. A workaround is to redirect STDOUT of xclip to /dev/null, like in the following:

# Vim style
bind-key -t vi-copy y copy-pipe "xclip -i -sel clip > /dev/null"
bind-key p run "xclip -o -sel clip | tmux load-buffer - ; tmux paste-buffer"

Urxvt の中クリック

ノート: To use this, you need to enable mouse support

中マウスのクリックによって tmux で urxvt のコピーアンドペーストを有効にする非公式の perl 拡張が存在します (公式の FAQ に記載があります)。

まず、perl スクリプトをダウンロードして urxvts の perl ライブラリに配置してください:

wget http://anti.teamidiot.de/static/nei/*/Code/urxvt/osc-xterm-clipboard
mv osc-xterm-clipboard /usr/lib/urxvt/perl/

また、.Xdefaults で perl スクリプトを有効にする必要があります:

~/.Xdefaults
...
*URxvt.perl-ext-common:		osc-xterm-clipboard
...

Next, you want to tell tmux about the new function and enable mouse support (if you haven't already):

~/.tmux.conf
...
set-option -ga terminal-override ',rxvt-uni*:XT:Ms=\E]52;%p1%s;%p2%s\007'
set -g mouse on
...

That's it. Be sure to end all instances of tmux before trying the new MiddleClick functionality.

While in tmux, Shift+MiddleMouseClick will paste the clipboard selection while just MiddleMouseClick will paste your tmux buffer. Outside of tmux, just use MiddleMouseClick to paste your tmux buffer and your standard Ctrl-c to copy.

Tips and tricks

デフォルトのセッションレイアウトで tmux を起動

Tmux のデフォルトセッションレイアウトを設定するには、AUR から tmuxinatorAUR をインストールします。次のコマンドでインストールをテストできます:

tmuxinator doctor

デフォルトのレイアウト値を取得

Start Tmux as usual and configure your windows and panes layout as you like. When finished, get the current layout values by executing (while you are still within the current Tmux session)

tmux list-windows

The output may look like this (two windows with 3 panes and 2 panes layout)

0: default* (3 panes) [274x83] [layout 20a0,274x83,0,0{137x83,0,0,3,136x83,138,0[136x41,138,0,5,136x41,138,42,6]}] @2 (active)
1: remote- (2 panes) [274x83] [layout e3d3,274x83,0,0[274x41,0,0,4,274x41,0,42,7]] @3                                         

The Interesting part you need to copy for later use begins after [layout... and excludes ... ] @2 (active). For the first window layout you need to copy e.g. 20a0,274x83,0,0{137x83,0,0,3,136x83,138,0[136x41,138,0,5,136x41,138,42,6]}

デフォルトの tmux レイアウトを定義する

Knowing this, you can exit the current tmux session. Following this, you create your default Tmux session layout by editing Tmuxinator's config file (Don't copy the example, get your layout values as described above)

~/.tmuxinator/default.yml
name: default
root: ~/
windows:
  - default:
      layout: 20a0,274x83,0,0{137x83,0,0,3,136x83,138,0[136x41,138,0,5,136x41,138,42,6]}
      panes:
        - clear
        - vim
        - clear && emacs -nw
  - remote:
      layout: 24ab,274x83,0,0{137x83,0,0,3,136x83,138,0,4}
      panes:
        - 
        - 

The example defines two windows named "default" and "remote". With your determined layout values. For each pane you have to use at least one - line. Within the first window panes you start the commandline "clear" in pane one, "vim" in pane two and "clear && emacs -nw" executes two commands in pane three on each Tmux start. The second window layout has two panes without defining any start commmands.

Test the new default layout with (yes, it is "mux"):

mux default

デフォルトの tmux レイアウトで tmux を自動起動

If you like to start your terminal session with your default Tmux session layout edit

~/.bashrc
 if [ -z "$TMUX" ]; then
   mux default          
 fi                     

urxvt で tmux を起動

Use this command to start urxvt with a started tmux session. I use this with the exec command from my .ratpoisonrc file.

urxvt -e bash -c "tmux -q has-session && exec tmux attach-session -d || exec tmux new-session -n$USER -s$USER@$HOSTNAME"

シェルのログイン時に tmux を起動

Simply add the following line of bash code to your .bashrc before your aliases; the code for other shells is very similar:

~/.bashrc
# If not running interactively, do not do anything
[[ $- != *i* ]] && return
[[ -z "$TMUX" ]] && exec tmux
ノート: This snippet ensures that tmux is not launched inside of itself (something tmux usually already checks for anyway). tmux sets $TMUX to the socket it is using whenever it runs, so if $TMUX isn't set or is length 0, we know we aren't already running tmux.

Add the following snippet to start only one session(unless you start some manually), on login, try attach at first, only create a session if no tmux is running.

# TMUX
if which tmux >/dev/null 2>&1; then
    #if not inside a tmux session, and if no session is started, start a new session
    test -z "$TMUX" && (tmux attach || tmux new-session)
fi

The following snippet does the same thing, but also checks tmux is installed before trying to launch it. It also tries to reattach you to an existing tmux session at logout, so that you can shut down every tmux session quickly from the same terminal at logout.

# TMUX
if which tmux >/dev/null 2>&1; then
    # if no session is started, start a new session
    test -z ${TMUX} && tmux

    # when quitting tmux, try to attach
    while test -z ${TMUX}; do
        tmux attach || break
    done
fi

Another possibility is to try to attach to existing deattached session or start a new session:

if [[ -z "$TMUX" ]] ;then
    ID="`tmux ls | grep -vm1 attached | cut -d: -f1`" # get the id of a deattached session
    if [[ -z "$ID" ]] ;then # if not available create a new one
        tmux new-session
    else
        tmux attach-session -t "$ID" # if available attach to it
    fi
fi

非ログインシェルを起動する

Tmux は デフォルトログインシェル を起動するようになっていますが、これは複数の副作用があります:

  • fortune を使っている場合、新しいパネルを作成するたびに引用句が表示されることがあります。
  • 新しいパネルを作成するたびに ~/.profile などのログインシェルの設定ファイルが解釈されるため、セッションの初期化時に実行するようにしていたコマンド (例: オーディオレベルの設定) が実行されてしまいます。

この挙動を無効化するには、以下を ~/.tmux.conf に追加してください:

set -g default-command "${SHELL}"

tmux のウィンドウをタブのように使う

以下の設定を ~/.tmux.conf に追加することで tmux のウィンドウをタブのように使うことができます (urxvt のタブ拡張を参照)。仮想タブはターミナルエミュレータから独立しているという利点があります。

#urxvt tab like window switching (-n: no prior escape seq)
bind -n S-down new-window
bind -n S-left prev
bind -n S-right next
bind -n C-left swap-window -t -1
bind -n C-right swap-window -t +1

Of course, those should not overlap with other applications' hotkeys, such as the terminal's. Given that they substitute terminal tabbing that might as well be deactivated, though.

It can also come handy to supplement the EOT hotkey Ctrl+d with one for tmux's detach:

bind-key -n C-j detach

様々なウィンドウのセッションを同時に操作するクライアント

Practical Tmux で、Brandur Leach は以下のように書いています:

複数のクライアントを一つのセッションにアタッチする際、Screen と tmux の挙動は少々異なっています。Screen では、各クライアントがセッションに接続され、セッションの中で別々のウィンドウが表示されます。tmux では、一つのセッションに接続された全てのクライアントが同じウィンドウを表示します。
This problem can be solved in tmux by spawning two separate sessions and synchronizing the second one to the windows of the first, then pointing a second new session to the first.

The script “tmx” below implements this — the version here is slightly modified to execute “tmux new-window” if “1” is its second parameter. Invoked as tmx <base session name> [1] it launches the base session if necessary. Otherwise a new “client” session linked to the base, optionally add a new window and attach, setting it to kill itself once it turns “zombie”.

tmx
#!/bin/bash

#
# Modified TMUX start script from:
#     http://forums.gentoo.org/viewtopic-t-836006-start-0.html
#
# Store it to `~/bin/tmx` and issue `chmod +x`.
#

# Works because bash automatically trims by assigning to variables and by 
# passing arguments
trim() { echo $1; }

if [[ -z "$1" ]]; then
    echo "Specify session name as the first argument"
    exit
fi

# Only because I often issue `ls` to this script by accident
if [[ "$1" == "ls" ]]; then
    tmux ls
    exit
fi

base_session="$1"
# This actually works without the trim() on all systems except OSX
tmux_nb=$(trim `tmux ls | grep "^$base_session" | wc -l`)
if [[ "$tmux_nb" == "0" ]]; then
    echo "Launching tmux base session $base_session ..."
    tmux new-session -s $base_session
else
    # Make sure we are not already in a tmux session
    if [[ -z "$TMUX" ]]; then
        echo "Launching copy of base session $base_session ..."
        # Session id is date and time to prevent conflict
        session_id=`date +%Y%m%d%H%M%S`
        # Create a new session (without attaching it) and link to base session 
        # to share windows
        tmux new-session -d -t $base_session -s $session_id
        if [[ "$2" == "1" ]]; then
		# Create a new window in that session
		tmux new-window
	fi
        # Attach to the new session & kill it once orphaned
	tmux attach-session -t $session_id \; set-option destroy-unattached
    fi
fi

A useful setting for this is

setw -g aggressive-resize on

added to ~/.tmux.conf. It causes tmux to resize a window based on the smallest client actually viewing it, not on the smallest one attached to the entire session.

An alternative taken from [3] is to put the following ~/.bashrc:

.bashrc
function rsc() {
  CLIENTID=$1.`date +%S`
  tmux new-session -d -t $1 -s $CLIENTID \; set-option destroy-unattached \; attach-session -t $CLIENTID
}

function mksc() {
  tmux new-session -d -s $1
  rsc $1
}

Citing the author:

"mksc foo" creates a always detached permanent client named "foo". It also calls "rsc foo" to create a client to newly created session. "rsc foo" creates a new client grouped by "foo" name. It has destroy-unattached turned on so when I leave it, it kills client.
Therefore, when my computer looses network connectivity, all "foo.something" clients are killed while "foo" remains. I can then call "rsc foo" to continue work from where I stopped.

tmux を再起動せずに変更した設定を適用する

デフォルトでは tmux は起動時にしか ~/.tmux.conf を読み込みません。起動した後に設定ファイルを tmux に読み込ませるには、次を実行:

tmux source-file <path>

~/.tmux.conf に以下のように追加することもできます:

bind r source-file <path>

^: を実行してから以下を入力する方法もあります:

source .tmux.conf

既存のセッションに新しいセッションがアタッチされるたびにプログラムを実行するテンプレートスクリプト

This script checks for a program presumed to have been started by a previous run of itself. Unless found it creates a new tmux session and attaches to a window named after and running the program. If however the program was found it merely attaches to the session and selects the window.

#!/bin/bash

PID=$(pidof $1)

if [ -z "$PID" ]; then
    tmux new-session -d -s main ;
    tmux new-window -t main -n $1 "$*" ;
fi
    tmux attach-session -d -t main ;
    tmux select-window -t $1 ;
exit 0

nicklist プラグインを使って irssi を実行する派生版は irssi の ArchWiki ページにあります。

ターミナルエミュレータのウィンドウタイトル

tmux ウィンドウで SSH 接続を行うと、ターミナルエミュレータのウィンドウタイトルが user@localhost のままで user@server にならないことに気づくかもしれません。タイトルバーを接続先のホストにあわせて変えられるようにするには、~/.tmux.conf に以下を設定します:

set -g set-titles on
set -g set-titles-string "#T"

set-titles-string#Tuser@host:~ を表示して、接続したホストによって表示が変わります。

自動レイアウト

When creating new splits or destroying older ones the currently selected layout isn't applied. To fix that, add following binds which will apply the currently selected layout to new or remaining panes:

bind-key -n M-c kill-pane \; select-layout
bind-key -n M-n split-window \; select-layout

Vim フレンドリな設定

vim ユーザーに使いやすい設定は [4] を見て下さい。

参照

チュートリアル