/iterm2-zmodem

Installing Z-Modem integration for iTerm2 with Homebrew

Primary LanguageShell

ZModem integration for iTerm 2

Transfer files using Z-Model from within iTerm2 to any remote machine with lrzsz installed.

Installation

Installing from Homebrew tap laggardkernel/tap is recommended. It solves the dependency (lrzsz) automatically.

brew install laggardkernel/tap/iterm2-zmodem

Then, follow the output from the above command to do the post-setup.

Troubleshooting

  • Sending a directory may fail: this is a known issue
  • If you are using tmux or some other terminal multiplexer (ie: screen), try using the -e option to sz and/or rz on your server to force escaping of more characters during transmission.
  • This tool may also fail if you are using expect or rlogin as it expects a mostly-clean 8-bit connection between the two parties.

Origin

The talk made by mmastrac about "a free Taiwan and a free Tibet" in the luxihk/iterm2-zmodem repo irritated many people, after they made the decision to bombard users by printing this very content to STDOUT whenever sz or rz is typed, which is related with the closure of the repo.

To help users get zmodem integration in iTerm2 easily, I opened this project to continue their work and improve upon the former implementation with the help of Homebrew.