Spotlight

Tmux Integration (tmux -CC)

Tmux Integration making it easier and more efficient for you to work with tmux. With this integration, tmux sessions, windows, and panes are mapped and displayed in the native user interface. All commonly used tmux features are fully supported, creating a near-perfect fusion between tmux and WindTerm.

Tmux Integration supports:

Usage:

Windows

Version	Architecture	Operating Systems
WindTerm_2.7.0_Prerelease_2_Windows_Portable_x86_64	x86_64	Windows 7, Windows 8, Windows 10, Windows 11

<details> <summary>Installation</summary>

Download portable packages and uncompress it.

MacOS Please open dmg file and drag WindTerm.app to the Applications folder.

Linux Please use the following command to run the WindTerm after downloading.

tar -xzvf WindTerm_2.4.0_Linux_Portable_x86_64.tar.gz && cd ./WindTerm_2.4.0 && chmod +x ./WindTerm && ./WindTerm

Scoop

scoop bucket add extras scoop install windterm

Chocolatey

choco install windterm </details>

Upgrade

<details> <summary>Versions before Version 2.4.0</summary>

Start WindTerm and select the profiles directory and quit.
Replace the new .wind/profiles folder with the old profiles folder.
Restart WindTerm and all the sessions and configuration will be restored. </details> <details> <summary>Versions after Version 2.4.0</summary>
Start WindTerm and select the profiles directory containing the old .wind folder.
It is recommended to choose the Home Directory to facilitate subsequent upgrades.

If the .wind folder needs to be moved to another system:

Quit WindTerm.
Replace the new .wind folder with the old .wind folder.
Restart WindTerm and all the sessions and configuration will be restored.

The .wind folder is cross-platform. </details>

Known Issues:

[ZMODEM] Only support file names contains ASCII characters in Windows, otherwise the file name of the transfered file will be garbled after transmission, but it does not affect the correctness of the file content. Linux and MacOS version does not have this problem.
[TMUX] Tmux integration lacks support for Sender Pane and Sync Input.
[TMUX] Tmux integration does not support nesting.

Changes in Version 2.7.0 Prerelease 2 (2025-1-11):

Features:

[APP] Supports Tmux Integration.

Shortcut	Action
Alt + B	Show `Mux/Tmux` Command Palette
Alt + X	Close the current pane
Alt + Z	Zoom the current pane
Alt + Left Arrow	Select the left pane
Alt + Right Arrow	Select the right pane
Alt + Up Arrow	Select the pane above
Alt + Down Arrow	Select the pane below
Alt + [	Select the previous window
Alt + ]	Select the next winodw
Alt + -	Split pane right
Alt + Shift + -	Split pane left
Alt + \|	Split pane down
Alt + Shift + \|	Split pane up

[GUI] Default font updated to RobotoMono Nerd for proper icon display in WindFind. #2413
[SESSION] Supports syntax highlighting, folding, command history, and autocompletion for Fish shell.
[SCHEME] Supports highlighting four or eight consecutive hexadecimal digits.
[SCHEME] Supports highlighting for words following negations (e.g., "not," "don't").
[TERM] Added tmux-256color.term configuration file.
[TERM] Supports CSI ?4m to allow query key modifier options. #1623 #1814 #2016
[TERM] Supports ESC k ... ESC \ to allow screen to set the window title.

Improvements:

[SESSION] Enabled keep session alive by default to avoid unnecessary disconnections after long idle periods; default interval is 60s. #2051
[GUI] No longer draws a rectangular caret when focus is lost.
[GUI] Splitting or merging panes now only resizes adjacent panes, not all panes.
[GUI] Improved width calculation for text displayed in the margins.
[GUI] Reassigned shortcut for action Window.SetLocalMode and Window.SetRemoteMode from Alt+Enter to Ctrl+Enter.
[GUI] Reassigned shortcut for action Window.ToggleFocusMode from Ctrl+Enter to Alt+Enter.
[MODEM] Replaced progress bar widget with a text-based progress bar to avoid unnecessary resizing of the terminal window.
[TEXT] Improved text insertion by reducing memory moves from two to one, resulting in better performance.

Bugs:

[SSH] Unable to connect to OpenWrt, regression from v2.7.0 Prerelease 1.
[SHELL] Temporarily replaced ConPty with WinPty to prevent illegal character CSI 0%m in vi. #1114
[GUI] No longer uses full hinting for text rendering to avoid potential blurry text, regression from v2.7.0 Prerelease 1. #2438
[GUI] No longer prompts to import Shell configuration on startup, as this was only necessary for pre-2.5 compatibility. #2100 #2119 #2525 #2536
[GUI] Entering protocol://host:port in the address bar would incorrectly ignore the specified port and use the protocol's default port instead. #2255
[GUI] File dialog returns folder path instead of entering folder on "Open" after folder selection.
[GUI] Double-pressing the Alt+; key results in an empty list in the Command Palette.
[GUI] Preview window continuously shrinks as the mouse moves downwards over the scrollbar. #2634
[GUI] The screen flickers in fullscreen mode when opening a menu via the Layout button, regression from v2.7.0 Prerelease 1.
[FILER] Infinite loop of Failed to open directory errors occurs when switching to a session where filer's current folder has been removed.
[FILER] Unnecessary //wsl$/ditroname/ is included in paths generated by Copy Directory Path To Terminal and Copy Paths To Terminal menu items.
[FILER] Failed to enter the user's home directory when starting WSL, defaulting to the root directory.
[FILER] When browsing the cmd or wsl system, folder properties dialog is blank when right-clicking empty space and selecting menu item "Properties...".
[FILER] When browsing files in the wsl subsystem, the option Show Hidden Items does not hide files starting with a dot.
[SESSION] Default window size used on initialization even when Adjust the windows rows and columns is true, leading to incorrect scrollbar display.
[TERM] Previous term type was not properly restored after exiting vt52.

Checksums:

WindTerm_2.7.0_Prerelease_2_Windows_Portable_x86_64.zip

md5: 31c56c8007c98cd65461753e6a8d07fd

sha256: d58fecd477e3bc6e4d3eb5fd52ca910d51b1beea483dfc1c8aba73de3f9f98fe