2026-05-13 13:13:35 +09:00
|
|
|
#Requires -Version 5.1
|
|
|
|
|
<#
|
|
|
|
|
.SYNOPSIS
|
|
|
|
|
Installs tmux (terminal multiplexer) and deploys .tmux.conf.
|
|
|
|
|
|
|
|
|
|
.DESCRIPTION
|
|
|
|
|
Installs tmux via winget (arndawg.tmux-windows) and deploys a
|
|
|
|
|
customized .tmux.conf to the current user's home directory.
|
|
|
|
|
|
|
|
|
|
Supported platforms:
|
|
|
|
|
- Windows x64 (AMD64 / Intel 64bit)
|
|
|
|
|
- Windows ARM64
|
|
|
|
|
|
|
|
|
|
Prerequisites:
|
|
|
|
|
- winget (Windows Package Manager) — built into Windows 10 1709+
|
|
|
|
|
|
|
|
|
|
.EXAMPLE
|
|
|
|
|
.\install-tmux.ps1
|
|
|
|
|
|
2026-05-13 18:57:40 +09:00
|
|
|
# One-liner install from remote (works on Windows 10+):
|
|
|
|
|
powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-tmux.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-tmux.ps1' -OutFile $t; & $t"
|
2026-05-13 13:13:35 +09:00
|
|
|
|
|
|
|
|
.NOTES
|
|
|
|
|
If execution policy error occurs:
|
|
|
|
|
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
|
|
|
|
|
#>
|
|
|
|
|
|
|
|
|
|
[CmdletBinding()]
|
|
|
|
|
param()
|
|
|
|
|
|
|
|
|
|
Set-StrictMode -Version Latest
|
|
|
|
|
$ErrorActionPreference = 'Stop'
|
|
|
|
|
|
2026-05-13 18:57:40 +09:00
|
|
|
# Force TLS 1.2+ for HTTPS downloads (required on Windows 10 / PowerShell 5.1)
|
|
|
|
|
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
|
|
|
|
|
|
2026-05-13 13:13:35 +09:00
|
|
|
# ────────────────────────────────────────────
|
|
|
|
|
# Utility functions
|
|
|
|
|
# ────────────────────────────────────────────
|
|
|
|
|
function Info { Write-Host "[INFO] $args" -ForegroundColor Cyan }
|
|
|
|
|
function Warn { Write-Host "[WARN] $args" -ForegroundColor Yellow }
|
|
|
|
|
function Success { Write-Host "[OK] $args" -ForegroundColor Green }
|
|
|
|
|
function ErrExit { Write-Host "[ERROR] $args" -ForegroundColor Red; exit 1 }
|
|
|
|
|
|
|
|
|
|
# ────────────────────────────────────────────
|
|
|
|
|
# Constants
|
|
|
|
|
# ────────────────────────────────────────────
|
|
|
|
|
$ConfFile = Join-Path $env:USERPROFILE '.tmux.conf'
|
|
|
|
|
|
|
|
|
|
# ────────────────────────────────────────────
|
2026-09-21 08:14:58 +09:00
|
|
|
# Step 0: Ensure OpenSSH Server (비활성화됨)
|
2026-05-27 10:50:39 +09:00
|
|
|
# ────────────────────────────────────────────
|
2026-09-21 08:14:58 +09:00
|
|
|
# Info "Checking OpenSSH Server installation status..."
|
|
|
|
|
# $sshService = Get-Service -Name "sshd" -ErrorAction SilentlyContinue
|
|
|
|
|
#
|
|
|
|
|
# if (-not $sshService) {
|
|
|
|
|
# Info "OpenSSH Server is not installed. Attempting installation..."
|
|
|
|
|
#
|
|
|
|
|
# # OpenSSH Server 기능 추가 (관리자 권한 필요)
|
|
|
|
|
# try {
|
|
|
|
|
# $capability = Get-WindowsCapability -Online -Name "OpenSSH.Server~~~~0.0.1.0"
|
|
|
|
|
# if ($capability.State -ne "Installed") {
|
|
|
|
|
# Info "Installing OpenSSH Server via Windows Optional Features..."
|
|
|
|
|
# Add-WindowsCapability -Online -Name "OpenSSH.Server~~~~0.0.1.0" > $null
|
|
|
|
|
# Success "OpenSSH Server feature added successfully."
|
|
|
|
|
# }
|
|
|
|
|
#
|
|
|
|
|
# # sshd 서비스 시작 및 자동 실행 설정
|
|
|
|
|
# Set-Service -Name "sshd" -StartupType Automatic
|
|
|
|
|
# Start-Service -Name "sshd"
|
|
|
|
|
# Success "OpenSSH Server (sshd) service started and configured as Automatic startup."
|
|
|
|
|
# } catch {
|
|
|
|
|
# Warn "Failed to auto-install OpenSSH Server: $_"
|
|
|
|
|
# Warn "This operation may require Administrator privileges."
|
|
|
|
|
# }
|
|
|
|
|
# } else {
|
|
|
|
|
# Success "OpenSSH Server is already installed."
|
|
|
|
|
# }
|
2026-05-27 10:50:39 +09:00
|
|
|
|
2026-05-27 10:55:42 +09:00
|
|
|
|
2026-05-27 10:50:39 +09:00
|
|
|
# ────────────────────────────────────────────
|
2026-05-13 13:13:35 +09:00
|
|
|
# Step 1: Install tmux
|
|
|
|
|
# ────────────────────────────────────────────
|
|
|
|
|
Info "Installing tmux..."
|
|
|
|
|
|
|
|
|
|
$tmuxCmd = Get-Command tmux -ErrorAction SilentlyContinue
|
|
|
|
|
if ($tmuxCmd) {
|
|
|
|
|
$currentVer = & tmux -V 2>$null
|
2026-05-13 17:29:04 +09:00
|
|
|
if (-not $currentVer) { $currentVer = "unknown" }
|
2026-05-13 13:13:35 +09:00
|
|
|
Info "tmux is already installed ($currentVer). Skipping installation."
|
|
|
|
|
} else {
|
|
|
|
|
if (-not (Get-Command winget -ErrorAction SilentlyContinue)) {
|
|
|
|
|
ErrExit "winget is required. Install it from the Microsoft Store or https://learn.microsoft.com/en-us/windows/package-manager/winget/"
|
|
|
|
|
}
|
|
|
|
|
|
2026-05-27 16:04:12 +09:00
|
|
|
winget install psmux --accept-package-agreements --accept-source-agreements 2>&1 | Out-Null
|
|
|
|
|
Success "tmux (psmux) installed via winget"
|
2026-05-13 13:13:35 +09:00
|
|
|
}
|
|
|
|
|
|
2026-05-13 17:18:15 +09:00
|
|
|
# ────────────────────────────────────────────
|
|
|
|
|
# Verify tmux is available and add to PATH permanently if needed
|
|
|
|
|
# ────────────────────────────────────────────
|
|
|
|
|
$tmuxBin = $null
|
|
|
|
|
|
|
|
|
|
# 1) Try current PATH
|
2026-05-13 13:13:35 +09:00
|
|
|
$tmuxCmd = Get-Command tmux -ErrorAction SilentlyContinue
|
|
|
|
|
if ($tmuxCmd) {
|
2026-05-13 17:18:15 +09:00
|
|
|
$tmuxBin = $tmuxCmd.Source
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
# 2) Refresh PATH from registry (winget may have added paths)
|
|
|
|
|
if (-not $tmuxBin) {
|
2026-05-13 13:13:35 +09:00
|
|
|
$env:Path = [System.Environment]::GetEnvironmentVariable('Path', 'User') + ';' + [System.Environment]::GetEnvironmentVariable('Path', 'Machine')
|
|
|
|
|
$tmuxCmd = Get-Command tmux -ErrorAction SilentlyContinue
|
|
|
|
|
if ($tmuxCmd) {
|
2026-05-13 17:18:15 +09:00
|
|
|
$tmuxBin = $tmuxCmd.Source
|
2026-05-13 13:13:35 +09:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2026-05-27 16:04:12 +09:00
|
|
|
# 3) Search common locations where winget installs tmux / psmux
|
2026-05-13 17:18:15 +09:00
|
|
|
if (-not $tmuxBin) {
|
|
|
|
|
$searchDirs = @(
|
|
|
|
|
(Join-Path $env:LOCALAPPDATA 'Microsoft\WinGet\Links'),
|
2026-05-27 16:04:12 +09:00
|
|
|
(Join-Path $env:LOCALAPPDATA 'Programs\psmux'),
|
2026-05-13 17:18:15 +09:00
|
|
|
(Join-Path $env:LOCALAPPDATA 'Programs\tmux-windows'),
|
2026-05-27 16:04:12 +09:00
|
|
|
'C:\Program Files\psmux',
|
2026-05-13 17:18:15 +09:00
|
|
|
'C:\Program Files\tmux-windows',
|
2026-05-27 16:04:12 +09:00
|
|
|
'C:\Program Files (x86)\psmux',
|
2026-05-13 17:18:15 +09:00
|
|
|
'C:\Program Files (x86)\tmux-windows'
|
|
|
|
|
)
|
|
|
|
|
foreach ($dir in $searchDirs) {
|
|
|
|
|
if (Test-Path $dir) {
|
2026-05-27 16:04:12 +09:00
|
|
|
foreach ($exe in @('tmux.exe', 'psmux.exe')) {
|
|
|
|
|
$candidate = Join-Path $dir $exe
|
|
|
|
|
if (Test-Path $candidate) { $tmuxBin = $candidate; break }
|
|
|
|
|
}
|
2026-05-13 17:18:15 +09:00
|
|
|
}
|
2026-05-27 16:04:12 +09:00
|
|
|
if ($tmuxBin) { break }
|
2026-05-13 17:18:15 +09:00
|
|
|
}
|
|
|
|
|
|
2026-05-27 16:04:12 +09:00
|
|
|
# Recurse under WinGet/Packages for tmux or psmux
|
2026-05-13 17:18:15 +09:00
|
|
|
if (-not $tmuxBin -and (Test-Path (Join-Path $env:LOCALAPPDATA 'Microsoft\WinGet\Packages'))) {
|
2026-05-27 16:04:12 +09:00
|
|
|
foreach ($filter in @('tmux.exe', 'psmux.exe')) {
|
|
|
|
|
$found = Get-ChildItem -Path (Join-Path $env:LOCALAPPDATA 'Microsoft\WinGet\Packages') -Recurse -Filter $filter -ErrorAction SilentlyContinue | Select-Object -First 1
|
|
|
|
|
if ($found) { $tmuxBin = $found.FullName; break }
|
|
|
|
|
}
|
2026-05-13 17:18:15 +09:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if ($tmuxBin) {
|
|
|
|
|
# Add tmux's directory to PATH for this session
|
|
|
|
|
$tmuxDir = Split-Path $tmuxBin
|
|
|
|
|
if ($env:Path -notlike "*$tmuxDir*") {
|
|
|
|
|
$env:Path = "$tmuxDir;$env:Path"
|
|
|
|
|
Info "Added $tmuxDir to PATH for this session"
|
|
|
|
|
}
|
|
|
|
|
Success "tmux is available: $tmuxBin"
|
|
|
|
|
|
|
|
|
|
# Permanently add tmux's directory to user PATH if not already there
|
|
|
|
|
$userPath = [System.Environment]::GetEnvironmentVariable('Path', 'User')
|
|
|
|
|
if ($userPath -notlike "*$tmuxDir*") {
|
|
|
|
|
[System.Environment]::SetEnvironmentVariable('Path', "$tmuxDir;$userPath", 'User')
|
|
|
|
|
Success "Added $tmuxDir to user PATH permanently (takes effect on next login)"
|
|
|
|
|
} else {
|
|
|
|
|
Info "$tmuxDir already in user PATH"
|
|
|
|
|
}
|
|
|
|
|
} else {
|
|
|
|
|
Warn "tmux was not found in PATH after installation."
|
|
|
|
|
Warn "Please restart your terminal or add tmux's directory to your PATH manually."
|
|
|
|
|
}
|
|
|
|
|
|
2026-05-13 13:13:35 +09:00
|
|
|
# ────────────────────────────────────────────
|
|
|
|
|
# Step 2: Deploy .tmux.conf
|
|
|
|
|
# ────────────────────────────────────────────
|
|
|
|
|
if (Test-Path $ConfFile) {
|
|
|
|
|
$timestamp = Get-Date -Format 'yyyyMMddHHmmss'
|
|
|
|
|
$backup = "${ConfFile}.bak.${timestamp}"
|
|
|
|
|
Copy-Item $ConfFile $backup
|
|
|
|
|
Warn "Existing .tmux.conf found at $ConfFile"
|
|
|
|
|
Info "Backup saved to $backup"
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$tmuxConf = @'
|
2026-05-13 18:17:08 +09:00
|
|
|
# .tmux.conf - tmux-windows compatible
|
|
|
|
|
#
|
|
|
|
|
# Based on: https://github.com/arndawg/tmux-windows/blob/master/example_tmux.conf
|
2026-05-13 13:13:35 +09:00
|
|
|
|
2026-05-13 18:17:08 +09:00
|
|
|
# Prefix key (default is Ctrl-b, changed to Ctrl-a)
|
2026-05-13 13:13:35 +09:00
|
|
|
set -g prefix C-a
|
|
|
|
|
unbind C-b
|
|
|
|
|
bind C-a send-prefix
|
|
|
|
|
|
2026-06-18 14:22:53 +09:00
|
|
|
# Ctrl + k를 누르면 화면을 깨끗이 지우고 tmux 이전 버퍼(히스토리)도 완전히 삭제
|
|
|
|
|
bind -n C-k clear-history
|
|
|
|
|
|
2026-06-16 14:04:48 +09:00
|
|
|
# 터미널 설정 (색상 설정 비활성화)
|
|
|
|
|
#set -g default-terminal "tmux-256color"
|
|
|
|
|
#set-option -sa terminal-features ",xterm*:RGB"
|
2026-05-13 18:17:08 +09:00
|
|
|
|
|
|
|
|
# No bells
|
|
|
|
|
set -g bell-action none
|
|
|
|
|
|
|
|
|
|
# Split panes with current path
|
2026-05-13 13:13:35 +09:00
|
|
|
bind | split-window -h -c "#{pane_current_path}"
|
|
|
|
|
bind - split-window -v -c "#{pane_current_path}"
|
|
|
|
|
unbind '"'
|
|
|
|
|
unbind %
|
|
|
|
|
|
2026-05-13 18:17:08 +09:00
|
|
|
# Pane navigation (vim-style)
|
2026-05-13 13:13:35 +09:00
|
|
|
bind h select-pane -L
|
|
|
|
|
bind j select-pane -D
|
|
|
|
|
bind k select-pane -U
|
|
|
|
|
bind l select-pane -R
|
|
|
|
|
|
2026-05-13 18:17:08 +09:00
|
|
|
# Window navigation
|
2026-05-13 13:13:35 +09:00
|
|
|
bind -r C-h previous-window
|
|
|
|
|
bind -r C-l next-window
|
|
|
|
|
|
2026-05-13 18:17:08 +09:00
|
|
|
# Layout
|
2026-05-13 13:13:35 +09:00
|
|
|
bind Space next-layout
|
|
|
|
|
bind o rotate-window
|
|
|
|
|
|
2026-05-13 18:17:08 +09:00
|
|
|
# Window management
|
2026-05-13 13:13:35 +09:00
|
|
|
bind , command-prompt "rename-window %%"
|
|
|
|
|
bind & kill-window
|
|
|
|
|
|
2026-05-13 18:17:08 +09:00
|
|
|
# Reload config
|
2026-05-13 13:13:35 +09:00
|
|
|
bind r source-file ~/.tmux.conf \; display "Reloaded!"
|
|
|
|
|
|
2026-06-16 14:04:48 +09:00
|
|
|
# 상태 표시줄 (색상 설정 비활성화)
|
|
|
|
|
#set -g status-bg colour235
|
|
|
|
|
#set -g status-fg colour136
|
2026-05-13 13:13:35 +09:00
|
|
|
set -g status-left-length 40
|
|
|
|
|
set -g status-right-length 40
|
|
|
|
|
set -g status-interval 5
|
|
|
|
|
set -g history-limit 10000
|
|
|
|
|
|
2026-06-16 14:04:48 +09:00
|
|
|
# 상태 표시줄 텍스트 색상 비활성화
|
|
|
|
|
#set -g status-left '#[fg=green]#S #[fg=yellow]#H'
|
|
|
|
|
#set -g status-right '#[fg=cyan]%Y-%m-%d #[fg=green]%H:%M:%S'
|
2026-05-13 13:13:35 +09:00
|
|
|
|
2026-06-16 14:04:48 +09:00
|
|
|
# 패널 테두리 색상 (색상 설정 비활성화)
|
|
|
|
|
#set-option -g pane-border-style 'fg=colour244'
|
|
|
|
|
#set-option -g pane-active-border-style 'fg=colour77'
|
2026-05-13 13:13:35 +09:00
|
|
|
|
2026-05-13 18:17:08 +09:00
|
|
|
# Copy mode with vi keys
|
2026-05-13 13:13:35 +09:00
|
|
|
setw -g mode-keys vi
|
|
|
|
|
|
2026-05-13 18:17:08 +09:00
|
|
|
# Mouse support (without copy mode dragging)
|
2026-05-13 13:13:35 +09:00
|
|
|
set -g mouse on
|
2026-05-13 18:17:08 +09:00
|
|
|
unbind -n MouseDrag1Pane
|
|
|
|
|
unbind -Tcopy-mode MouseDrag1Pane
|
2026-05-13 13:13:35 +09:00
|
|
|
|
|
|
|
|
# for pi
|
|
|
|
|
set -g extended-keys on
|
|
|
|
|
'@
|
|
|
|
|
|
2026-05-13 17:26:24 +09:00
|
|
|
[System.IO.File]::WriteAllText($ConfFile, $tmuxConf, [System.Text.UTF8Encoding]::new($false))
|
2026-05-13 13:13:35 +09:00
|
|
|
Success ".tmux.conf deployed to $ConfFile"
|
|
|
|
|
|
|
|
|
|
# ────────────────────────────────────────────
|
|
|
|
|
# Step 3: Post-install notes
|
|
|
|
|
# ────────────────────────────────────────────
|
|
|
|
|
Info ""
|
|
|
|
|
Info "=================================================="
|
|
|
|
|
Success "tmux installation complete!"
|
|
|
|
|
Info "=================================================="
|
2026-05-13 17:18:15 +09:00
|
|
|
if ($tmuxBin) {
|
|
|
|
|
Info ""
|
|
|
|
|
Info "tmux binary: $tmuxBin"
|
|
|
|
|
}
|
2026-05-13 13:13:35 +09:00
|
|
|
Info ""
|
2026-05-13 17:26:24 +09:00
|
|
|
Info "IMPORTANT: Close this terminal and open a new one to use tmux."
|
|
|
|
|
Info "PATH changes require a new terminal session to take effect."
|
|
|
|
|
Info ""
|
2026-05-13 18:35:28 +09:00
|
|
|
Info "RECOMMENDED: On Windows 10, use Windows Terminal instead of CMD.exe."
|
|
|
|
|
Info "Install it from: winget install Microsoft.WindowsTerminal"
|
|
|
|
|
Info "Windows Terminal supports true color, Unicode, and tmux panes properly."
|
|
|
|
|
Info ""
|
2026-05-13 13:13:35 +09:00
|
|
|
Info "Getting started:"
|
|
|
|
|
Info " tmux - Start a new session"
|
|
|
|
|
Info " tmux new -s <name> - Start a named session"
|
|
|
|
|
Info " tmux attach -t <name> - Attach to a session"
|
|
|
|
|
Info " tmux ls - List sessions"
|
|
|
|
|
Info ""
|
|
|
|
|
Info "Key bindings (customized via .tmux.conf):"
|
|
|
|
|
Info " Ctrl-a | - Split horizontally"
|
|
|
|
|
Info " Ctrl-a - - Split vertically"
|
|
|
|
|
Info " Ctrl-a h/j/k/l - Navigate panes (vim-style)"
|
|
|
|
|
Info " Ctrl-a r - Reload .tmux.conf"
|
|
|
|
|
Info ""
|
2026-05-13 19:55:50 +09:00
|
|
|
Info "Config file: $ConfFile"
|