trzsz-iterm2 1.0.0

trzsz is a simple file transfer tools, similar to lrzsz ( rz / sz ) and compatible with tmux, which works with iTerm2 and has a nice progress bar.

trzsz-iterm2

trzsz ( trz / tsz ) is a simple file transfer tools, similar to lrzsz ( rz / sz ), and compatible with tmux.

trzsz-iterm2 is a client tool for trzsz used with iTerm2.

Installation

• With Python3

  sudo python3 -m pip install trzsz-iterm2
  

• With Homebrew

  brew install trzsz
  

Configuration

• Find out the absolute path where trzsz-iterm2 is installed.

  which trzsz-iterm2
  

  Change the /usr/local/bin/trzsz-iterm2 below to the real absolute path of trzsz-iterm2.

• Open iTerm2 -> Preferences... -> Profiles -> (select a profile on the left) -> Advanced -> Triggers -> Edit -> [+]

  Name	Value	Note
  Regular Expression	:(:TRZSZ:TRANSFER:[SR]:\d+\.\d+\.\d+:\d+)	No space at the end
  Action	Run Silent Coprocess...
  Parameters	/usr/local/bin/trzsz-iterm2 \1	No space at the end
  Enabled	✅	Checked

  • Don't check the Use interpolated strings for parameters at the bottom.

  • The /usr/local/bin/trzsz-iterm2 should be changed to the real absolute path of trzsz-iterm2.

  • Note that the Triggers should be configured for each Profile in use.

  • Triggers allows multiple lines, but only shows one line. Make sure don't copy a newline into it.

  

Progress Bar

Option 1: The zenity progress bar

• Install zenity

  brew install ncruces/tap/zenity
  

• If Mac M1 install fails, try to install it with 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 should shows the zenity executable file or link. If not, create a soft link:

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

Option 2: The cooler text progress bar

Under development...

• Upgrade iTerm2 to Build 3.4.16 ( not release yet ) or higher

• Add -p text to the parameters of iTerm2 Trigger.

  /usr/local/bin/trzsz-iterm2 -p text \1
  

  Don't forget to change /usr/local/bin/trzsz-iterm2 to the real absolute path of trzsz-iterm2.

• Open iTerm2 -> Preferences... -> General -> Magic, check Enabel Python API.