https://github.com/bottlerocketlabs/remote-pbcopy

remote pbcopy over ssh
https://github.com/bottlerocketlabs/remote-pbcopy

Last synced: 14 days ago
JSON representation

remote pbcopy over ssh

• Host: GitHub
• URL: https://github.com/bottlerocketlabs/remote-pbcopy
• Owner: bottlerocketlabs
• License: mit
• Fork: true (skaji/remote-pbcopy-iterm2)
• Created: 2020-02-12T09:54:30.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2024-03-24T22:11:59.000Z (8 months ago)
• Last Synced: 2024-08-01T16:38:56.130Z (3 months ago)
• Language: Go
• Homepage:
• Size: 426 KB
• Stars: 17
• Watchers: 1
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# remote pbcopy for use over ssh

`pbcopy` is a well-known macOS tool that copies data to the clipboard.

It's very useful, but available only in your local machine, not in remote machines.

Fortunately, with OSC52 escape sequence,

we can access the local machine clipboard via a remote machine.

I prepared a simple tool that is `rpbcopy` for remote machines.

## Install

Copy `rpbcopy` to a directory where `$PATH` is set.

       [local]  $ ssh remote

       [remote] $ wget -O rpbcopy-linux-amd64.tar.gz https://github.com/bottlerocketlabs/remote-pbcopy/releases/latest/download/rpbcopy-linux-amd64.tar.gz

       [remote] $ tar xf rpbcopy-linux-amd64.tar.gz

       [remote] $ mv rpbcopy /path/to/bin/

### iTerm2

Features required are not enabled by default

1. First, make sure you use iTerm2 version 3.0.0 or later

2. Check "Applications in terminal may access clipboard" in iTerm2 Preferences:

    ![preferences.png](https://raw.githubusercontent.com/bottlerocketlabs/remote-pbcopy/master/misc/preferences.png)

## Usage

Just like the normal `pbcopy`:

    [local]  $ ssh remote

    [remote] $ date | rpbcopy

    [remote] $ exit

    [local]  $ pbpaste

    Sun Jan 18 20:28:03 JST 2015

## How about `pbpaste`?

Currently most terminals do not allow OSC 52 read access for security reasons.

But we can just use command+V key to paste content from clipboard.

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 indicats EOF

## Tested with

* [iTerm2](https://iterm2.com/)

* [Alacritty](https://github.com/alacritty/alacritty)

* [abduco](http://www.brain-dump.org/projects/abduco/)

* [neovim terminal](https://neovim.io/doc/user/nvim_terminal_emulator.html)

## See also

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

* https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-Operating-System-Commands

* https://github.com/fcpg/vim-osc52

## Author

[Shoichi Kaji](https://github.com/skaji/)

## Contributors

* Stuart Warren

## License

MIT