Skip to content

Latest commit

 

History

History
107 lines (67 loc) · 3.34 KB

README.md

File metadata and controls

107 lines (67 loc) · 3.34 KB

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

To setup continuous saving set an interval (in minutes) in your tmux.conf file:

set -g @continuum-save-interval '15'

All the saving happens in the background without the impact to your workflow. It is recommended that you don't set the interval too low to keep continuum from overwriting your existing resurrect save on starting tmux.

Automatic tmux start

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

See the instructions 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.

Installation with Tmux Plugin Manager (recommended)

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

You might want to follow @brunosutic on twitter if you want to hear about new tmux plugins or feature updates.

Reporting bugs and contributing

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

License

MIT