darkcloud-tmuxconfig/README.md

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 :).

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

• Written by Kevin MacMartin: GitHub Projects | Arch Linux AUR Packages

License

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