2014-04-09 14:30:31 -04:00
# Darkcloud TMUX Config
2014-04-09 14:29:23 -04:00
2015-10-20 11:47:48 -04:00
## Features
2014-04-09 14:30:31 -04:00
* A custom theme that matches the one used in [darkcloud-vimconfig ](https://github.com/prurigro/darkcloud-vimconfig ).
2014-04-09 15:43:09 -04:00
* A bandwidth monitor showing the current upload and download speed of either **eth0** or the device you've set to ** $NETDEV**.
2014-04-09 14:30:31 -04:00
* 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 :).
2019-03-08 01:40:13 -05:00
![Darkcloud TMUX Config Theme ](https://i.imgur.com/Ps3XmMc.png )
2014-04-09 15:41:50 -04:00
2015-10-20 11:47:48 -04:00
## Installation
2014-04-09 14:30:31 -04:00
2024-03-08 21:40:02 -05:00
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.
1. Install **bwrate** to somewhere available in `$PATH` and make it executable (ie: `install -Dm755 bwrate /usr/local/bin/bwrate` )
1. 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` )
2014-04-09 14:30:31 -04:00
2015-10-20 11:47:48 -04:00
## Key Bindings
2014-04-09 14:30:31 -04:00
2014-10-28 10:34:03 -04:00
* **Prefix**: `<Ctrl><Space>`
2024-03-08 21:40:02 -05:00
### With Prefix
| Key(s) | Behaviour |
|-----------------------------------------|--------------------------------------------------------------------|
| `c` and `<Ctrl>c` | Create a new pane and create a new pane in the current directory |
2024-04-10 15:16:44 -04:00
| `[` and `]` | Create a new pane to the right and below the current one |
2024-03-08 21:40:02 -05:00
| `-` and `=` | Select an even layout vertically and horizontally |
| `_` and `+` | Rotate the panes clockwise and counter-clockwise |
| `S` | Swap the current pane with the marked one (`M` to mark) |
| `,` | Swap the current window with another (using its index) |
| `#` | Rename the current window |
| `<Space>` and `<Ctrl><Space>` | Move to the previously selected pane and window |
| `` ` ` ` | Toggle synchronized input between the panes on the current window |
2024-04-05 16:01:09 -04:00
| `r` and `R` | Reload /etc/tmux.conf and ~/.tmux.conf |
| `F1` and `F2` | Show help for available commands and keyboard bindings |
2024-03-08 21:40:02 -05:00
| `W` | Write scrollback buffer to file |
| `V` | Enter **copy mode** |
| `<Ctrl>p` | Paste from the copy buffer |
2024-04-05 16:01:09 -04:00
| `P` and `N` | Move to the previous and next session |
2024-03-08 21:40:02 -05:00
### Without Prefix
| Key(s) | Behaviour |
|-----------------------------------------|--------------------------------------------------------------------|
| `<Alt><Shift><Up,Down,Left,Right>` | Navigate to the pane in the respective direction |
| `<Alt>N` and `<Alt>P` | Switch to the next and previous window |
2024-03-09 16:06:38 -05:00
| `<Ctrl><Alt>N` and `<Ctrl><Alt>P` | Swap the current window with the next and previous window |
2024-03-08 21:40:02 -05:00
| `Alt-[0-9]` | Switch to the window with the respective index |
2024-04-05 16:01:09 -04:00
| `Alt-?` | Start searching up |
2024-03-08 21:40:02 -05:00
### Copy Mode
| Key(s) | Behaviour |
|-----------------------------------------|--------------------------------------------------------------------|
| `v` | Start visually selecting text |
| `y` | Copy the selected text |
| `<Escape>` | Exit **copy mode**
2014-04-09 14:30:31 -04:00
2015-10-20 11:47:48 -04:00
## Credits
2014-04-09 14:30:31 -04:00
2014-07-16 22:25:51 -04:00
* Written by Kevin MacMartin: [GitHub Projects ](https://github.com/prurigro ) | [Arch Linux AUR Packages ](https://aur.archlinux.org/packages/?SeB=m&K=prurigro )
2014-04-09 14:30:31 -04:00
2015-10-20 11:47:48 -04:00
## License
2014-12-22 22:19:46 -05:00
2014-04-09 14:30:31 -04:00
This config and the bwrate script are released under the MIT license.