diff --git a/README.md b/README.md new file mode 100644 index 0000000..161a76d --- /dev/null +++ b/README.md @@ -0,0 +1,198 @@ +Updates: +===================== +1. Fixed bugs which caused errors while running tmux post installation. +2. Updated tmux-powerline to reflect tun0 IP when connected using VPN. +3. Cleaned up tmux-powerline; removed status-date and sysstat_loadavg. + +Installation +===================== +To install tmux-config: +``` bash +$ git clone https://github.com/iamkashz/tmux-config.git +$ ./tmux-config/install.sh + +# can jump into tmux session using +$ tmux new +``` + +Setup tmux with terminator +===================== +Note: xclip is needed to fix the mouse copy-paste issue. +```bash +$ sudo apt install terminator xclip +``` +1. Right click on `Terminal Emulator` > `Edit Applicaiton`. +2. Set `Command` as `terminator`. +3. Launch `Terminal Emulator`, `terminator` should launch directly. + +### Auto launch tmux at terminal spawn +1. Launch terminator (or Terminal Emulator if it auto launches terminator). +2. Right click > `Prferences` > `Profiles` tab +3. Under `default` profile, select sub-tab `Command` +4. Set `Custom command` as `tmux`. + +Custom Status line +----------- +Left part: +![left](https://user-images.githubusercontent.com/19916930/129307411-9012b0b4-72b5-4a8b-a241-9f254978e4ef.PNG) + +Right part: +![right](https://user-images.githubusercontent.com/19916930/129307427-ac231f57-4c30-40e1-a9fe-b31936109168.PNG) + +The left part contains only current session name. The right part contains CPU & Memory Usage, username@hostname, tun0 IP (if connected to VPN) and battery indicator. + +Hide/show status bar using ` C-s` keybinding. + +tmux cheatsheet for beginners +----------- +[TMUX CHEATSHEET](https://tmuxcheatsheet.com/) + +So `~/.tmux.conf` overrides default key bindings for many action, to make them more reasonable, easy to recall and comfortable to type. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
tmux keyDescription
C-aDefault prefix, used instead of "C-b". Same prefix is used in screen program, and it's easy to type. The only drawback of "C-a" is that underlying shell does not receive the keystroke to move to the beginning of the line. +
<prefix> C-eOpen ~/.tmux.conf file in your $EDITOR
<prefix> C-rReload tmux configuration from ~/.tmux.conf file
<prefix> rRename current window
<prefix> RRename current session
<prefix> _Split new pane horizontally
<prefix> |Split new pane vertically
<prefix> <Select next pane
<prefix> >Select previous pane
<prefix> ←Select pane on the left
<prefix> →Select pane on the right
<prefix> ↑Select pane on the top
<prefix> ↓Select pane on the bottom
<prefix> C-←Resize pane to the left
<prefix> C-→Resize pane to the right
<prefix> C-↑Resize pane to the top
<prefix> C-↓Resize pane to the bottom
<prefix> >Move to next window
<prefix> <Move to previous window
<prefix> TabSwitch to most recently used window
<prefix> LLink window from another session by entering target session and window reference
<prefix> \Swap panes back and forth with 1st pane. When in main-horizontal or main-vertical layout, the main panel is always at index 1. This keybinding let you swap secondary pane with main one, and do the opposite.
<prefix> C-oSwap current active pane with next one
<prefix> +Toggle zoom for current pane
<prefix> xKill current pane
<prefix> XKill current window
<prefix> C-xKill other windows but current one (with confirmation)
<prefix> QKill current session (with confirmation)
<prefix> C-uMerge current session with another. Essentially, this moves all windows from current session to another one
<prefix> dDetach from session
<prefix> DDetach other clients except current one from session
<prefix> C-sToggle status bar visibility
<prefix> mMonitor current window for activity
<prefix> MMonitor current window for silence by entering silence period
<prefix> F12Switch off all key binding and prefix hanling in current window. See "Nested sessions" paragraph for more info
\ No newline at end of file diff --git a/readme.md b/big-README.md similarity index 100% rename from readme.md rename to big-README.md