.tmux.conf

#######
# REF #
#######

# References :
# - `man tmux`
# - tmux cheatsheet : https://devhints.io/tmux
# - https://github.com/majutsushi/etc/blob/master/tmux/tmux.conf
# - https://github.com/jtdaugherty/tmux-config/blob/master/tmux.conf
# - https://github.com/sbernheim4/dotfiles/blob/master/.tmux.conf

# Aliases :
# - set  = set-option
# - setw = set-window-option = set -w

##############
# PREFIX-KEY #
##############

# Prefix-Key ( make it easier to press )
## Replace default `ctrl + b` with `ctrl + q`
set -g prefix C-q
unbind C-b

# Make `ctrl + a` Sendable ( to other programs )
bind C-a send-prefix

##########
# WINDOW #
##########

## New
bind c new-window -c "#{pane_current_path}"

## Split
bind \\ split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"

########
# PANE #
########

# Select
bind h select-pane -L
bind j select-pane -D
bind k select-pane -U
bind l select-pane -R

# Resize
bind -r ^y resizep -L 5 # left  (pf, ^h)
bind -r ^u resizep -D 5 # down  (pf, ^j)
bind -r ^i resizep -U 5 # up    (pf, ^k)
bind -r ^o resizep -R 5 # right (pf, ^l)

# Maximize & Minimize
unbind M
unbind m
bind M new-window -d -n tmp \; swap-pane -s tmp.1 \; select-window -t tmp
bind m last-window \; swap-pane -s tmp.1 \; kill-window -t tmp

###########
# SESSION #
###########

bind ^s kill-session

#################
# MIS-OPERATION #
#################

# Unbind Default Key-Bindings
## For avoiding mis-operations

## Switch Pane
unbind o
## Next Layout
unbind Space

####################
# CONFIG & OPTIONS #
####################

# Reload Configs
bind r source-file ~/.tmux.conf \; display "Reloaded!"

# Show Configs

## Server
bind e show-options -s
## Global
bind g show-options -g
## Ref
## - Show options : https://subscription.packtpub.com/book/hardware_and_creative/9781783985166/2/ch02lvl1sec23/show-options

##########
# COMMON #
##########

# Auto Re-number Windows ( in numerical order )
## Default : off
set -g renumber-windows on

# First Index of Windows
## Default : 0
set -g base-index 1

# First Index of Panes
## Default : 0
setw -g pane-base-index 1

# Mouse Support
## WARN: Not supported everywhere.
## It will disable `selection-copy` on iTerm,
## so I have to press ⌥ option key & select by mouse for selection-copy.
set -g mouse on

#############
# COPY-MODE #
#############

# Use VI or Emacs-style Key Bindings in Copy Mode
## Options : emacs | vi
## Default : emacs
setw -g mode-keys vi

# Select & Copy
bind-key -T copy-mode-vi 'v' send -X begin-selection
bind-key -T copy-mode-vi 'u' send -X copy-selection
bind-key -T copy-mode-vi 'y' send -X copy-selection-and-cancel
bind-key -T copy-mode-vi 'Y' send -X copy-line

# ( Ref : https://www.grailbox.com/2020/08/use-system-clipboard-for-vi-copy-mode-in-tmux-in-macos-and-linux )
#bind-key -T copy-mode-vi 'y' send -X copy-pipe-and-cancel 'reattach-to-user-namespace pbcopy'

###############
# STATUS-LINE #
###############

# Position
## Options : top | bottom
## Default : bottom
set-option -g status-position bottom

# Refresh Every Interval Seconds
## Default : 15
set -g status-interval 1

# Style : Colors
##
# set -g status-style fg=black
# set -g status-style bg=green

# Left
## Default : "[#S] "
# set -g status-left " Session: #S"
set -g status-left "#[fg=black] Windows "
## Default : 10
set -g status-left-length 9

# Right
## Default : "username" hh:mm dd-MMM-YY
## e.g. : "icehe" 18:07 16-Jun-19
set -g status-right "#{prefix_highlight} "
set -ag status-right "#[fg=black]#{pane_current_path} | "
set -ag status-right "#[fg=black]%T %a %m/%d "
## Default : 40
set -g status-right-length 150

###############
# WINDOW-LIST #
###############

# Position of Window List
## Options : left | centre | right
## Default : left
# set -g status-justify left

# Control Auto Window Renaming
## Auto rename window using format specified by `automatic-rename-format`
setw -g automatic-rename on
setw -g automatic-rename-format "#{pane_current_command}"

# Format in Status Line Window List
setw -g window-status-separator ''
setw -g window-status-format " #I.#W "
setw -g window-status-current-format " #I.#W "

# Status Line Style for Windows
setw -g window-status-current-style "fg=white,bg=black"
setw -g window-status-bell-style "fg=default,bg=default"
setw -g window-status-activity-style "bg=yellow"

###########
# PLUGINS #
###########

# > It's optional.
#
# Reference: 
#
# - Tmux Plugin Manager: https://github.com/tmux-plugins/tpm
# - Tmux Plugins: https://github.com/tmux-plugins

##########
# BUGFIX #
##########

# Should NOT show the control characters, e.g. backspaces!
# ( Ref: https://github.com/tmux/tmux/issues/597#issuecomment-257097101 )
set -g default-terminal "xterm-256color"