tmux-plugins/tmux-continuum
1
0
Fork 0
mirror of https://github.com/tmux-plugins/tmux-continuum.git synced 2024-11-22 11:18:47 +00:00
Code Issues Projects Releases Wiki Activity

Update readme with automatic restore feature description

Browse Source
This commit is contained in:
Bruno Sutic 2015-02-15 22:34:12 +01:00
parent 99658eda98
commit 103ed0159e
No known key found for this signature in database
GPG Key ID: 66D96E4F2F7EF26C
1 changed files with 27 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
README.md
View File

@ -1,12 +1,24 @@
# tmux-resurrect-auto # tmux-resurrect-auto
Continuous saving of tmux environment. Continuous saving of tmux environment. Automatic restore when tmux is started.
#### Continuous saving
After this plugin is installed, `tmux-resurrect` will save environment at the 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 interval of 15 minutes. All the saving happens in the background without the
impact to your workflow. impact to your workflow.
Requirements / dependencies: `tmux 1.9` or higher, `bash`, #### Automatic restore
Last saved environment is automatically restored when tmux server is started.
Put `set -g @resurrect-auto-restore 'on'` in `tmux.conf` to enable this.
Note: automatic restore happens **exclusively** on tmux server start. No other
action (e.g. sourcing `tmux.conf`) triggers this.
#### Dependencies
`tmux 1.9` or higher, `bash`,
[tmux-resurrect](https://github.com/tmux-plugins/tmux-resurrect) plugin. [tmux-resurrect](https://github.com/tmux-plugins/tmux-resurrect) plugin.
### Installation with [Tmux Plugin Manager](https://github.com/tmux-plugins/tpm) (recommended) ### Installation with [Tmux Plugin Manager](https://github.com/tmux-plugins/tpm) (recommended)
@ -52,8 +64,9 @@ required.
> Will a previous save be overwritten immediately after I start tmux? > 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 No, first automatic save starts 15 minutes after tmux is started. If automatic
enough time to restore from a previous save. restore is not enabled, that gives you enough time to manually restore from a
previous save.
> I want to make a restore to a previous point in time, but it seems that save > I want to make a restore to a previous point in time, but it seems that save
is now overwritten? is now overwritten?
@ -66,7 +79,7 @@ Here are the steps to restore to a previous point in time:
- `$ cd ~/.tmux/resurrect/` - `$ cd ~/.tmux/resurrect/`
- locate the save file you'd like to use for restore (file names have a timestamp) - 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` - symlink the `last` file to the desired save file: `$ ln -sf <file_name> last`
- do a restore with `prefix + Ctrl-r` - do a restore with `tmux-resurrect` binding: `prefix + Ctrl-r`
You should now be restored to the time when `<file_name>` save happened. You should now be restored to the time when `<file_name>` save happened.
@ -95,6 +108,15 @@ Just set the save interval to `0`. Put this in `.tmux.conf`
and then source `tmux.conf` by executing this command in the shell and then source `tmux.conf` by executing this command in the shell
`tmux source ~/.tmux.conf`. `tmux source ~/.tmux.conf`.
> I had automatic restore turned on, how do I disable it now?
Just remove `set -g @resurrect-auto-restore 'on'` from `tmux.conf`.
To be absolutely sure automatic restore doesn't happen, create a
`tmux_no_auto_restore` file in your home directory (command:
`touch ~/tmux_no_auto_restore`). Automatic restore won't happen if this file
exists.
### Other goodies ### Other goodies
- [tmux-copycat](https://github.com/tmux-plugins/tmux-copycat) - a plugin for - [tmux-copycat](https://github.com/tmux-plugins/tmux-copycat) - a plugin for