summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorkaernyk <kaernyk@users.noreply.github.com>2014-09-05 23:11:58 -0400
committerkaernyk <kaernyk@users.noreply.github.com>2014-09-05 23:11:58 -0400
commit29581e5c1307e43f752e08b6fdd66cde54448424 (patch)
treead80ab7d9040ee3d382c47fce418c0ea72ab538b
parente97b3d6a0ff0715b18ac1f0195a064759002975d (diff)
Update tmux.html.markdown
Corrected page structure/style to conform to other tutorials ``` Line 18: Removed "tmux" as it has other purposes as well as quickly starting a blank session that will not be covered Line 45: Added Meta/Alt explanation Line 126: Moved 'bind-key C-a send-prefix" to the group that requires it Line 184: Added comment Line 186: Added comment pointing to resource required (if enabled) - Removed 'set-option -g status-justify centre' ```
-rw-r--r--tmux.html.markdown200
1 files changed, 97 insertions, 103 deletions
diff --git a/tmux.html.markdown b/tmux.html.markdown
index 53606bbe..7127d3b9 100644
--- a/tmux.html.markdown
+++ b/tmux.html.markdown
@@ -12,10 +12,11 @@ tmux</a> is a terminal multiplexer: it enables a number of terminals to be
created, accessed, and controlled from a single screen. tmux may be detached
from a screen and continue running in the background, then later reattached.
+
```bash
# We’ll start off with managing tmux from a terminal:
- tmux | tmux new # Create an unamed session
+ tmux new # Create a new session
-s "Session" # Create named session
-n "Window" # Create named Window
-c "/dir" # Start in target directory
@@ -40,9 +41,10 @@ from a screen and continue running in the background, then later reattached.
# the man pages).
(C-b) == Ctrl + b
-
-# This combination is the default prefix key that is to be used in conjunction
-# with a keybind to produce the stated effect.
+
+ (M-1) == Alt + b
+ -or-
+ Meta + b
# The default keybinds are as follows:
@@ -92,7 +94,6 @@ from a screen and continue running in the background, then later reattached.
M-Up, M-Down # Resize the current pane in steps of five cells.
M-Left, M-Right
-```
### Configuring ~/.tmux.conf
@@ -100,104 +101,97 @@ from a screen and continue running in the background, then later reattached.
tmux.conf can be used to set options automatically on start up, much
like how .vimrc or init.el are used.
-```bash
-# Example tmux.conf
-# 2014.9
-
-### Keybinds
-###########################################################################
-
-## Prefix Adjustment
-
-# Unbind C-b as the default prefix
-unbind-key C-b
-
-# Set ` as the default prefix
-set-option -g prefix `
-#set option -g prefix C-a
-
-# Return to previous window when prefix is pressed twice
-bind-key C-a last-window
-bind-key ` last-window
-bind-key a send-prefix
-
-# Allow swapping C-a and ` using F11/F12
-bind-key F11 set-option -g prefix C-a
-bind-key F12 set-option -g prefix `
-
-## Index Start
-set -g base-index 1
-
-## Window Cycle/Swap
-bind e previous-window
-bind f next-window
-bind E swap-window -t -1
-bind F swap-window -t +1
-
-
-### Theme
-###########################################################################
-
-## Statusbar Color Palatte
-#set-option -g status-justify centre
-set-option -g status-justify left
-set-option -g status-bg black
-set-option -g status-fg white
-set-option -g status-left-length 40
-set-option -g status-right-length 80
-
-## Pane Border Color Palette
-set-option -g pane-active-border-fg green
-set-option -g pane-active-border-bg black
-set-option -g pane-border-fg white
-set-option -g pane-border-bg black
-
-## Message Color Palette
-set-option -g message-fg black
-set-option -g message-bg green
-
-#setw -g mode-bg black
-
-## Window Status Color Palette
-setw -g window-status-bg black
-setw -g window-status-current-fg green
-setw -g window-status-bell-attr default
-setw -g window-status-bell-fg red
-setw -g window-status-content-attr default
-setw -g window-status-content-fg yellow
-setw -g window-status-activity-attr default
-setw -g window-status-activity-fg yellow
-
-
-### UI
-###########################################################################
-
-## Window Interface Adjustments
-set-option -g status-utf8 on
-setw -g mode-keys vi
-setw -g mode-mouse on
-setw -g monitor-activity on
-
-set-option -g mouse-select-pane on
-set-option -g status-keys vi
-set-option -g bell-action any
-set-option -g set-titles on
-set-option -g set-titles-string '#H:#S.#I.#P #W #T' # window number,program name,active (or not)
-set-option -g visual-bell off
-
-## Statusbar Adjustments
-set -g status-left ' #[fg=red]#H#[fg=green]:#[fg=white]#S #[fg=green]][#[default] '
-set -g status-interval 5
-#set -g status-right ' #[fg=green]][#[fg=white] #T #[fg=green]][ #[fg=blue]%Y-%m-%d #[fg=white]%H:%M#[default] '
-
-## Show performance counters in statusbar
-#set -g status-right ' #[fg=green]][#[fg=white] #(tmux-mem-cpu-load 5 4) #[fg=green]][ #[fg=yellow]%H:%M#[default] '
-
-
-### Misc
-###########################################################################
-set -g history-limit 4096
-bind r source-file ~/.tmux.conf
+```
+ # Example tmux.conf
+ # 2014.9
+
+ ## Prefix Adjustment
+
+ # Unbind C-b as the default prefix
+ unbind-key C-b
+
+ # Set ` as the default prefix
+ set-option -g prefix `
+
+ # Set C-a as the default prefix
+ #set option -g prefix C-a
+
+ # Return to previous window when prefix is pressed twice
+ bind-key C-a last-window
+ bind-key ` last-window
+
+ # Allow swapping C-a and ` using F11/F12
+ bind-key F11 set-option -g prefix C-a
+ bind-key F12 set-option -g prefix `
+ bind-key C-a send-prefix
+
+ ## Index Start
+ set -g base-index 1
+
+ ## Window Cycle/Swap
+ bind e previous-window
+ bind f next-window
+ bind E swap-window -t -1
+ bind F swap-window -t +1
+
+ ## Statusbar Color Palatte
+ set-option -g status-justify left
+ set-option -g status-bg black
+ set-option -g status-fg white
+ set-option -g status-left-length 40
+ set-option -g status-right-length 80
+
+ ## Pane Border Color Palette
+ set-option -g pane-active-border-fg green
+ set-option -g pane-active-border-bg black
+ set-option -g pane-border-fg white
+ set-option -g pane-border-bg black
+
+ ## Message Color Palette
+ set-option -g message-fg black
+ set-option -g message-bg green
+
+ #setw -g mode-bg black
+
+ ## Window Status Color Palette
+ setw -g window-status-bg black
+ setw -g window-status-current-fg green
+ setw -g window-status-bell-attr default
+ setw -g window-status-bell-fg red
+ setw -g window-status-content-attr default
+ setw -g window-status-content-fg yellow
+ setw -g window-status-activity-attr default
+ setw -g window-status-activity-fg yellow
+
+ ## Window Interface Adjustments
+ set-option -g status-utf8 on
+ setw -g mode-keys vi
+ setw -g mode-mouse on
+ setw -g monitor-activity on
+
+ set-option -g mouse-select-pane on
+ set-option -g status-keys vi
+ set-option -g bell-action any
+ set-option -g set-titles on
+ set-option -g set-titles-string '#H:#S.#I.#P #W #T' # window number,program name,active (or not)
+ set-option -g visual-bell off
+
+ ## Statusbar Adjustments
+ set -g status-left ' #[fg=red]#H#[fg=green]:#[fg=white]#S #[fg=green]][#[default] '
+ set -g status-interval 5
+
+ # Statusbar with right-aligned Date / Time
+ set -g status-right ' #[fg=green]][#[fg=white] #T #[fg=green]][ #[fg=blue]%Y-%m-%d #[fg=white]%H:%M#[default] '
+
+ ## Show performance counters in statusbar
+ # Requires https://github.com/thewtex/tmux-mem-cpu-load/
+ #set -g status-right ' #[fg=green]][#[fg=white] #(tmux-mem-cpu-load 5 4) #[fg=green]][ #[fg=yellow]%H:%M#[default] '
+
+ ## Scrollback/History limit
+ set -g history-limit 4096
+
+ bind r source-file ~/.tmux.conf
+```
```
### External Resources