Go to file
Bruno Sutic 0698e8f4b1
Merge pull request #132 from rmartine-ias/osx-added-plist
Only add macOS .plist file if contents have changed
2024-01-20 13:37:57 +01:00
docs fix b0rk link to systemd details 2022-06-09 19:37:02 +00:00
scripts Only add macOS .plist file if contents have changed 2023-12-08 13:26:39 -07:00
.gitattributes Mention cygwin support in the readme 2015-10-08 18:46:50 +02:00
CHANGELOG.md Fix for multiple users on the same machine 2020-02-29 01:37:58 +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 Update doc that status line needs to be on 2021-09-10 12:06:23 -07:00
continuum.tmux Add option to set restore max delay 2021-06-05 14:49:32 +02:00

README.md

tmux-continuum

Features:

  • continuous saving of tmux environment
  • automatic tmux start when computer/server is turned on
  • automatic restore when tmux is started

Together, these features enable uninterrupted tmux usage. No matter the computer or server restarts, if the machine is on, tmux will be there how you left it off the last time it was used.

Tested and working on Linux, OSX and Cygwin.

Continuous saving

Tmux environment will be saved at an interval of 15 minutes. All the saving happens in the background without impact to your workflow.

This action starts automatically when the plugin is installed. Note it requires the status line to be on to run (since it uses a hook in status-right to run).

Automatic tmux start

Tmux is automatically started after the computer/server is turned on.

See the instructions on how to enable this for your system.

Automatic restore

Last saved environment is automatically restored when tmux is started.

Put set -g @continuum-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 plugin.

Please make sure you have tmux-resurrect installed.

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

set -g @plugin 'tmux-plugins/tmux-resurrect'
set -g @plugin 'tmux-plugins/tmux-continuum'

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 tmux-resurrect installed.

Clone the repo:

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

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

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

Reload TMUX environment with: $ tmux source-file ~/.tmux.conf

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

Docs

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

Known Issues

  • In order to be executed periodically, the plugin updates the status-right tmux variable. In case some plugin (usually themes) overwrites the status-right variable, the autosave feature stops working. To fix this issue, place the plugin last in the TPM plugins list.

Reporting bugs and contributing

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

License

MIT