tmux-plugins/tmux-sensible
1
0
Fork 0
mirror of https://github.com/tmux-plugins/tmux-sensible.git synced 2024-12-22 03:18:48 +00:00
Code Issues Projects Releases Wiki Activity
9 Commits 1 Branch 7 Tags 140 KiB
Shell 100%
89a51c86e3
Go to file
Bruno Sutic 89a51c86e3 Do not force prefix to C-a 
Assuming no one uses C-b as the default prefix is a wrong assumption.

Instead of making any assumption about the prefix, we're "building" on
top of whatever the user has set.

The following key-bindings will be set if prefix is set to C-a:
- `C-a + C-a` - sends prefix character
- `C-a + a` - switches to the last window

Likewise, if C-b is prefix, then the additional bindings will be
`C-b + C-b` and `C-b + b`.

Closes #1
2014-08-04 17:23:50 +02:00
CHANGELOG.md Do not force prefix to C-a 2014-08-04 17:23:50 +02:00
LICENSE.md First commit 2014-07-30 16:33:51 +02:00
README.md Add readme 2014-07-30 18:05:27 +02:00
sensible.tmux Do not force prefix to C-a 2014-08-04 17:23:50 +02:00

README.md

Tmux sensible

A set of tmux options that should be acceptable for everyone.

Inspired by vim-sensible.

Principles

  • tmux-sensible options should be acceptable to every tmux user!
    If any option bothers you, please open an issue and it will probably be updated (or removed).
  • if you think a new option should be added, feel free to open a pull request.
  • no overriding of user defined settings.
    Your existing .tmux.conf settings are respected and they won't be changed. That way you can use tmux-sensible if you have a few specific options. See feature section for an example.
  • source code is the authoritative documentation.
    It's really not that scary and you should have a look, even if you're a tmux beginner.

Goals

  • group standard tmux community options in one place
  • remove clutter from your .tmux.conf
  • educate new tmux users about basic options

Example feature

Sets tmux prefix to Ctrl-a.

# set prefix to `Ctrl-a`
tmux set-option -g prefix C-a
tmux unbind-key C-b

Since user defined .tmux.conf settings are respected, if prefix is set to Ctrl-z - it won't be overriden!

Installation with Tmux Plugin Manager (recommended)

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

set -g @tpm_plugins "             \
  tmux-plugins/tpm                \
  tmux-plugins/tmux-sensible      \
"

Hit prefix + I to fetch the plugin and source it. That's it!

You might also want to restart your tmux server, just in case.

Manual Installation

Clone the repo:

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

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

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

Reload TMUX environment:

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

You might also want to restart your tmux server, just in case.

Other goodies

You might also find these useful:

  • copycat improve tmux search and reduce mouse usage
  • pain control useful standard bindings for controlling panes

License

MIT