README.md

trzsz-go

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

Installation

on Ubuntu

Not released yet, please download the latest release from GitHub.

sudo add-apt-repository ppa:trzsz/ppa
sudo apt update
sudo apt install trzsz

on Windows / macOS / Other

Please download the latest release from GitHub.

install from Source Code

git clone https://github.com/trzsz/trzsz-go.git
cd trzsz-go
make
sudo make install

Usage

on Local

Add trzsz before the shell, e.g.:

trzsz tmux
trzsz /bin/bash
trzsz ssh x.x.x.x
trzsz.exe cmd
trzsz.exe ssh x.x.x.x

on Server

Similar to lrzsz ( rz / sz ), command trz to upload files, command tsz /path/to/file to download files.

For more information, see the website of trzsz: https://trzsz.github.io.

Suggestion

• It is recommended to set alias alias ssh="trzsz ssh" for convenience.

• If using tmux on the local computer, run tmux ( without trzsz ) first, then trzsz ssh to login.

Configuration

trzsz looks for configuration at ~/.trzsz.conf. e.g.:

DefaultUploadPath =
DefaultDownloadPath = /Users/username/Downloads/

• If the DefaultUploadPath is not empty, the path will be opened by default while choosing upload files.

• If the DefaultDownloadPath is not empty, downloading files will be saved to the path automatically instead of asking each time.

Trouble shooting

• If using MSYS2 or Git Bash on windows, and getting an error The handle is invalid.

  • Install winpty by pacman -S winpty in MSYS2.
  • Git Bash should have winpty installed, no need to install it manually.
  • Add winpty before trzsz, e.g.: winpty trzsz ssh x.x.x.x.

• /usr/bin/ssh in MSYS2 and Cygwin is not supported yet, use the OpenSSH instead.

  • in MSYS2, e.g.: winpty trzsz /c/Windows/System32/OpenSSH/ssh.exe x.x.x.x.
  • in Cygwin, e.g.: trzsz "C:\Windows\System32\OpenSSH\ssh.exe" x.x.x.x.

Screenshot

Windows

Ubuntu

Contact

Feel free to email me lonnywong@qq.com.