tmux-resurrect README

The project's README from github.com/tmux-plugins/tmux-resurrect. As one markdown file: README.md.

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

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:

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

Other goodies

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-resurrect (tmux-plugins/tmux-resurrect)

Searching Database…

Что это такое?Плагин для tmux, который сохраняет всё окружение tmux (сессии, окна, панели, раскладки, запущенные программы) и восстанавливает его после перезагрузки системы.
Это отдельное приложение или плагин для tmux?Это плагин для tmux (скрипты shell), который встраивается в ваш конфиг tmux, а не отдельное приложение.
Как это установить и пользоваться?Добавьте 'set -g @plugin tmux-plugins/tmux-resurrect' в .tmux.conf и нажмите prefix + I в Tmux Plugin Manager, либо вручную клонируйте репозиторий и добавьте 'run-shell ~/clone/path/resurrect.tmux' в .tmux.conf. Затем используйте prefix + Ctrl-s для сохранения и prefix + Ctrl-r для восстановления.
Что нужно для работы?Достаточно tmux версии 1.9 или выше и bash; дополнительной настройки из коробки не требуется.
Восстанавливает ли он автоматически все запущенные программы?Нет, восстанавливается только консервативный список программ по умолчанию (vi, vim, nvim, emacs, man, less, more, tail, top, htop, irssi, weechat, mutt); остальные программы требуют дополнительной настройки согласно документации по восстановлению программ.
Работает ли это на Mac и Windows, или только на Linux?Протестирован и работает на Linux, macOS (OSX) и Cygwin.
Не испортит ли он уже открытые панели?Нет, он идемпотентен: не перезаписывает существующие панели и окна, за исключением единственной стартовой панели, которая создаётся при запуске tmux с нуля для восстановления сохранённого окружения.
Может ли он восстановить и мои сессии vim?Да, восстановление сессий vim и neovim — это необязательная функция, которую он поддерживает.
Он сохраняет всё автоматически или мне нужно сохранять вручную?Сам по себе вы сохраняете и восстанавливаете вручную с помощью горячих клавиш, но в связке с плагином tmux-continuum появляется автоматическое непрерывное сохранение и восстановление.
Что именно восстанавливается?Восстанавливаются сессии, окна, панели и их порядок, рабочие каталоги, точная раскладка панелей (даже если панель развёрнута на весь экран), активные и альтернативные сессии и окна, фокус на окне, сгруппированные сессии и даже программы, запущенные в каждой панели.
Size
0.6 MB
Stars
13.1K
Updated
CommitMar 06
Age
12y
Commits · 90 Days