https://github.com/robberphex/iterm2-zmodem

Automatic ZModem support for iTerm 2
https://github.com/robberphex/iterm2-zmodem

Last synced: 11 days ago
JSON representation

Automatic ZModem support for iTerm 2

• Host: GitHub
• URL: https://github.com/robberphex/iterm2-zmodem
• Owner: robberphex
• License: gpl-3.0
• Created: 2019-08-12T16:10:51.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2022-10-10T09:34:31.000Z (about 2 years ago)
• Last Synced: 2024-10-14T17:22:48.494Z (24 days ago)
• Language: Shell
• Size: 22.5 KB
• Stars: 177
• Watchers: 7
• Forks: 80
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
ZModem integration for iTerm 2

------------------------------

This script can be used to automate ZModem transfers from your OSX desktop to a server that can run `lrzsz` (in theory, any machine 

that supports SSH), and vice-versa.

The minimum supported iTerm2 version is 1.0.0.20120108

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.

Setup

-----

0. Install lrzsz on OSX: `brew install lrzsz`

1. Save the `iterm2-send-zmodem.sh` and `iterm2-recv-zmodem.sh` scripts in `/usr/local/bin/`

2. Set up Triggers in iTerm 2 like so:

[How to Create a Trigger](https://www.iterm2.com/documentation-triggers.html)


    Regular expression: rz waiting to receive.\*\*B0100

    Action: Run Silent Coprocess

    Parameters: /usr/local/bin/iterm2-send-zmodem.sh

    Instant: checked


    Regular expression: \*\*B00000000000000

    Action: Run Silent Coprocess

    Parameters: /usr/local/bin/iterm2-recv-zmodem.sh

    Instant: checked



To send a file to a remote machine:

1. Type `rz` on the remote machine

2. Select the file(s) on the local machine to send

3. Wait for the coprocess indicator to disappear

The receive a file from a remote machine

1. Type `sz filename1 filename2 … filenameN` on the remote machine

2. Select the folder to receive to on the local machine

3. Wait for the coprocess indicator to disappear

Future plans (patches welcome)

 - Visual progress bar indicator