Windows Terminal Multiplexer reads ~/.wtmux.conf (or ~/.tmux.conf as fallback). It supports a subset of tmux configuration syntax.

Note: After editing the config, restart the server: wtmux kill-server then wtmux new-session

Example

# Change prefix key to Ctrl+A
set -g prefix C-a

# Default shell with arguments
set -g default-shell pwsh
set -g default-shell-arg -NoLogo

# Window numbering starts at 1
set -g base-index 1

# Enable mouse support
set -g mouse on

# Terminal settings
set -g default-terminal "screen-256color"
set -g history-limit 50000
set -g set-titles on
set -g automatic-rename on
set -g display-time 4000

# Status bar customization
set -g status-position bottom
set -g status-interval 5
set -g status-left '#{prefix_highlight} [#S] '
set -g status-right '%a %Y-%m-%d %H:%M'
set -g status-style fg=white,bg=black
set -g window-status-current-format '*#I:#W '
set -g window-status-format ' #I:#W '

# Custom key bindings
bind | split-window -h       # Vertical split with |
bind - split-window          # Horizontal split with -
bind h select-pane -L        # Vim-style pane navigation
bind j select-pane -D
bind k select-pane -U
bind l select-pane -R
unbind %                     # Remove default binding

# Include another config file
source-file ~/.wtmux.local.conf

# Run a PowerShell script during config loading
run 'Write-Output "set -g status-right $(Get-Date -Format HH:mm)"'

Format Variables

Variable Description
#S Session name
#I Window index
#W Window name
#P Pane index
#H Hostname
#T Pane title
#{prefix_highlight} Prefix key indicator (inverse video when active)
#{?client_prefix,yes,no} Conditional text based on prefix state

Long-form names are also supported: #{session_name}, #{window_index}, #{window_name}, #{pane_index}, #{pane_title}, #{host}, #{host_short}.

Time Formats

Format Description Example
%H Hour (24h) 14
%I Hour (12h) 02
%M Minute 35
%S Second 09
%R HH:MM 14:35
%T HH:MM:SS 14:35:09
%p AM/PM PM
%P am/pm pm
%a Day abbreviation Mon
%A Day full name Monday
%d Day of month 07
%e Day (space-padded)  7
%b / %h Month abbreviation Jan
%B Month full name January
%m Month number 01
%Y Year 2026
%j Day of year 042
%k Hour (space-padded 24h) 14
%l Hour (space-padded 12h)  2

Colors

Named colors: red, green, blue, yellow, cyan, magenta, white, black, default

256-color palette: colour0 through colour255