Go to file
2015-02-12 03:41:18 +01:00
scripts Initializer script checks tmux version 2015-02-12 03:37:34 +01:00
CHANGELOG.md Initializer script checks tmux version 2015-02-12 03:37:34 +01:00
CONTRIBUTING.md First working version 2015-02-11 15:43:37 +01:00
LICENSE.md First working version 2015-02-11 15:43:37 +01:00
README.md Mention latest tmux-resurrect version is required 2015-02-12 03:41:18 +01:00
resurrect_auto.tmux Initializer script checks tmux version 2015-02-12 03:37:34 +01:00

tmux-resurrect-auto

Continuous saving of tmux environment.

After this plugin is installed, tmux-resurrect will save environment at the interval of 15 minutes. All the saving happens in the background without the impact to your workflow.

Requirements / dependencies: tmux 1.9 or higher, bash, tmux-resurrect plugin.

Please make sure you have the latest version of tmux-resurrect installed (as of Feb 2015).

Add plugin to the list of TPM plugins in .tmux.conf:

set -g @tpm_plugins '                \
  tmux-plugins/tpm                   \
  tmux-plugins/tmux-resurrect        \
  tmux-plugins/tmux-resurrect-auto   \
'

Hit prefix + I to fetch the plugin and source it. The plugin will automatically start "working" in the background, no action required.

Manual Installation

Please make sure you have the latest version of tmux-resurrect installed (as of Feb 2015).

Clone the repo:

$ git clone https://github.com/tmux-plugins/tmux-resurrect-auto ~/clone/path

Add this line to the bottom of .tmux.conf:

run-shell ~/clone/path/resurrect_auto.tmux

Reload TMUX environment:

# type this in terminal
$ tmux source-file ~/.tmux.conf

The plugin will automatically start "working" in the background, no action required.

FAQ

Will a previous save be overwritten immediately after I start tmux?

No, first automatic save starts 15 minutes after tmux is started. That gives you enough time to restore from a previous save.

I want to make a restore to a previous point in time, but it seems that save is now overwritten?

None of the previous saves are deleted (unless you explicitly do that). All save files are kept in ~/.tmux/resurrect/ directory.
Here are the steps to restore to a previous point in time:

  • make sure you start this with a "fresh" tmux instance
  • $ cd ~/.tmux/resurrect/
  • locate the save file you'd like to use for restore (file names have a timestamp)
  • symlink the last file to the desired save file: $ ln -sf <file_name> last
  • do a restore with prefix + Ctrl-r

You should now be restored to the time when <file_name> save happened.

Will this plugin fill my hard disk?

Most likely no. A regular save file is in the range of 5Kb. That said, it would be good to clean out old save files from ~/.tmux/resurrect/ dir from time to time.

Configuration

  • set the save interval to 60 minutes (the default is 15, the number is always in minutes)

      set -g @resurrect-auto-save-interval '60'
    

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

Reporting bugs and contributing

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

License

MIT