vis-clipboard — Read from or write to the system clipboard
Contents
Description
vis-clipboard wraps various system-specific tools for interacting with a system clipboard, like xsel(1) for X11, pbcopy(1) for Mac OS X, and /dev/clipboard on Cygwin. vis-clipboard can run in three different ways, depending on the flag given on the command-line. --usable In this mode, vis-clipboard looks for a way to interface with the system clipboard. If it finds one, it terminates with exit code 0. If no interface to the system clipboard is available, it terminates with exit code 1. --copy In this mode, vis-clipboard reads the content of standard input, and stores it in the system clipboard. --paste In this mode, vis-clipboard reads the content of the system clipboard, and writes it to standard output. --selectionselection specify which selection to use, options are "primary" or "clipboard". Silently ignored on platforms with a single clipboard.
Environment
The following environment variables affect the operation of vis-clipboard:
DISPLAY If non-empty, vis-clipboard will prefer to access the X11 clipboard even if other
options are available.
Examples
Test whether clipboard access is available:
if vis-clipboard --usable; then
echo "Clipboard access available"
else
echo "No clipboard"
fi
Copy a friendly greeting to the clipboard:
echo "Hello, World" | vis-clipboard --copy
Send the current contents of the system clipboard to be recorded and analyzed:
vis-clipboard --paste | curl -d - https://www.nsa.gov/
Exit Status
The vis-clipboard utility exits 0 on success, and >0 if an error occurs. When run with the --usable
flag, an exit status of 0 means that it found a supported system-specific tool, while 1 means that
clipboard access is not available.
Name
vis-clipboard — Read from or write to the system clipboard
See Also
pbcopy(1), pbpaste(1), vis(1), xclip(1), xsel(1) Vis 0.9 November 29, 2016 VIS-CLIPBOARD(1)
Synopsis
vis-clipboard--usablevis-clipboard--copy [--selectionselection]
vis-clipboard--paste [--selectionselection]
