2013-04-16 07:29:41 -04:00
.tmux
=====
2015-10-17 16:35:07 -04:00
Self-contained, pretty and versatile `.tmux.conf` configuration file.
2013-04-16 07:29:41 -04:00
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
![Screenshot ](https://cloud.githubusercontent.com/assets/553208/19740585/85596a5a-9bbf-11e6-8aa1-7c8d9829c008.gif )
2014-02-15 15:35:38 -05:00
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
Installation
------------
Requirements:
- tmux ** `2.1+` ** running inside Linux, Mac, OpenBSD or Cygwin
- outside of tmux, `$TERM` must be set to `xterm-256color`
2016-10-31 05:28:38 -04:00
To install, run the following from your terminal: (you may want to backup your
existing `~/.tmux.conf` first)
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
```
$ cd
$ git clone https://github.com/gpakosz/.tmux.git
2016-10-31 05:28:38 -04:00
$ ln -s -f .tmux/.tmux.conf
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
$ cp .tmux/.tmux.conf.local .
```
Then proceed to customize your `~/.tmux.conf.local` copy.
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).
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
2015-10-17 16:35:07 -04:00
- visual theme inspired by [Powerline][]
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
- [maximize any pane to a new window with `<prefix> +` ][maximize-pane]
- SSH aware username and hostname status line information
2015-10-17 16:35:07 -04:00
- mouse mode toggle with `<prefix> m`
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
- automatic usage of [`reattach-to-user-namespace`][reattach-to-user-namespace]
if available
- laptop battery status line information
- uptime status line information
- optional highlight of focused pane (tmux `2.1+` )
2014-12-13 07:09:21 -05:00
- configurable new windows and panes behavior (optionally retain current path)
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
- SSH aware split pane (reconnects to remote server, experimental)
2015-10-11 11:52:39 -04:00
- [Facebook PathPicker][] integration if available
2015-10-17 16:35:07 -04:00
- [Urlview][] integration if available
2015-10-11 11:52:39 -04:00
2015-10-17 16:35:07 -04:00
[Powerline]: https://github.com/Lokaltog/powerline
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
[maximize-pane]: http://pempek.net/articles/2013/04/14/maximizing-tmux-pane-new-window/
[reattach-to-user-namespace]: https://github.com/ChrisJohnsen/tmux-MacOSX-pasteboard
2015-10-11 11:52:39 -04:00
[Facebook PathPicker]: https://facebook.github.io/PathPicker/
2015-10-17 16:35:07 -04:00
[Urlview]: https://packages.debian.org/stable/misc/urlview
This configuration uses the following bindings:
- `<prefix> C-c` creates a new session
- `<prefix> e` opens `~/.tmux.conf.local` with the editor defined by the
`$EDITOR` environment variable (defaults to `vim` when empty)
- `<prefix> r` reloads the configuration
- `<prefix> C-f` lets you switch to another session by name
- `<prefix> C-h` and `<prefix> C-l` let you navigate windows (default
`<prefix> n` and `<prefix> p` are unbound)
- `<prefix> Tab` brings you to the last active window
- `<prefix> h` , `<prefix> j` , `<prefix> k` and `<prefix> l` let you navigate
panes ala Vim
2016-07-25 16:01:42 -04:00
- `<prefix> H` , `<prefix> J` , `<prefix> K` , `<prefix> L` let you resize panes
2015-10-17 16:35:07 -04:00
- `<prefix> <` and `<prefix> >` let you swap panes
- `<prefix> +` maximizes the current pane to a new window
- `<prefix> m` toggles mouse mode on or off
- `<prefix> U` launches Urlview (if available)
- `<prefix> F` launches Facebook PathPicker (if available)
- `<prefix> Enter` enters copy-mode
- `<prefix> b` lists the paste-buffers
- `<prefix> p` pastes from the top paste-buffer
- `<prefix> P` lets you choose the paste-buffer to paste from
- `C-l` clears both the screen and the history
2016-07-25 16:01:42 -04:00
Additionally, `vi-choice` , `vi-edit` and `vi-copy` named tables are adjusted
2015-10-17 16:35:07 -04:00
to closely match [my own Vim configuration][]
[my own Vim configuration]: https://github.com/gpakosz/.vim.git
Bindings for the `vi-choice` mode-table:
- `h` collapses the current tree node
- `l` expands the current tree node
2016-07-25 16:01:42 -04:00
- `H` collapses all the tree nodes
2015-10-17 16:35:07 -04:00
- `L` expands all the tree nodes
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
- `K` jumps to the start of list (tmux `2.0+` )
- `L` jumps to the end of list (tmux `2.0+` )
2015-10-17 16:35:07 -04:00
- `Escape` cancels the current operation
Bindings for the `vi-edit` mode-table:
- `H` jumps to the start of line
- `L` jumps to the end of line
- `q` cancels the current operation
- `Escape` cancels the current operation
Bindings for the `vi-copy` mode-table:
- `v` begins selection / visual mode
- `C-v` toggles between blockwise visual mode and visual mode
- `H` jumps to the start of line
- `L` jumps to the end of line
- `y` copies the selection to the top paste-buffer
- `Escape` cancels the current operation
The "maximize any pane to a new window with `<prefix> +` " feature is different
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
from builtin `resize-pane -Z` as it allows you to further split a maximized
pane. It's also more flexible by allowing you to maximize a pane to a new
window, then change window, then go back and the pane is still in maximized
state in its own window. You can then minimize a pane by using `<prefix> +`
either from the source window or the maximized window.
2015-09-15 17:42:17 -04:00
![Maximize pane ](https://cloud.githubusercontent.com/assets/553208/9890858/ee3c0ca6-5c02-11e5-890e-05d825a46c92.gif )
2015-10-17 16:35:07 -04:00
Mouse mode allows you to set the active window, set the active pane, resize
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
panes and automatically switches to copy-mode to select text.
2015-10-17 16:35:07 -04:00
2015-09-15 17:42:17 -04:00
![Mouse mode ](https://cloud.githubusercontent.com/assets/553208/9890797/8dffe542-5c02-11e5-9c06-a25b452e6fcc.gif )
Configuration
-------------
While this configuration tries to bring sane default settings, you may want to
customize it further to your needs. Instead of altering the `~/.tmux.conf` file
and diverging from upstream, the proper way is to edit the `~/.tmux.conf.local`
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
file.
2015-09-15 17:42:17 -04:00
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
Please refer to the default `.tmux.conf.local` file to know more about variables
you can adjust to alter different behaviors. Pressing `<prefix> e` will open
2015-10-22 15:37:44 -04:00
`~/.tmux.conf.local` with the editor defined by the `$EDITOR` environment
variable (defaults to `vim` when empty).
2015-09-15 17:42:17 -04:00
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
### Enabling the Powerline look
2015-09-15 17:42:17 -04:00
2016-07-25 16:01:42 -04:00
Powerline originated as a status-line plugin for Vim. Its popular eye-catching
2015-10-17 16:35:07 -04:00
look is based on the use of special symbols: < img width = "80" alt = "Powerline Symbols" style = "vertical-align: middle;" src = "https://cloud.githubusercontent.com/assets/553208/10687156/1b76dda6-796b-11e5-83a1-1634337c4571.png" / >
To make use of these symbols, there are several options:
- use a font that already bundles those: this is e.g. the case of the
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
[2.030R-ro/1.050R-it version][source code pro] of the Source Code Pro] font
2015-10-17 16:35:07 -04:00
- use a [pre-patched font][powerline patched fonts]
- use your preferred font along with the [Powerline font][powerline font] (that
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
only contains the Powerline symbols): [this highly depends on your operating
system and your terminal emulator][terminal support]
2015-10-17 16:35:07 -04:00
- [patch your preferred font][powerline font patcher] by adding the missing
Powerline symbols: this is the most difficult way and is no more documented in
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
the [Powerline manual]
2015-10-17 16:35:07 -04:00
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
[source code pro]: https://github.com/adobe-fonts/source-code-pro/releases/tag/2.030R-ro/1.050R-it
2015-10-17 16:35:07 -04:00
[powerline patched fonts]: https://github.com/powerline/fonts
[powerline font]: https://github.com/powerline/powerline/raw/develop/font/PowerlineSymbols.otf
[powerline font patcher]: https://github.com/powerline/fontpatcher
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
[terminal support]: http://powerline.readthedocs.io/en/master/usage.html#usage-terminal-emulators
[Powerline manual]: http://powerline.readthedocs.org/en/latest/installation.html#fonts-installation
Please see the [Powerline manual] for further details.
Then edit the `~/.tmux.conf.local` file (`< prefix > e`) and adjust the following
variables:
```
tmux_conf_theme_left_separator_main=''
tmux_conf_theme_left_separator_sub=''
tmux_conf_theme_right_separator_main=''
tmux_conf_theme_right_separator_sub=''
```
### Configuring the status line
Contrary to the first iterations of this configuration, by now you have total
control on the content and order of `status-left` and `status-right` .
Edit the `~/.tmux.conf.local` file (`< prefix > e`) and adjust the
`tmux_conf_theme_status_left` and `tmux_conf_theme_status_right` variables to
your own preferences.
This configuration supports the following builtin variables:
- `#{battery_bar}` : horizontal battery charge bar
- `#{battery_percentage}` : battery percentage
- `#{battery_status}` : is battery charging or discharging?
- `#{battery_vbar}` : vertical battery charge bar
- `#{circled_session_name}` : circled session number, up to 20
- `#{hostname}` : SSH aware hostname information
- `#{hostname_ssh}` : SSH aware hostname information, blank when no SSH
connection detected
2016-11-03 17:26:31 -04:00
- `#{loadavg}` : load average
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
- `#{pairing}` : is session attached to more than one client?
- `#{prefix}` : is prefix being depressed?
- `#{root}` : is current user root?
- `#{uptime_d}` : uptime days
- `#{uptime_h}` : uptime hours
- `#{uptime_m}` : uptime minutes
- `#{uptime_s}` : uptime seconds
- `#{username}` : SSH aware username information
- `#{username_ssh}` : SSH aware username information, blank when no SSH
connection detected
2014-12-13 07:09:21 -05:00
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`
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
utility][reattach-to-user-namespace] that makes `pbcopy` and `pbpaste` work
again within tmux.
2013-07-15 05:04:39 -04:00
2015-09-15 17:42:17 -04:00
To install `reattach-to-user-namespace` , use either [MacPorts][] or
[Homebrew][]:
$ port install tmux-pasteboard
or
2013-07-15 05:04:39 -04:00
2014-03-10 03:09:16 -04:00
$ brew install reattach-to-user-namespace
2015-09-15 17:42:17 -04:00
Once installed, `reattach-to-usernamespace` will be automatically detected.
[MacPorts]: http://www.macports.org/
[Homebrew]: http://brew.sh/
2015-10-28 13:45:32 -04:00
### Using the configuration under Cygwin within Mintty
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
![cygwin ](https://cloud.githubusercontent.com/assets/553208/19741789/67a3f3d8-9bc2-11e6-9ecc-499fc0228ee6.png )
2015-10-28 13:45:32 -04:00
It is possible to use this configuration under Cygwin within Mintty, however
support for Unicode symbols and emojis lacks behind Mac and Linux.
Particularly, Mintty's text rendering is implemented with GDI which has
2015-12-05 09:36:28 -05:00
limitations:
2015-10-28 13:45:32 -04:00
- color emojis are only available through DirectWrite starting with Windows 8.1
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
- display of double width symbols, like the battery discharging symbol indicator
2015-10-28 13:45:32 -04:00
(U+1F50B) is buggy
2015-12-05 09:36:28 -05:00
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
To get Unicode symbols displayed properly, you have to use [font linking].
Open `regedit.exe` then navigate to the registry key at
2016-07-25 16:01:42 -04:00
`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\FontLink\SystemLink`
2015-10-28 13:45:32 -04:00
and add a new entry for you preferred font to link it with the Segoe UI Symbol
font.
major rewrite, closes #10, #23, #30 and #31
- status-justify aware status line
- flexible status line definition with many new variables/indicators:
- #{battery_bar}, #{battery_vbar}, #{battery_percentage}
- #{uptime_d}, #{uptime_h}, #{uptime_m}, #{uptime_s}
- #{pairing}, #{prefix}, #{root}
- #{username}, #{username_ssh}, #{hostname}, #{hostname_ssh}
- ...
- smart username and hostname variables:
- detects root user
- detects SSH sessions to remote servers
- support for circled session names (when number) and window identifiers up to 20:
- #{circled_session_name}, #{circled_window_index}
- support for connecting to the same host when splitting a pane running an SSH session
- support for 24b colours
- support for OpenBSD (tested with OpenBSD 6.0)
- cleaned everything with shellcheck
2016-09-03 13:49:55 -04:00
![regedit ](https://cloud.githubusercontent.com/assets/553208/19741304/71a2f3ae-9bc0-11e6-96aa-4c09a812c313.png )
2015-10-28 13:45:32 -04:00
[font linking]: https://msdn.microsoft.com/en-us/goglobal/bb688134.aspx