pbcopy is a well-known macOS tool that copies data to the clipboard.
It's very useful, but it only works with the clipboard on your local machine.
Fortunately, with the OSC 52 escape sequence, we can access the local machine's clipboard from a remote machine.
I prepared a simple tool that works like pbcopy for remote machines.
It works with iTerm2, Ghostty,
Rex, and Herdr,
including sessions inside tmux and
GNU screen.
-
Use iTerm2, Ghostty, Rex, or Herdr.
-
Copy a preferred
pbcopyto a directory where$PATHis set.[local] $ ssh remote # If you prefer a self-contained binary, then [remote] $ curl -fsSLo pbcopy-linux-amd64.tar.gz https://github.com/skaji/remote-pbcopy/releases/latest/download/pbcopy-linux-amd64.tar.gz [remote] $ tar xf pbcopy-linux-amd64.tar.gz [remote] $ mv pbcopy /path/to/bin/ # If you prefer a perl script, then [remote] $ curl -fsSLo pbcopy https://raw.githubusercontent.com/skaji/remote-pbcopy/main/pbcopy [remote] $ chmod +x pbcopy [remote] $ mv pbcopy /path/to/bin/ # If you prefer a python script, then [remote] $ curl -fsSLo pbcopy https://raw.githubusercontent.com/skaji/remote-pbcopy/main/pbcopy.py [remote] $ chmod +x pbcopy [remote] $ mv pbcopy /path/to/bin/
iTerm2 and tmux require additional configuration:
-
iTerm2: Enable Settings → General → Selection → Applications in terminal may access clipboard.
-
tmux: Add the following to
~/.tmux.conf:set -g allow-passthrough on
Just like the normal pbcopy:
[local] $ ssh remote
[remote] $ date | pbcopy
[remote] $ exit
[local] $ pbpaste
Sun Jan 18 20:28:03 JST 2015
Input trailing newlines are removed before copying.
This tool writes to the clipboard; it does not implement pbpaste.
Use Command+V to paste text from the clipboard into the remote terminal.
If you want to save the content of clipboard to a remote file, try this:
[remote] cat > out.txt
# press command+V to paste content of clipboard,
# and press control+D which indicates EOF
For OSC52
- http://doda.b.sourceforge.jp/2011/12/15/tmux-set-clipboard/
- http://qiita.com/kefir_/items/1f635fe66b778932e278
- http://qiita.com/kefir_/items/515ed5264fce40dec522
- https://chromium.googlesource.com/apps/libapps/+/HEAD/hterm/etc/osc52.vim
- https://chromium.googlesource.com/apps/libapps/+/HEAD/hterm/etc/osc52.el
- https://chromium.googlesource.com/apps/libapps/+/HEAD/hterm/etc/osc52.sh
Shoichi Kaji
MIT
