tmux-installer

# Tmux + Oh My Tmux Installer ## Overview 在 Linux 系统上安装和配置 Tmux + Oh My Tmux (gpakosz/.tmux)，统一团队终端复用器环境。包括 Tokyo Night 主题配色、Powerline 分隔符、自定义快捷键和鼠标支持。 ## When to Use This Skill - 在新 VM 或服务器上安装和配置 tmux - 用户要求安装 tmux 或 oh-my-tmux - 需要统一的 tmux 配置 - 诊断 tmux 配置相关问题 ## Prerequisites - Ubuntu/Debian 系统 (apt-get) - sudo 权限 - git (用于 clone oh-my-tmux) - 网络连接 ## Important: 先安装 Zsh 在安装 tmux 之前，应先安装 Zsh + Oh My Zsh。请先使用 `zsh-installer` 技能完成 shell 配置。 ## Quick Start ```bash # 1. 安装 tmux sudo apt-get update && sudo apt-get install -y tmux # 2. 安装 Oh My Tmux cd ~ && git clone https://github.com/gpakosz/.tmux.git ln -s -f .tmux/.tmux.conf ~/.tmux.conf # 3. 写入自定义配置 (见 Step 3) ``` ## Installation Workflow ### Step 1: 安装 Tmux ```bash sudo apt-get update && sudo apt-get install -y tmux ``` 验证安装: ```bash tmux -V # 预期: tmux 3.4 或更高 ``` ### Step 2: 安装 Oh My Tmux ```bash cd ~ git clone https://github.com/gpakosz/.tmux.git ln -s -f .tmux/.tmux.conf ~/.tmux.conf cp .tmux/.tmux.conf.local ~/.tmux.conf.local ``` **说明:** - `.tmux/.tmux.conf` 是 Oh My Tmux 的主配置（不要修改） - `.tmux.conf.local` 是用户自定义配置（所有个性化设置在这里） ### Step 3: 写入自定义配置 将以下内容写入 `~/.tmux.conf.local`: ```bash cat > ~/.tmux.conf.local << 'TMUX_EOF' # Oh my tmux! - https://github.com/gpakosz/.tmux # -- bindings ------------------------------------------------------------------ tmux_conf_preserve_stock_bindings=false # -- session creation ---------------------------------------------------------- tmux_conf_new_session_prompt=false tmux_conf_new_session_retain_current_path=false # -- windows & pane creation --------------------------------------------------- tmux_conf_new_window_retain_current_path=true tmux_conf_new_window_reconnect_ssh=false tmux_conf_new_pane_retain_current_path=true tmux_conf_new_pane_reconnect_ssh=false # -- display ------------------------------------------------------------------- tmux_conf_24b_colour=auto # -- theming ------------------------------------------------------------------- tmux_conf_theme=enabled # Tokyo Night color scheme tmux_conf_theme_colour_1="#080808" # dark gray tmux_conf_theme_colour_2="#303030" # gray tmux_conf_theme_colour_3="#8a8a8a" # light gray tmux_conf_theme_colour_4="#00afff" # light blue tmux_conf_theme_colour_5="#e0af68" # Tokyo Night gold tmux_conf_theme_colour_6="#080808" # dark gray tmux_conf_theme_colour_7="#a9b1d6" # Tokyo Night soft white tmux_conf_theme_colour_8="#080808" # dark gray tmux_conf_theme_colour_9="#e0af68" # Tokyo Night gold tmux_conf_theme_colour_10="#7aa2f7" # Tokyo Night blue tmux_conf_theme_colour_11="#9ece6a" # Tokyo Night green tmux_conf_theme_colour_12="#8a8a8a" # light gray tmux_conf_theme_colour_13="#a9b1d6" # Tokyo Night soft white tmux_conf_theme_colour_14="#080808" # dark gray tmux_conf_theme_colour_15="#080808" # dark gray tmux_conf_theme_colour_16="#414868" # Tokyo Night dark gray-blue tmux_conf_theme_colour_17="#a9b1d6" # Tokyo Night soft white # window style tmux_conf_theme_window_fg="default" tmux_conf_theme_window_bg="default" tmux_conf_theme_highlight_focused_pane=false tmux_conf_theme_focused_pane_bg="$tmux_conf_theme_colour_2" # pane border style tmux_conf_theme_pane_border_style=thin tmux_conf_theme_pane_border="$tmux_conf_theme_colour_2" tmux_conf_theme_pane_active_border="$tmux_conf_theme_colour_4" %if #{>=:#{version},3.2} tmux_conf_theme_pane_active_border="#{?pane_in_mode,$tmux_conf_theme_colour_9,#{?synchronize-panes,$tmux_conf_theme_colour_16,$tmux_conf_theme_colour_4}}" %endif # pane indicator colours tmux_conf_theme_pane_indicator="$tmux_conf_theme_colour_4" tmux_conf_theme_pane_active_indicator="$tmux_conf_theme_colour_4" # status line style tmux_conf_theme_message_fg="$tmux_conf_theme_colour_1" tmux_conf_theme_message_bg="$tmux_conf_theme_colour_5" tmux_conf_theme_message_attr="bold" tmux_conf_theme_message_command_fg="$tmux_conf_theme_colour_5" tmux_conf_theme_message_command_bg="$tmux_conf_theme_colour_1" tmux_conf_theme_message_command_attr="bold" # window modes style tmux_conf_theme_mode_fg="$tmux_conf_theme_colour_1" tmux_conf_theme_mode_bg="$tmux_conf_theme_colour_5" tmux_conf_theme_mode_attr="bold" # status line style tmux_conf_theme_status_fg="$tmux_conf_theme_colour_3" tmux_conf_theme_status_bg="$tmux_conf_theme_colour_1" tmux_conf_theme_status_attr="none" # terminal title tmux_conf_theme_terminal_title="#h ❐ #S ● #I #W" # window status style tmux_conf_theme_window_status_fg="$tmux_conf_theme_colour_3" tmux_conf_theme_window_status_bg="$tmux_conf_theme_colour_1" tmux_conf_theme_window_status_attr="none" tmux_conf_theme_window_status_format="#I #W#{?#{||:#{window_bell_flag},#{window_zoomed_flag}}, ,}#{?window_bell_flag,!,}#{?window_zoomed_flag,Z,}" # window current status style tmux_conf_theme_window_status_current_fg="$tmux_conf_theme_colour_1" tmux_conf_theme_window_status_current_bg="$tmux_conf_theme_colour_4" tmux_conf_theme_window_status_current_attr="bold" tmux_conf_theme_window_status_current_format="#I #W#{?#{||:#{window_bell_flag},#{window_zoomed_flag}}, ,}#{?window_bell_flag,!,}#{?window_zoomed_flag,Z,}" # window activity status style tmux_conf_theme_window_status_activity_fg="default" tmux_conf_theme_window_status_activity_bg="default" tmux_conf_theme_window_status_activity_attr="underscore" # window bell status style tmux_conf_theme_window_status_bell_fg="$tmux_conf_theme_colour_5" tmux_conf_theme_window_status_bell_bg="default" tmux_conf_theme_window_status_bell_attr="blink,bold" # window last status style tmux_conf_theme_window_status_last_fg="$tmux_conf_theme_colour_4" tmux_conf_theme_window_status_last_bg="$tmux_conf_theme_colour_2" tmux_conf_theme_window_status_last_attr="none" # Powerline separators tmux_conf_theme_left_separator_main='\uE0B0' tmux_conf_theme_left_separator_sub='\uE0B1' tmux_conf_theme_right_separator_main='\uE0B2' tmux_conf_theme_right_separator_sub='\uE0B3' # status left/right content tmux_conf_theme_status_left=" ❐ #S | ↑#{?uptime_y, #{uptime_y}y,}#{?uptime_d, #{uptime_d}d,}#{?uptime_h, #{uptime_h}h,}#{?uptime_m, #{uptime_m}m,} " tmux_conf_theme_status_right=" #{prefix}#{mouse}#{pairing}#{synchronized}#{?battery_status,#{battery_status},}#{?battery_bar, #{battery_bar},}#{?battery_percentage, #{battery_percentage},} , %R , %d %b | #{username}#{root} | #{hostname} " # status left style tmux_conf_theme_status_left_fg="$tmux_conf_theme_colour_6,$tmux_conf_theme_colour_7,$tmux_conf_theme_colour_8" tmux_conf_theme_status_left_bg="$tmux_conf_theme_colour_9,$tmux_conf_theme_colour_10,$tmux_conf_theme_colour_11" tmux_conf_theme_status_left_attr="bold,none,none" # status right style tmux_conf_theme_status_right_fg="$tmux_conf_theme_colour_12,$tmux_conf_theme_colour_13,$tmux_conf_theme_colour_14" tmux_conf_theme_status_right_bg="$tmux_conf_theme_colour_15,$tmux_conf_theme_colour_16,$tmux_conf_theme_colour_17" tmux_conf_theme_status_right_attr="none,none,bold" # indicators tmux_conf_theme_pairing="⚇" tmux_conf_theme_pairing_fg="none" tmux_conf_theme_pairing_bg="none" tmux_conf_theme_pairing_attr="none" tmux_conf_theme_prefix="⌨" tmux_conf_theme_prefix_fg="none" tmux_conf_theme_prefix_bg="none" tmux_conf_theme_prefix_attr="none" tmux_conf_theme_mouse="↗" tmux_conf_theme_mouse_fg="none" tmux_conf_theme_mouse_bg="none" tmux_conf_theme_mouse_attr="none" tmux_conf_theme_root="!" tmux_conf_theme_root_fg="none" tmux_conf_theme_root_bg="none" tmux_conf_theme_root_attr="bold,blink" tmux_conf_theme_synchronized="⚏" tmux_conf_theme_synchronized_fg="none" tmux_conf_theme_synchronized_bg="none" tmux_conf_theme_synchronized_attr="none" # battery tmux_conf_battery_bar_symbol_full="◼" tmux_conf_battery_bar_symbol_empty="◻" tmux_conf_battery_bar_length="auto" tmux_conf_battery_bar_palette="gradient" tmux_conf_battery_hbar_palette="gradient" tmux_conf_battery_vbar_palette="gradient" tmux_conf_battery_status_charging="↑"