2013-04-16 07:29:41 -04:00
|
|
|
.tmux
|
|
|
|
|
=====
|
|
|
|
|
|
|
|
|
|
Self-contained, opinionated `.tmux.conf` configuration file.
|
|
|
|
|
|
2015-03-28 05:17:43 -04:00
|
|
|
|
2014-02-15 15:35:38 -05:00
|
|
|
|
2014-02-28 05:41:39 -05:00
|
|
|
The `master` branch targets tmux 1.9+. You may want to use the `1.7` or `1.8`
|
|
|
|
|
branch.
|
|
|
|
|
|
2014-08-29 14:51:28 -04:00
|
|
|
**Please note that the official tmux 1.9 and 1.9a SEGFAULT when using the
|
|
|
|
|
maximize pane feature. Some Linux distributions like Debian provide a patched
|
|
|
|
|
tmux 1.9a. Depending on whether or not the running tmux version has a buggy
|
|
|
|
|
`swap-pane` command, the maximize pane feature may be disabled. On Mac OS X,
|
|
|
|
|
I've been using tmux `HEAD` for a while without troubles (`brew install --HEAD
|
|
|
|
|
tmux`). The `swap-pane` command has been fixed in upstream by commit
|
|
|
|
|
`78e783e`.**
|
2014-02-28 05:41:39 -05:00
|
|
|
|
2013-04-16 07:29:41 -04:00
|
|
|
Features
|
2013-07-15 04:56:31 -04:00
|
|
|
--------
|
2013-04-16 07:29:41 -04:00
|
|
|
|
|
|
|
|
- `C-a` acts as secondary prefix, while keeping default `C-b` prefix
|
|
|
|
|
- visual theme inspired by [powerline](https://github.com/Lokaltog/powerline)
|
2014-08-29 14:51:28 -04:00
|
|
|
- [maximize any pane to a new window with `<prefix>+`](http://pempek.net/articles/2013/04/14/maximizing-tmux-pane-new-window/) (tmux 1.6+)
|
2013-08-26 18:52:49 -04:00
|
|
|
- mouse mode toggle with `<prefix>m`
|
2013-07-15 05:04:39 -04:00
|
|
|
- automatic usage of `reattach-to-user-namespace` if available
|
2014-02-15 12:39:11 -05:00
|
|
|
- laptop battery status
|
2014-12-13 07:09:21 -05:00
|
|
|
- configurable new windows and panes behavior (optionally retain current path)
|
2013-07-15 04:56:31 -04:00
|
|
|
|
|
|
|
|
Installation
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
$ cd
|
|
|
|
|
$ rm -rf .tmux
|
|
|
|
|
$ git clone https://github.com/gpakosz/.tmux.git
|
|
|
|
|
$ ln -s .tmux/.tmux.conf
|
2014-08-29 14:51:28 -04:00
|
|
|
$ cp .tmux/.tmux.conf.local .
|
|
|
|
|
|
|
|
|
|
If you're a ViM user, setting the `$EDITOR` environment variable to `vim` will
|
|
|
|
|
enable and further customize the vi-style key bindings (see tmux manual).
|
|
|
|
|
|
|
|
|
|
### Configuring the visual theme
|
|
|
|
|
|
2014-09-01 03:07:48 -04:00
|
|
|
You first need to install [fonts patched with powerline symbols][] (see also
|
|
|
|
|
[powerline manual][]).
|
2014-08-29 14:51:28 -04:00
|
|
|
|
|
|
|
|
Then edit your `~/.tmux.conf.local` file and uncomment the following line:
|
|
|
|
|
|
|
|
|
|
#tmux_conf_theme=powerline_patched_font
|
|
|
|
|
|
|
|
|
|
[fonts patched with powerline symbols]: https://github.com/Lokaltog/powerline-fonts
|
|
|
|
|
[powerline manual]: http://powerline.readthedocs.org/en/latest/installation.html#fonts-installation
|
|
|
|
|
|
|
|
|
|
### Configuring the battery indicator
|
|
|
|
|
|
|
|
|
|
Edit your `~/.tmux.conf.local` file and uncomment the following lines:
|
|
|
|
|
|
|
|
|
|
#tmux_conf_battery_symbol=heart
|
|
|
|
|
#tmux_conf_battery_symbol_count=5
|
|
|
|
|
|
2015-03-28 05:17:43 -04:00
|
|
|
To use a heat palette for the battery indicator, edit your `~/.tmux.conf.local`
|
|
|
|
|
file and uncomment the following line:
|
|
|
|
|
|
|
|
|
|
#tmux_conf_battery_palette=heat
|
|
|
|
|
|
2014-08-29 14:51:28 -04:00
|
|
|
See `~/.tmux.conf.local` for more details.
|
2013-07-15 05:04:39 -04:00
|
|
|
|
2014-12-13 07:09:21 -05:00
|
|
|
### Configuring new windows and new panes creation
|
|
|
|
|
|
|
|
|
|
Edit your `~/.tmux.conf.local` file and uncomment the following lines:
|
|
|
|
|
|
|
|
|
|
#tmux_conf_new_windows_retain_current_path=false
|
|
|
|
|
#tmux_conf_new_panes_retain_current_path=true
|
|
|
|
|
|
|
|
|
|
See `~/.tmux.conf.local` for more details.
|
|
|
|
|
|
2013-07-15 05:04:39 -04:00
|
|
|
### Accessing the Mac OSX clipboard from within tmux sessions
|
|
|
|
|
|
|
|
|
|
[Chris Johnsen created the `reattach-to-user-namespace`
|
2013-11-02 04:48:41 -04:00
|
|
|
utility](https://github.com/ChrisJohnsen/tmux-MacOSX-pasteboard) that makes
|
2013-07-15 05:04:39 -04:00
|
|
|
`pbcopy` and `pbpaste` work again within `tmux`.
|
|
|
|
|
|
|
|
|
|
If available, `reattach-to-user-namespace` will be automatically used by this
|
2015-04-15 09:15:35 -04:00
|
|
|
`tmux` configuration. You just have to install it for instance with
|
|
|
|
|
[`brew`](http://brew.sh/):
|
2013-07-15 05:04:39 -04:00
|
|
|
|
2014-03-10 03:09:16 -04:00
|
|
|
$ brew install reattach-to-user-namespace
|
