trzsz

A simple file transfer tools, similar to rz/sz but compatible with tmux (control mode), which works with iTerm2 and has a nice progress bar.

Why?

I love to use iTerm2 integrating with tmux to manage terminal sessions.

Sometimes, I need to transfer some files between my laptop and the remote server.

Considering laptop --> hostA --> hostB --> docker --> tmux , using scp to transfer files is inconvenience.

Tmux is not going to support rz/sz ( 906, 1439 ), and I found out that creating a new file transfer tools is much easier than patching tmux.

Additionally, iTerm2-zmodem is not supporting a progress bar. Is there something wrong happened or just need more time?

Requirements

• Python
  • Python’s standard library is good enough.
• iTerm2
  • Tmux Integration and Coprocesses are so cool.
  • btw without tmux works too.
• zenity
  • Optional for a nice progress bar.

Installation

Server side

• Install trzsz-svr
  • python3 -m pip install --upgrade trzsz-svr

Client side

• Install trzsz-iterm2

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

• Install iTerm2 and create a Trigger as follows.

  Name	Value
  Regular Expression	:(:TRZSZ:TRANSFER:[SR]:\d+\.\d+\.\d+)
  Actions	Run Silent Coprocess
  Parameters	/usr/local/bin/trzsz-iterm2 \1
  Enabled	✅

  

• Optional install zenity for a nice progress bar.

  • should be placed at /usr/local/bin/zenity

Manual

• trz upload files to remote server

  usage: trz [-h] [-v] [path]
  
  Receive file(s), similar to rz but compatible with tmux (control mode).
  
  positional arguments:
    path           Path to save file(s). (default: current directory)
  
  optional arguments:
    -h, --help     show this help message and exit
    -v, --version  show program's version number and exit
  

• tsz download files from remote server

  usage: tsz [-h] [-v] file [file ...]
  
  Send file(s), similar to sz but compatible with tmux (control mode).
  
  positional arguments:
    file           File(s) to be sent.
  
  optional arguments:
    -h, --help     show this help message and exit
    -v, --version  show program's version number and exit
  

Screenshot

• Upload files to remote server.

  

• Download files from remote server.

  

Contact

Feel free to email me [email protected] (same as my PayPal account, just in case you want to deduct?).

GitHub

View Github