Restore tmux
environment after system restart.
Tmux is great, except when you have to restart the computer. You lose all the running programs, working directories, pane layouts etc. There are helpful management tools out there, but they require initial configuration and continuous updates as your workflow evolves or you start new projects.
tmux-resurrect
saves all the little details from your tmux environment so it
can be completely restored after a system restart (or when you feel like it).
No configuration is required. You should feel like you never quit tmux.
It even (optionally) restores vim and neovim sessions!
Automatic restoring and continuous saving of tmux env is also possible with tmux-continuum plugin.
prefix + Ctrl-s
- saveprefix + Ctrl-r
- restoreThis plugin goes to great lengths to save and restore all the details from your
tmux
environment. Here's what's been taken care of:
Optional:
Requirements / dependencies: tmux 1.9
or higher, bash
.
Tested and working on Linux, OSX and Cygwin.
tmux-resurrect
is idempotent! It will not try to restore panes or windows that
already exist.
The single exception to this is when tmux is started with only 1 pane in order
to restore previous tmux env. Only in this case will this single pane be
overwritten.
Add plugin to the list of TPM plugins in .tmux.conf
:
set -g @plugin 'tmux-plugins/tmux-resurrect'
Hit prefix + I
to fetch the plugin and source it. You should now be able to
use the plugin.
Clone the repo:
$ git clone https://github.com/tmux-plugins/tmux-resurrect ~/clone/path
Add this line to the bottom of .tmux.conf
:
run-shell ~/clone/path/resurrect.tmux
Reload TMUX environment with: $ tmux source-file ~/.tmux.conf
.
You should now be able to use the plugin.
Configuration
vi vim nvim emacs man less more tail top htop irssi weechat mutt
.tmux-resurrect
saves tmux
environment.Optional features
Both contributing and bug reports are welcome. Please check out contributing guidelines.
Mislav Marohnić - the idea for the plugin came from his tmux-session script.