Trzsz-iTerm2 安装文档

trzsz ( trz / tsz ) 是一个兼容 tmux 的文件传输工具，和 lrzsz ( rz / sz ) 类似，并且有进度条和支持目录传输。

trzsz-iterm2 是 trzsz 在 iTerm2 上使用的客户端。

安装指南

用 Python3 安装

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

找出 trzsz-iterm2 安装的绝对路径 ( 可以是软链，但不支持相对路径 )。
```
which trzsz-iterm2
```
下文中的 /usr/local/bin/trzsz-iterm2 请自行替换成真实的 trzsz-iterm2 绝对路径。

打开 iTerm2 -> Preferences... / Settings... -> Profiles -> ( 在左边选中一个 Profile ) -> Advanced -> Triggers -> Edit -> [+]，如下配置：

打开 iTerm2 -> Preferences... / Settings... -> General -> Magic，选中 Enable Python API。
设置 ITERM2_COOKIE 环境变量可以使启动速度更快。

打开 iTerm2 -> Preferences... / Settings... -> Advanced，筛选 COOKIE，选择 Yes。

text 进度条示例
升级 iTerm2 到 Build 3.5.20220503-nightly 以上的版本。
Trigger 的 Parameters 配置增加 -p text 参数。
```
/usr/local/bin/trzsz-iterm2 -p text \1
```
注意 /usr/local/bin/trzsz-iterm2 要替换成真实的 trzsz-iterm2 绝对路径。

如果 Mac M1 安装失败，可以试试用 go 进行编译安装：

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

执行 ls -l /usr/local/bin/zenity 应该输出 zenity 可执行文件或软链。不然可以建个软链：
```
sudo ln -sv $(which zenity) /usr/local/bin/zenity
```
如果进度条不是在前面弹出，可以尝试升级 zenity, 并且不要选中 iTerm2 -> Secure Keyboard Entry。

如果你想自动下载文件到指定目录，而不是每次都弹窗询问。

例如，自动下载文件到 /Users/xxxxx/Downloads

使用文本进度条，将 /usr/local/bin/trzsz-iterm2 -p text \1 改为：
```
/usr/local/bin/trzsz-iterm2 -p text -d '/Users/xxxxx/Downloads' \1
```

使用 zenity 进度条，将 /usr/local/bin/trzsz-iterm2 \1 改为：

/usr/local/bin/trzsz-iterm2 -p zenity -d '/Users/xxxxx/Downloads' \1

注意 /usr/local/bin/trzsz-iterm2 要替换成真实的 trzsz-iterm2 绝对路径。

升级 iTerm2 到 Build 3.5.20220806-nightly 以上的版本。
打开 iTerm2 -> Preferences... / Settings... -> Advanced，筛选 files are dropped into，配置如下：
```
/usr/local/bin/trzsz-iterm2 -p text dragfiles \(filenames)
```

注意 /usr/local/bin/trzsz-iterm2 要替换成真实的 trzsz-iterm2 绝对路径。