darkcloud-tmuxconfig/README.md

5 KiB

Darkcloud TMUX Config

Features

  • A custom theme that matches the one used in darkcloud-vimconfig.
  • A bandwidth monitor showing the current upload and download speed of either eth0 or the device you've set to $NETDEV.
  • Sane defaults and a set of custom key bindings that group similar ideas and make frequently used commands easier to access.
  • Optional support for powerline fonts that looks oh so much better when they're used :).

Darkcloud TMUX Config Theme

Installation

  1. Choose either tmux.powerline.conf if powerline fonts are available or tmux.normal.conf if they're not, and install it to /etc/tmux.conf for a system-wide install or ~/.tmux.conf for a local install.
  2. Install bwrate to somewhere available in $PATH and make it executable (ie: install -Dm755 bwrate /usr/local/bin/bwrate)
  3. If your network device isn't named eth0, set $NETDEV to the name of the device you'd like to use somewhere tmux will see it when it runs (ie: echo 'export $NETDEV="wlan0"' >> ~/.bashrc)

Key Bindings

  • Prefix: <Ctrl><Space>
Key(s) Behaviour
<Backslash> and <Ctrl><Backslash> Toggle the status bar on and off respectively
c and <Ctrl>c Create a new pane and create a new pane in the current directory respectively
[ and ] Split the window vertically and horizontally respectively
{ and } Join a window as a split pane top/bottom and left/right respectively (leave pane: !)
- and = Select an even layout vertically and horizontally respectively
_ and + Rotate the window counter-clockwise and clockwise respectively
< and > Move the current window to the first and last window respectively
. and , Move and swap the current window with the provided window number respectively
$ and # Rename the current session and window with the provided name respectively
<Space> and <Ctrl><Space> Move to the previously selected pane and window respectively
h, j, k and l Move left, down, up and right between panes respectively like the arrow keys
` Toggle synchronized input between the panes on the current window
<Ctrl>r Clear the terminal history, tmux history and the current window/pane
r and R Reload /etc/tmux.conf and ~/.tmux.conf respectively
m and <Ctrl>m Enable and disable the mouse respectively
? and / Show help for available key bindings and commands respectively
y and <Ctrl>p Enter copy mode and paste from the copy buffer respectively
<Ctrl>v and <Ctrl>y Pastes the X buffer in tmux, and sends the tmux buffer to X respectively
(copy mode) v, y and <Escape> Begin selection, copy selection and cancel copy mode respectively
W Write scrollback buffer to file
Alt-[0-9] (no prefix) Switch directly to the given window

Italics Support

Tmux supports italics if your terminal does, but the terminfo files screen and screen-256color don't advertise this, and most programs will display reversed text when it should be italics. To fix this, run: tmux-italics-terminfo, then follow the instructions it displays by changing set-option -g default-terminal "screen-256color" to set-option -g default-terminal "screen-256color-it" in your tmux.conf. You'll want to make sure your /etc/bash.bashrc, /etc/dircolors, possibly vim and any other terminal applications that check the $TERM variable have screen-it and screen-256color-it added.

Credits

License

This config and the bwrate script are released under the MIT license.