WindTerm 2.7.0 #2722

kingToolbox · 2025-03-11T19:12:09Z

kingToolbox
Mar 11, 2025
Maintainer

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:

Agent forwarding

`Agent Forwarding` is a powerful feature that enhances remote access security by allowing the use of private SSH keys locally without exposing them to remote servers.

Performance

Terminal

The meticulous refinement of the code, coupled with the carefully optimized framework, further enhances the performance by `20%~30%` compared to version `2.6.1`. All operations respond more promptly and smoothly.

Sftp Transfer

Although version `2.6.1` was already incredibly fast, version `2.7.0` takes it a step further by increasing the transfer speed by another `20%~40%`. Whether you're transferring large files or a large number of small files, the new version can save you even more time!

Usage:

Windows

Version	Architecture	Operating Systems
WindTerm_2.7.0_Windows_Portable_x86_32	x86_32	Windows 7, Windows 8, Windows 10, Windows 11
WindTerm_2.7.0_Windows_Portable_x86_64	x86_64	Windows 7, Windows 8, Windows 10, Windows 11
WindTerm_2.7.0_Mac_Portable_x86_64	x86_64	macOS 10.13, macOS 10.14, macOS 10.15, macOS 11, macOS 12
WindTerm_2.7.0_Linux_Portable_x86_64	x86_64	Generic Linux (glibc 2.17 and later)

Installation

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.7.0_Linux_Portable_x86_64.tar.gz && cd ./WindTerm_2.7.0 && chmod +x ./WindTerm && ./WindTerm

Scoop

scoop bucket add extras
scoop install windterm

Chocolatey

choco install windterm

Upgrade

Versions before Version 2.4.0

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.

Versions after Version 2.4.0

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.

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.

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

[FILER] Supports displaying files within the WSL subsystem.
[FILER] Supports synchronizing the current folder of the WSL subsystem.
[GUI] Default font updated to RobotoMono Nerd for proper icon display in WindFind. can support nerd font https://www.nerdfonts.com/ ? #2413
[GUI] Automatically save text marks when exiting, and restore them upon next start-up.
[GUI] Disables rainbow brackets on the alt screen to avoid conflicts with features in editors like Vim. Rainbow brackets make writing code in Linux a mess. How to turn off this feature? #2111
[ONEKEY] Introduced a setting Menu / Session / Preferences / Settings / Terminal / Auto Completion / Enable OneKey completion to turn the OneKey completion feature on or off. The "Save In OneKeys" menu keeps popping up automatically #2213 How to disable onekey #2223 Onekey keeps getting triggered #2299 User-defined onekey manager enable or disable #2316 How can I diable "save in OneKeys" pop up? #2402 allways show save in oneskys #2667
[SCHEME] Supports highlighting four or eight consecutive hexadecimal digits.
[SCHEME] Supports highlighting for words following negations (e.g., "not," "don't").
[SESSION] Supports syntax highlighting, folding, command history, and autocompletion for Fish shell.
[SESSION] Supports deleting history items from the auto-complete list using Shift+Del.
[SFTP] In the gaps between sending and receiving packets, the SFTP thread will sleep to reduce CPU usage.
[SSH] Perform SSH operations, including connection establishment, authentication and command execution, in an asynchronous manner.
[SSH] Supports ssh-agent for authentication on Windows.
[SSH] Supports agent forwarding, with agents including pageant, ssh-agent, $SSH_AUTH_SOCK, Enviroment variable, Unix domain socket etc.
[SSH] Strictly ensure that the opening sequence is Shell, SFtp, Sysmon.
[SSH] Supports sending signals. And automatically sends SIGINT signal when Ctrl+C is pressed.
[SSH] Removes the internal proxy socket, allowing libssh to directly connect to the server and send/receive packets. This not only significantly improves packet transmission performance but also reduces the receive buffer by 256KiB per session.
[SYSMON] Supports displaying system information of the WSL subsystem, including CPU, memory, time, etc.
[TERM] Added tmux-256color.term configuration file.
[TERM] Supports CSI ?4m to allow query key modifier options. 'ESC[?4m' is displayed when vim opens the file #1623 When using vim/vi, ESC[?4m will be automatically added to the screen #1814 Regarding the ESC[?4m problem with vim 9 can you update a temporary version first or is there a patch for that? #2016
[TERM] Supports ESC k ... ESC \ to allow screen to set the window title.

Improvements:

[APP] Refined the application icon to conform to the abc system’s design style. MacOS version: high memory usage, large application icon and bottom pane is difficult to reopen after closing #463 The application icon of MacOS version is a bit big #651 Dock icon #1824 The app icon looks terrible #1905 MacOS icon suggestion #2031 icon！icon！！icon！！！图标图标图标！！ #2089 icon is too ugly #2144 Change App's Icon MacOS #2535 Windterm ICON FOR MAC #2701 Can you change the icon of Mac OS? It's so uncomfortable if it's not unified! #2704
[APP] Auto-save application state (e.g., open sessions) every application.autoSaveHistoryInterval minutes to improve recovery from crashes. WindTerm 2.7.0 Prerelease 2 #2644 Crash when exiting session (occur randomly) in Rocky Linux 9.4 #2677
[GUI] No longer draws a rectangular caret when focus is lost.
[GUI] Significantly improves the clarity of screenshots in tab tooltips.
[GUI] Splitting or merging panes now only resizes adjacent panes, not all panes.
[GUI] Prefill identity file path in the login wizard's Public Key tab, if the file exists.
[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.
[SESSION] Significantly improved text parsing, modification, and rendering, especially to avoid extremely slow screen rendering when the text exceeds the maximum number of srollback lines.
[SESSION] Enabled keep session alive by default to avoid unnecessary disconnections after long idle periods; default interval is 60s. [Feature Request] Add new ssh keep alive method #2051
[TEXT] Improved text insertion by reducing memory moves from two to one, resulting in better performance.

Bugs:

[APP] Application may crash when closing and switching session tabs. WindTerm 2.7.0 Prerelease 2 #2644 WindTerm often crashes on macOS 15.2 (24C101) #2666 Crash when exiting session (occur randomly) in Rocky Linux 9.4 #2677
[APP] The application sometimes crashes when rapidly reconnecting to the server repeatedly.
[FILER] In WSL, the Move To dialog adds an unnecessary \\wsl$\distroname\ prefix to the path when moving files to another folder.
[FILER] In WSL, the Move To menu item moves files to the root directory instead of the specified folder.
[FILER] Periodic cwd requests to the server occur even with Sftp disabled.
[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] Erroneously synchronizing current directory on session focus, even when Sync Terminal Folder button is unchecked.
[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.
[GUI] No longer prompts to import Shell configuration on startup, as this was only necessary for pre-2.5 compatibility. How can I solve the problem where macos uses windterm and pops up a window every time it restarts? #2100 I have to re-import shell sessions every time #2119 Mac每次重启WindTerm都会弹窗提示“The following new features have been added to shell sessions” #2525 Prevent Shell Sessions Pop-up #2536
[GUI] Entering protocol://host:port in the address bar would incorrectly ignore the specified port and use the protocol's default port instead. There is a bug in the address bar 地址栏存在bug #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. [bug] In the 2.7-prerelease version, the size of the window preview is abnormal.(2.7-prerelease 版本，窗口预览功能异常) #2634
[GUI] After creating a new session tab, returning to the previously active session tab results in the status bar incorrectly displaying a window size of 0x0.
[SESSION] When a command generates a large amount of output, pressing Ctrl+C does not immediately stop the command execution.
[SESSION] During file transfers, keyboard input becomes sluggish or even unresponsive.
[SESSION] When text exceeds the maximum number of scrollback lines, the text at the bottom is sometimes incorrectly colored.
[SESSION] Default window size used on initialization even when Adjust the windows rows and columns is true, leading to incorrect scrollbar display.
[SFTP] The content of the downloaded large file does not match the source file. 下载一个 20m 的log文件，本地打开是空白 Download a 20m log file, open it locally and it will be blank #2224
[SHELL] Temporarily replaced ConPty with WinPty to prevent illegal character CSI 0%m in vi. vim shows unexpected characters #1114
[SSH] Dynamic port forwarding fails to proxy DNS queries. SSH port forwarding issue #26 proxyjump error #280 Dynamic Forwarding tunnel not work #318 dynamic ssh tunnel not work #502 SSH Jumpserver - SOCKS version 5 protocol error #927 Is it possible to do not make name resolution on client side but on jump server side ? #969 Chrome shows "ERR_PROXY_CONNECTION_FAILED" when using dynamic tunnel #1169 [bug] ssh Proxy-Jump with DNS #2152 Using a Dynamic forwarding tunnel (for a SOCKS5 proxy), DNS requests do not go through so no web pages load #2529 Dynamic Port Forwarding not work #2638
[SSH] Disconnecting a duplicated channel causes all channels in that session to be disconnected. type 'ctrl+d' will disconnect all the ssh sessions duplicated #623
[TERM] Previous term type was not properly restored after exiting vt52.
[WSL] In Vim on WSL2, uppercase letters cannot be entered using the Shift key.
[ZMODEM] File transfers using sz, rz always get stuck at 99% and do not complete. sz下载文件就卡住。 #1913 sz download progress is stuck #2467 In version 2.6.1, when using the sz and rz commands to upload and download on Mac OS, the percentage progress (0-100) cannot be displayed normally. #2607 can not upload file in 2.7.0 Prerelease 2 #2647 rz in WindTerm 2.7.0 Prerelease 2 has a bug #2662

Checksums:

WindTerm_2.7.0_Linux_Portable_x86_64.zip

md5: 46ae6766565bcbe225337d6045078c4e

sha256: 7797697eeb60239020512e2b549695a60c39b3fd01fe7ebb047fd50a2889103c

WindTerm_2.7.0_Mac_Portable_x86_64.zip

md5: f7e6292fd010771ef20bb015725c447b

sha256: 8c1bc1363e01df5b06f45019da934752f5f29e8603cc843bd38e59bdff121bf7

WindTerm_2.7.0_Windows_Portable_x86_32.zip

md5: 1725123c2e20abf186601a931b2baa22

sha256: d04b2742c33773c0a0a5761889ca599ad5c443224dbc6198fe0e9e8de84f62c7

WindTerm_2.7.0_Windows_Portable_x86_64.zip

md5: 8bf33c1b4a47c53f34064294921c04b8

sha256: b05c3c7371340ff1302967247ffcd3a3ba27b237f72010e9157086143c453e50

This discussion was created from the release WindTerm 2.7.0.

kingToolbox · 2025-03-11T21:28:45Z

kingToolbox
Mar 11, 2025
Maintainer Author

The release of the 2.7.0 version has been postponed due to recent workload. Nonetheless, I have initiated development on version 2.8.0 and anticipate releasing the first prerelease this month. The key features of version 2.8.0 are outlined below:

Implement the ZModem protocol to eliminate dependence on third-party lrzsz software.
Implement the newly designed WModem (WindTerm's Modem) protocol to enable file transfer with most systems without requiring any third-party software (such as lrzsz).
Re-implement Shell to achieve better performance.
Improve parsing speed for high-volume text and enhance energy efficiency.
Fix more bugs.