tmux-stare/readme (view raw)
| 1 | tmux-stare |
| 2 | ---------- |
| 3 | |
| 4 | stare (Ukrainian /stɐˈrɛ/ for "something old") - yet another session manager for tmux. |
| 5 | |
| 6 | This plugin was heavily inspired by tmux-continuum and tmux-resurrect, but |
| 7 | I didn't like that they loaded all previous sessions. I wanted a way to |
| 8 | load sessions selectively, so I made this plugin. |
| 9 | |
| 10 | FEATURES |
| 11 | - Automatic saving of sessions |
| 12 | - Selective session recerrect |
| 13 | - Picker for interacting with your sessions |
| 14 | |
| 15 | INSTALLATION |
| 16 | |
| 17 | # with tpm |
| 18 | set -g @plugin 'olexsmir/tmux-stare' |
| 19 | set -g @stare-pick 'o' |
| 20 | |
| 21 | REQUIREMENTS |
| 22 | - tmux (tested on 3.6a) |
| 23 | - fzf (tested on 0.67.0) |
| 24 | |
| 25 | OPTIONS |
| 26 | |
| 27 | # Bind for opening picker to select and restore sessions. |
| 28 | # Default: '' (not set) |
| 29 | set -g @stare-pick 'o' |
| 30 | |
| 31 | # Bind for manually triggering save of all sessions. |
| 32 | # Default: 'C-s' |
| 33 | set -g @stare-save 'C-s' |
| 34 | |
| 35 | # Start action. 'pick' opens picker on start, 'last' restores last session |
| 36 | # Default: '' |
| 37 | set -g @stare-start '' |
| 38 | |
| 39 | # Auto-save interval in minutes. Set to '0' to disable. |
| 40 | # Default: '10' |
| 41 | set -g @stare-interval '10' |
| 42 | |
| 43 | # Directory where session data live. |
| 44 | # Default: '$HOME/.local/share/tmux/stare/' |
| 45 | set -g @stare-dir '$HOME/.local/share/tmux/stare/' |
| 46 | |
| 47 | FUTURE |
| 48 | |
| 49 | Things I might add in the future. |
| 50 | |
| 51 | - Resurrect of vim with ':mksession' |
| 52 | - Keep content of panes |
| 53 | |
| 54 | LICENSE |
| 55 | |
| 56 | tmux-stare is licensed under MIT. |