mac配置iterm2使用trzsz

trzsz github

trzsz官网

安装

brew

brew install trzsz

python3

注意

# Debian 12 (Bookworm) / Ubuntu 23.04 及更新版本有 PEP 668 限制，需加 --break-system-packages
sudo python3 -m pip install --upgrade trzsz --break-system-packages

sudo python3 -m pip install --upgrade trzsz-iterm2

deb（Go 版，推荐）

Go 版处理大文件比 Python 版快得多且更稳，服务器端推荐用这个：

trzsz-go

# ARM64（aarch64）机器
wget https://github.com/trzsz/trzsz-go/releases/download/v1.2.0/trzsz_1.2.0_linux_aarch64.deb -O /tmp/trzsz.deb

# x86_64 机器把文件名换成 trzsz_1.2.0_linux_x86_64.deb
sudo dpkg -i /tmp/trzsz.deb

• 如果之前用 pip 装过，删掉残留命令，否则 PATH 里旧版抢先：sudo rm /usr/local/bin/trz /usr/local/bin/tsz && hash -r
• 验证：trz -v 显示 trz (trzsz) go 1.2.0 即成功

nodejs

sudo npm install -g trzsz

配置

iterm2 -> 设置

通用 -> Magic -> 勾选 Python API

配置文件 -> 高级 -> 触发器

点击 +

配置触发器

说明

• 正则表达式填写

  :(:TRZSZ:TRANSFER:[SRD]:\d+\.\d+\.\d+:\d+)

• 操作选择 运行静默协处理器 ，并在下方填写 trzsz-iterm2 的绝对路径

  /opt/homebrew/bin/trzsz-iterm2 \1

• 勾选 已启用

验证

输入如下指令

echo '::TRZSZ:TRANSFER:R:1.1.7:1111:2222'

如果有弹窗说明配置正确

进度条配置

使用文本进度条

配置

在触发器操作命令增加 -p text

/opt/homebrew/bin/trzsz-iterm2 -p text \1

效果

使用 zenity 进度条

安装

安装 zenity

brew

brew install ncruces/tap/zenity

编译安装

go install github.com/ncruces/zenity/cmd/zenity@latest
sudo cp ~/go/bin/zenity /usr/local/bin/zenity

配置

触发器操作命令保持默认即可，无需另外配置

/opt/homebrew/bin/trzsz-iterm2 \1

注意

trzsz在mac /opt/homebrew/Cellar/trzsz/1.1.7/libexec/lib/python3.15/site-packages/trzsz/iterm2/zenity_progress.py 文件中代码硬编码了 /usr/local/bin/zenity ，所以如果 zenity 命令不在 /usr/local/bin 的话就需要做一个软连接

sudo ln -sv $(which zenity) /usr/local/bin/zenity

效果