iTerm2-zmodem scripts

中文文档 详细文档

These two shells are work with iTerm2 and rz/sz to allow it upload files to server.

Config steps

• 1.Install lrzsz on your server

  # Debian
  apt install lrzsz
  
  # redhat/centos7
  yum install lrzsz
  
  # centos8
  dnf install lrzsz
  

• 2.Install lrzsz on your macOS

  brew install lrzsz
  

• 3.Download these two scripts to /usr/local/bin/

  wget https://raw.githubusercontent.com/xiebruce/iterm2-zmodem/main/iterm2-rz.sh -O /usr/local/bin/iterm2-rz.sh
  
  wget https://raw.githubusercontent.com/xiebruce/iterm2-zmodem/main/iterm2-sz.sh -O /usr/local/bin/iterm2-sz.sh

• 4.Give executable permission to these two files

  chmod u+x /usr/local/bin/iterm2-*

• 5.Add triggers: iTerm2→Preferences→Profiles→Default(or other profile)→Advanced→Triggers→Edit, add two triggers as the screenshot

  Regular Expression	Action	Parameters	Instant	Enabled
  \*\*B00	Run Silent Coprocess...	/usr/local/bin/iterm2-rz.sh	check	check
  rz waiting to receive.\*\*B0100	Run Silent Coprocess...	/usr/local/bin/iterm2-sz.sh	check	check

  Note that if you add other profile to login to your server, you should add triggers on that profile, every profile keep their own triggers.

• 6.Enable drag&drop upload: iTerm2→Preferences→Advanced→search "dropp" input the following command

  /usr/local/bin/iterm2-sz.sh dragfiles \(filenames)

Usage

Fist login to your server

ssh user@12.34.56.78

Upload files:

• Method 1: on server, type rz, press Enter, wait for a while, choose files you want to upload.
• Method 2: on server, drag a file/folder and drop it to the iTerm2 window(note that you can only drag&drop one file/folder, and you need to update iTerm2 to iTerm2-3_5_20230503-nightly.zip or higher).

Download files: on server, type sz /path/to/file, press Enter, wait for a while, the file will be downloaded to your macOS "Downloads" folder.

# send multi files to you macOS(you can think of it as download file from server)
sz /path/to/file1 /path/to/file2 "/path/to/file name have space"

# send all files under the folder to your macOS
sz /path/to/folder/*

If you want to choose which folder you want to save to, you can add the following environment variable to ~/.bashrc

export CHOOSE_FOLDER=true

Note that no matter you are using zsh or fish or other shell, you should add it to ~/.bashrc, otherwise it will not work.

For more details, see here.