tmux-plugins/tmux-sensible
1
0
Fork 0
mirror of https://github.com/tmux-plugins/tmux-sensible.git synced 2024-11-05 05:18:47 +00:00
Code Issues Projects Releases Wiki Activity
6 Commits 1 Branch 7 Tags 137 KiB
Shell 100%
97904bc483
Go to file
Bruno Sutic 97904bc483 Bugfix: default-command utilizes $SHELL env var 
The `default-command` setting on OS X determines the default shell if
`default-shell` is not set.
This update enables use of any user defined shell, even if
`default-shell` is not set.

Fixes #2
2014-08-04 16:01:30 +02:00
CHANGELOG.md Bugfix: default-command utilizes $SHELL env var 2014-08-04 16:01:30 +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 Bugfix: default-command utilizes $SHELL env var 2014-08-04 16:01:30 +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