1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
|
# osc
A command line tool to access the system clipboard from anywhere using the [ANSI OSC52](https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h3-Operating-System-Commands) sequence.
System clipboard access includes writing (i.e. copy) and reading (i.e. paste), even while logged into a remote machine via ssh.
## Examples
```
❯ echo asdf | osc copy
# String 'asdf' copied to clipboard
❯ osc paste
asdf
```
## Usage
```
Reads or writes the system clipboard using the ANSI OSC52 escape sequence.
Usage:
osc [command]
Available Commands:
completion Generate the autocompletion script for the specified shell
copy Copies input to the system clipboard
help Help about any command
paste Outputs system clipboard contents to stdout
version Outputs version information
Flags:
-d, --device string select device
-h, --help help for osc
-l, --log string write logs to file
-v, --verbose verbose logging
Use "osc [command] --help" for more information about a command.
```
## Compatibility
OSC52 is overall [widely supported](https://github.com/ojroques/vim-oscyank/blob/main/README.md#vim-oscyank), but clipboard read operation is less widely supported than write.
Terminal | Terminal OS | Shell OS | Copy | Paste | Notes
--- | --- | --- | --- | --- | ---
[alacritty](https://github.com/alacritty/alacritty) 0.13.1 | macOS | linux | ✓ | ✓ | Paste support requires [setting](https://alacritty.org/config-alacritty.html) `terminal.osc52` to `CopyPaste` or `OnlyPaste`
[alacritty](https://github.com/alacritty/alacritty) 0.13.1 | macOS | macOS | ✓ | ✓ | Paste support requires [setting](https://alacritty.org/config-alacritty.html) `terminal.osc52` to `CopyPaste` or `OnlyPaste`
[alacritty](https://github.com/alacritty/alacritty) 0.12.1 | Windows | linux | ✓ | ✗ |
[kitty](https://github.com/kovidgoyal/kitty) 0.29.0 | macOS | linux | ✓ | ✓ | Prompts for access
[kitty](https://github.com/kovidgoyal/kitty) 0.29.0 | macOS | macOS | ✓ | ✓ | Prompts for access
[windows terminal](https://github.com/microsoft/terminal) v1.17.11461.0 | Windows | linux | ✓ | ✗ |
[iterm2](https://iterm2.com/) | macOS | linux | ✓ | ✓ | Paste requires version 3.5.0 (currently beta). Prompts for access.
[iterm2](https://iterm2.com/) | macOS | macOS | ✓ | ✓ | Paste requires version 3.5.0 (currently beta). Prompts for access.
[hterm](https://chrome.google.com/webstore/detail/secure-shell/iodihamcpbpeioajjeobimgagajmlibd) | ChromeOS | linux | ✓ | ✗ |
#### Terminal Multiplexer support
Using [alacritty](https://github.com/alacritty/alacritty) as the terminal,
default configuration options for multiplexer:
Terminal Multiplexer | Copy | Paste | Notes
--- | --- | --- | ---
[screen](https://www.gnu.org/software/screen/) 4.09.00 | ✓ | ✓ |
[zellij](https://zellij.dev/) 0.37.2 | ✓ | [✗](https://github.com/zellij-org/zellij/issues/2647) |
[tmux](https://github.com/tmux/tmux) 3.3 | ✓ | ✓ | [`allow-passthrough` should be enabled](https://github.com/tmux/tmux/wiki/FAQ#what-is-the-passthrough-escape-sequence-and-how-do-i-use-it)
## Installation
```
go install -v github.com/theimpostor/osc@latest
```
This will install the latest version of osc to `$GOPATH/bin`. To find out where `$GOPATH` is, run `go env GOPATH`
## TODO
- [ ] [copy] check is stdin is readable
## For neovim
- set init.lua
```lua
vim.cmd([[
let g:clipboard = {
\ 'name': 'osc-copy',
\ 'copy': {
\ '+': 'osc copy',
\ '*': 'osc copy',
\ },
\ 'paste': {
\ '+': 'osc paste',
\ '*': 'osc paste',
\ },
\ 'cache_enabled': 0,
\ }
]])
```
## Credits
- [ojroques/vim-ocsyank](https://github.com/ojroques/vim-oscyank) - inspiration and introduction to OSC52
- [rumpelsepp/oscclip](https://github.com/rumpelsepp/oscclip) - working python implementation
- [gdamore/tcell](https://github.com/gdamore/tcell) - terminal handling
|
