tmux-resurrect

Persists tmux environment across system restarts.

Github星跟蹤圖

Tmux Resurrect

Build Status

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.

Screencast

screencast screenshot

Key bindings

  • prefix + Ctrl-s - save
  • prefix + Ctrl-r - restore

About

This plugin goes to great lengths to save and restore all the details from your
tmux environment. Here's what's been taken care of:

  • all sessions, windows, panes and their order
  • current working directory for each pane
  • exact pane layouts within windows (even when zoomed)
  • active and alternative session
  • active and alternative window for each session
  • windows with focus
  • active pane for each window
  • "grouped sessions" (useful feature when using tmux with multiple monitors)
  • programs running within a pane! More details in the
    restoring programs doc.

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.

Manual Installation

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.

Docs

Configuration

Optional features

Experimental features (also optional)

Other goodies

  • tmux-copycat - a plugin for
    regex searches in tmux and fast match selection
  • tmux-yank - enables copying
    highlighted text to system clipboard
  • tmux-open - a plugin for quickly
    opening highlighted file or a url
  • tmux-continuum - automatic
    restoring and continuous saving of tmux env

Reporting bugs and contributing

Both contributing and bug reports are welcome. Please check out
contributing guidelines.

Credits

Mislav Marohnić - the idea for the plugin came from his
tmux-session script.

License

MIT

主要指標

概覽
名稱與所有者tmux-plugins/tmux-resurrect
主編程語言Shell
編程語言Shell (語言數: 1)
平台
許可證MIT License
所有者活动
創建於2014-08-26 04:46:17
推送於2024-08-14 07:51:42
最后一次提交2023-03-06 18:20:22
發布數21
最新版本名稱v4.0.0 (發布於 2022-04-10 14:40:51)
第一版名稱v0.0.1 (發布於 2014-08-26 19:22:14)
用户参与
星數12.2k
關注者數87
派生數467
提交數306
已啟用問題?
問題數421
打開的問題數225
拉請求數40
打開的拉請求數50
關閉的拉請求數39
项目设置
已啟用Wiki?
已存檔?
是復刻?
已鎖定?
是鏡像?
是私有?