Interact with tmux from Emacs.
emamux.el let emacs interact with tmux. emamux.el is inspired by tslime.vim and vimux.
emamux is available on MELPA and MELPA stable
You can install emamux with the following command.
M-x package-install [RET] emamux [RET]
- Emacs 24 or higher.
- tmux 1.5
Send command to specified target-session(session:window.pane).
Following is emamux:send-command demo with ido completion.
target-session is set as default at first emamux:send-command called.
You can change default target-session with C-u prefix.
Yank from tmux buffer.
Copy content of (car kill-ring) to tmux buffer
You can change buffer index with Numerical Prefix.
Following commands can be executed only within tmux
Run command in a small split pane(runner pane) where emacs is in.
Run last command in runner pane.
Zoom runner runner pane. This command requires tmux 1.8 or higher.
Move into the runner pane and enter the copy mode.
Close runner pane.
Close all other panes in current window.
Interrupt command which is running in runner-pane.
Clear tmux history in runner-pane
Completing read function type. You can choice from 'normal or 'ido, or 'helm.
Orientation of split pane, 'vertical or 'horizonal(Default is 'vertical).
Height of runner-pane(Default is 20).
Use nearest pane as runner pane instead of splitting pane(Default is nil).
It is useful for using emamux to show session name, window index and
pane index in tmux status bar.
# '#S' is session name, '#I' is window index, '#P' is pane index
set-option -g status-right '[#h###S:#I:#P]'
emamux defines default keymap. You can use it by following configuration.
;; Bind keymap prefix to Ctrl-z
(global-set-key (kbd "C-z") emamux:keymap)Default keymap is as below.
| Key | Command |
|---|---|
| Prefix C-s | emamux:send-command |
| Prefix C-y | emamux:yank-from-list-buffers |
| Prefix M-! | emamux:run-command |
| Prefix M-r | emamux:run-last-command |
| Prefix M-s | emamux:run-region |
| Prefix C-i | emamux:inspect-runner |
| Prefix C-k | emamux:close-panes |
| Prefix C-c | emamux:interrupt-runner |
| Prefix M-k | emamux:clear-runner-history |
| Prefix c | emamux:new-window |
| Prefix C | emamux:clone-current-frame |
| Prefix 2 | emamux:split-window |
| Prefix 3 | emamux:split-window-horizontally |
(custom-set-variables
'(emamux:completing-read-type 'helm))- emamux-perl-test a set of commands to easily run perl tests
- emamux-ruby-test a set of commands to easily run ruby tests