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
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:
2024-01-21 15:09:12 -05:00
- tmux ** `>= 2.6` ** running inside Linux, Mac, OpenBSD, Cygwin or WSL
2019-11-30 09:49:06 -05:00
- awk, perl and sed
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
- outside of tmux, `$TERM` must be set to `xterm-256color`
2023-03-05 11:26:21 -05:00
⚠️ Before installing, you may want to backup your existing configuration.
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
2023-03-05 11:26:21 -05:00
You can install Oh my tmux! at any of the following locations:
- `~`
- `$XDG_CONFIG_HOME/tmux`
- `~/.config/tmux`
Installing 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
```
$ 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 .
```
2023-03-05 11:26:21 -05:00
Installing in `$XDG_CONFIG_HOME/tmux` :
2020-09-06 14:32:13 -04:00
```
2023-03-05 11:26:21 -05:00
$ git clone https://github.com/gpakosz/.tmux.git "/path/to/oh-my-tmux"
$ mkdir -p "$XDG_CONFIG_HOME/tmux"
$ ln -s "/path/to/oh-my-tmux/.tmux.conf" "$XDG_CONFIG_HOME/tmux/tmux.conf"
$ cp "/path/to/oh-my-tmux/.tmux.conf.local" "$XDG_CONFIG_HOME/tmux/tmux.conf.local"
2020-09-06 14:32:13 -04:00
```
2023-03-05 11:26:21 -05:00
Installing in `~/.config/tmux` :
```
$ git clone https://github.com/gpakosz/.tmux.git "/path/to/oh-my-tmux"
$ mkdir -p "~/.config/tmux"
$ ln -s "/path/to/oh-my-tmux/.tmux.conf" "~/.config/tmux/tmux.conf"
$ cp "/path/to/oh-my-tmux/.tmux.conf.local" "~/.config/tmux/tmux.conf.local"
```
⚠️ When installing `$XDG_CONFIG_HOME/tmux` or `~/.config/tmux` , the configuration
file names don't have a leading `.` character.
2017-03-14 09:33:03 -04:00
2023-03-05 11:26:21 -05:00
❗️ You should never alter the main `.tmux.conf` or `tmux.conf` file. If you do,
you're on your own. Instead, every customization should happen in your
`.tmux.conf.local` or `tmux.conf.local` customization file copy.
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
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
2023-03-05 11:26:21 -05:00
If you're new to tmux, I recommend you to read [tmux 2: Productive Mouse-Free
2017-07-09 04:48:26 -04:00
Development][bhtmux2] by [@bphogan].
2023-03-05 11:26:21 -05:00
Now proceed to [adjust] your `.local` customization file copy.
[bhtmux2]: https://pragprog.com/titles/bhtmux2/tmux-2
2017-07-09 04:48:26 -04:00
[@bphogan]: https://twitter.com/bphogan
2023-03-05 11:26:21 -05:00
[adjust]: #configuration
2017-07-09 04:48:26 -04:00
2017-03-14 09:33:03 -04:00
Troubleshooting
---------------
2017-04-08 16:32:00 -04:00
- **I'm running tmux `HEAD` and things don't work properly. What should I do?**
2017-03-14 09:33:03 -04:00
Please open an issue describing what doesn't work with upcoming tmux. I'll do
my best to address it.
- **Status line is broken and/or gets duplicated at the bottom of the screen.
What gives?**
This particularly happens on Linux when the distribution provides a version
of glib that received Unicode 9.0 upgrades (glib `>= 2.50.1` ) while providing
2017-04-09 18:02:54 -04:00
a version of glibc that didn't (glibc `< 2.26` ). You may also configure
`LC_CTYPE` to use an `UTF-8` locale. Typically VTE based terminal emulators
rely on glib's `g_unichar_iswide()` function while tmux relies on glibc's
`wcwidth()` function. When these two functions disagree, display gets messed
up.
2017-03-14 09:33:03 -04:00
2017-06-12 06:22:26 -04:00
This can also happen on macOS when using iTerm2 and "Use Unicode version 9
2017-03-14 09:33:03 -04:00
character widths" is enabled in `Preferences... > Profiles > Text`
2023-03-05 11:26:21 -05:00
For that reason, the default sample `.local` customization file stopped using
Unicode characters for which width changed in between Unicode 8.0 and 9.0
standards, as well as Emojis.
2017-03-14 09:33:03 -04:00
- **I installed Powerline and/or (patched) fonts but can't see Powerline
symbols.**
First, you don't need to install Powerline. You only need fonts patched with
Powerline symbols or the standalone `PowerlineSymbols.otf` font. Then make
2023-03-05 11:26:21 -05:00
sure your `.local` customization file copy uses the Powerline code points for
2017-03-14 09:33:03 -04:00
`tmux_conf_theme_left_separator_XXX` values.
2023-03-05 11:26:21 -05:00
- **I'm using Bash On Windows (WSL), colors and the Powerline look are broken.**
2017-04-09 18:02:54 -04:00
There is currently a [bug][1681] in the new console powering Bash On Windows
preventing text attributes (bold, underscore, ...) to combine properly with
2023-03-05 11:26:21 -05:00
colors. The workaround is to search your `.local` customization file copy and
2017-06-18 07:42:37 -04:00
replace attributes with `'none'` .
Also, until Window's console replaces its GDI based render with a DirectWrite
one, Powerline symbols will be broken.
The alternative is to use the [Mintty terminal for WSL][wsltty].
2017-04-09 18:02:54 -04:00
[1681]: https://github.com/Microsoft/BashOnWindows/issues/1681
[wsltty]: https://github.com/mintty/wsltty
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]
2019-01-05 11:32:54 -05:00
- SSH/Mosh 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
- laptop battery status line information
- uptime status line information
2020-10-10 12:56:13 -04:00
- optional highlight of focused pane
2014-12-13 07:09:21 -05:00
- configurable new windows and panes behavior (optionally retain current path)
2019-01-05 11:32:54 -05:00
- SSH/Mosh aware split pane (reconnects to remote server)
2024-01-21 15:09:12 -05:00
- copy to OS clipboard (needs `xsel` , `xclip` , or `wl-copy` on Linux)
2020-10-10 12:56:13 -04:00
- support for 4-digit hexadecimal Unicode characters
2015-10-11 11:52:39 -04:00
- [Facebook PathPicker][] integration if available
2023-12-18 17:22:35 -05:00
- [Urlscan][] (preferred) or [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/
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
2023-12-18 17:22:35 -05:00
[Urlscan]: https://github.com/firecat53/urlscan
2015-10-17 16:35:07 -04:00
2017-12-17 05:10:40 -05:00
The "maximize any pane to a new window with `<prefix> +` " feature is different
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.
Mouse mode allows you to set the active window, set the active pane, resize
panes and automatically switches to copy-mode to select text.
Bindings
--------
2017-03-13 16:19:14 -04:00
tmux may be controlled from an attached client by using a key combination of a
prefix key, followed by a command key. This configuration uses `C-a` as a
secondary prefix while keeping `C-b` as the default prefix. In the following
list of key bindings:
- `<prefix>` means you have to either hit < kbd > Ctrl</ kbd > + < kbd > a</ kbd > or < kbd > Ctrl</ kbd > + < kbd > b</ kbd >
- `<prefix> c` means you have to hit < kbd > Ctrl</ kbd > + < kbd > a</ kbd > or < kbd > Ctrl</ kbd > + < kbd > b</ kbd > followed by < kbd > c</ kbd >
- `<prefix> C-c` means you have to hit < kbd > Ctrl</ kbd > + < kbd > a</ kbd > or < kbd > Ctrl</ kbd > + < kbd > b</ kbd > followed by < kbd > Ctrl</ kbd > + < kbd > c</ kbd >
2015-10-17 16:35:07 -04:00
This configuration uses the following bindings:
2023-03-05 11:26:21 -05:00
- `<prefix> e` opens the `.local` customization file copy with the editor
defined by the `$EDITOR` environment variable (defaults to `vim` when empty)
2015-10-17 16:35:07 -04:00
- `<prefix> r` reloads the configuration
2017-12-17 05:10:40 -05:00
- `C-l` clears both the screen and the tmux history
- `<prefix> C-c` creates a new session
2015-10-17 16:35:07 -04:00
- `<prefix> C-f` lets you switch to another session by name
2017-12-17 05:10:40 -05:00
2015-10-17 16:35:07 -04:00
- `<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
2017-12-17 05:10:40 -05:00
- `<prefix> -` splits the current pane vertically
- `<prefix> _` splits the current pane horizontally
2015-10-17 16:35:07 -04:00
- `<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
2017-12-17 05:10:40 -05:00
2015-10-17 16:35:07 -04:00
- `<prefix> m` toggles mouse mode on or off
2017-12-17 05:10:40 -05:00
2023-12-18 17:22:35 -05:00
- `<prefix> U` launches Urlscan (preferred) or Urlview, if available
- `<prefix> F` launches Facebook PathPicker, if available
2017-12-17 05:10:40 -05:00
2015-10-17 16:35:07 -04:00
- `<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
2017-11-29 15:41:39 -05:00
Additionally, `copy-mode-vi` matches [my own Vim configuration][]
2015-10-17 16:35:07 -04:00
[my own Vim configuration]: https://github.com/gpakosz/.vim.git
2017-11-29 15:41:39 -05:00
Bindings for `copy-mode-vi` :
2015-10-17 16:35:07 -04:00
- `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
2015-09-15 17:42:17 -04:00
Configuration
-------------
While this configuration tries to bring sane default settings, you may want to
2023-03-05 11:26:21 -05:00
customize it further to your needs.
❗️ Again, you should never alter the main `.tmux.conf` or `tmux.conf` file.
If you do, you're on your own.
2015-09-15 17:42:17 -04:00
2023-03-05 11:26:21 -05:00
Please refer to the sample `.local` customization file to know more about the
variables that allow you to alter different behaviors. Upon successful
installation, pressing `<prefix> e` will open your `.local` customization file
copy 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
2018-02-04 15:44:59 -05: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
2019-07-31 15:53:18 -04:00
system and your terminal emulator][terminal support], for instance here's a
screenshot of iTerm2 configured to use `PowerlineSymbols.otf`
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
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
2023-03-05 11:26:21 -05:00
Then edit your `.local` customization file copy (with `<prefix> e` ) and adjust
the following variables:
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
```
2019-06-09 08:46:16 -04:00
tmux_conf_theme_left_separator_main='\uE0B0'
tmux_conf_theme_left_separator_sub='\uE0B1'
tmux_conf_theme_right_separator_main='\uE0B2'
tmux_conf_theme_right_separator_sub='\uE0B3'
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
```
2023-03-05 11:26:21 -05:00
The [Powerline manual] contains further details on how to install fonts
containing the Powerline symbols. You don't need to install Powerline itself
though.
[Powerline manual]: http://powerline.readthedocs.org/en/latest/installation.html#fonts-installation
### Configuring the status line
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
2023-03-05 11:26:21 -05:00
Edit your `.local` customization file copy (`< prefix > e`) and adjust 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
`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
2024-01-12 04:21:38 -05:00
- `#{battery_hbar}` : 1 character wide, horizontal battery charge bar
- `#{battery_vbar}` : 1 character wide, vertical battery charge bar
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
- `#{battery_percentage}` : battery percentage
- `#{battery_status}` : is battery charging or discharging?
- `#{circled_session_name}` : circled session number, up to 20
2019-01-05 11:32:54 -05:00
- `#{hostname}` : SSH/Mosh aware hostname information
- `#{hostname_ssh}` : SSH/Mosh aware hostname information, blank when not
connected to a remote server through SSH/Mosh
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?
2018-07-20 12:01:35 -04:00
- `#{synchronized}` : are the panes synchronized?
2019-06-22 15:45:36 -04:00
- `#{uptime_y}` : uptime years
- `#{uptime_d}` : uptime days, modulo 365 when `#{uptime_y}` is used
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
- `#{uptime_h}` : uptime hours
- `#{uptime_m}` : uptime minutes
- `#{uptime_s}` : uptime seconds
2019-01-05 11:32:54 -05:00
- `#{username}` : SSH/Mosh aware username information
- `#{username_ssh}` : SSH aware username information, blank when not connected
to a remote server through SSH/Mosh
2014-12-13 07:09:21 -05:00
2023-03-05 11:26:21 -05:00
Beside the variables mentioned above, the `tmux_conf_theme_status_left` and
2019-02-03 05:18:45 -05:00
`tmux_conf_theme_status_right` variables support usual tmux syntax, e.g. using
`#()` to call an external command that inserts weather information provided by
[wttr.in]:
```
2020-09-07 09:57:58 -04:00
tmux_conf_theme_status_right='#{prefix}#{pairing}#{synchronized} #(curl -m 1 wttr.in?format=3 2>/dev/null; sleep 900) , %R , %d %b | #{username}#{root} | #{hostname} '
2019-02-03 05:18:45 -05:00
```
2020-09-07 09:57:58 -04:00
The `sleep 900` call makes sure the network request is issued at most every 15
minutes whatever the value of `status-interval` .
2019-02-03 05:18:45 -05:00
[wttr.in]: https://github.com/chubin/wttr.in#one-line-output
2023-03-05 11:26:21 -05:00
💡 You can also define your own custom variables by writing special functions,
see the sample `.local` customization file for instructions.
2020-09-06 16:30:13 -04:00
2020-09-07 17:23:04 -04:00
Finally, remember `tmux_conf_theme_status_left` and
`tmux_conf_theme_status_right` end up being given to tmux as `status-left` and
`status-right` which means they're passed through `strftime()` . As such, the `%`
character has a special meaning and needs to be escaped by doubling it, e.g.
```
tmux_conf_theme_status_right='#(echo foo %% bar)'
```
2023-03-05 11:26:21 -05:00
See also `man 3 strftime` .
2020-09-07 17:23:04 -04:00
2020-10-10 12:56:13 -04:00
### Using TPM plugins
This configuration now comes with built-in [TPM] support:
- use the `set -g @plugin ...` syntax to enable a plugin
- whenever a plugin introduces a variable to be used in `status-left` or
`status-right` , you can use it in `tmux_conf_theme_status_left` and
`tmux_conf_theme_status_right` variables, see instructions above 👆
2023-03-05 11:26:21 -05:00
- ⚠️ do not add `set -g @plugin 'tmux-plugins/tpm'` to any configuration file
- ⛔️ do not add `run '~/.tmux/plugins/tpm/tpm'` to any configuration file
2020-10-10 12:56:13 -04:00
2021-09-04 12:00:02 -04:00
⚠️ The TPM bindings differ slightly from upstream:
- installing plugins: `<prefix> + I`
- uninstalling plugins: `<prefix> + Alt + u`
- updating plugins: `<prefix> + u`
2023-03-05 11:26:21 -05:00
See the sample `.local` customization file for instructions.
2020-10-10 12:56:13 -04:00
[TPM]: https://github.com/tmux-plugins/tpm
2015-10-28 13:45:32 -04:00
### Using the configuration under Cygwin within Mintty
2017-06-04 11:38:58 -04:00
**I don't recommend running this configuration with Cygwin anymore. Forking
under Cygwin is extremely slow and this configuration issues a lot of
`run-shell` commands under the hood. As such, you will experience high CPU
usage. As an alternative consider using [Mintty terminal for WSL][wsltty].**
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
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
2015-10-28 13:45:32 -04:00
[font linking]: https://msdn.microsoft.com/en-us/goglobal/bb688134.aspx
