zyedidia / clipper

Cross-platform clipboard access in Go

Clipper: cross-platform clipboard library

Platforms supported:

• Linux (via xclip or xsel or wl-copy/wl-paste)
• MacOS (via pbcopy/pbpaste)
• Windows (via the Windows clipboard API)
• WSL (via clip.exe/powershell.exe)
• Android Termux (via termux-clipboard-set/termux-clipboard-get)
• Plan9 (via /dev/snarf)
• Anything else (via a user-defined script)

Fallback methods:

• Internal in-memory clipboard
• File-based clipboard

Example

func main() {
    clip, err := clipper.GetClipboard(clipper.Clipboards...)
    must(err)

    // copy from stdin
    data, err := io.ReadAll(os.Stdin)
    must(err)
    err = clip.WriteAll(clipper.RegClipboard, data)
    must(err)

    // paste to stdout
    data, err := clip.ReadAll(clipper.RegClipboard)
    must(err)
    fmt.Print(string(data))
}

A CLI tool is provided as an example in cmd/clipper.

clipper's Issues

unspecific backend detection

Hi and thanks for micro: it is an awesome tool. (only waiting for tree-sitter syntax coloration)

Now to the topic:
my clipboard was acting weird under wayland... and works flawlessly now that I removed xclip.

Problem seems clipper/micro will use xclip if installed... even though presently running under a pure (no xwayland) wayland session.

clipper/xclip.go

Line 11 in 146cd95

return verify(x, "xclip")

I think many clipboard bugs might® be related.

Wayland: freezes up when loading with empty clipboard

When loading an app that uses this (such as micro) on Wayland, if wl-copy and wl-paste are found in the PATH environment variable, and the clipboard is empty, the app will fail to load until something is copied.
once the app is loaded, it will freeze up whenever a clipboard action is done until the clipboard is full.