1VIS-CLIPBOARD(1)          BSD General Commands Manual         VIS-CLIPBOARD(1)
2

NAME

4     vis-clipboard — Read from or write to the system clipboard
5

SYNOPSIS

7     vis-clipboard --usable
8
9     vis-clipboard --copy [--selection selection]
10
11     vis-clipboard --paste [--selection selection]
12

DESCRIPTION

14     vis-clipboard wraps various system-specific tools for interacting with a
15     system clipboard, like xsel(1) for X11, pbcopy(1) for Mac OS X, and
16     /dev/clipboard on Cygwin.
17
18     vis-clipboard can run in three different ways, depending on the flag
19     given on the command-line.
20
21     --usable
22           In this mode, vis-clipboard looks for a way to interface with the
23           system clipboard.  If it finds one, it terminates with exit code 0.
24           If no interface to the system clipboard is available, it terminates
25           with exit code 1.
26
27     --copy
28           In this mode, vis-clipboard reads the content of standard input,
29           and stores it in the system clipboard.
30
31     --paste
32           In this mode, vis-clipboard reads the content of the system clip‐
33           board, and writes it to standard output.
34
35     --selection selection
36           specify which selection to use, options are "primary" or "clip‐
37           board"
38

ENVIRONMENT

40     The following environment variables affect the operation of
41     vis-clipboard:
42
43     DISPLAY          If non-empty, vis-clipboard will prefer to access the
44                      X11 clipboard even if other options are available.
45

EXIT STATUS

47     The vis-clipboard utility exits 0 on success, and >0 if an error occurs.
48     When run with the --usable flag, an exit status of 0 means that it found
49     a supported system-specific tool, while 1 means that clipboard access is
50     not available.
51

EXAMPLES

53     Test whether clipboard access is available:
54
55           if vis-clipboard --usable; then
56                   echo "Clipboard access available"
57           else
58                   echo "No clipboard"
59           fi
60
61     Copy a friendly greeting to the clipboard:
62
63           echo "Hello, World" | vis-clipboard --copy
64
65     Send the current contents of the system clipboard to be recorded and ana‐
66     lyzed:
67
68           vis-clipboard --paste | curl -d - https://www.nsa.gov/
69

SEE ALSO

71     pbcopy(1), pbpaste(1), vis(1), xclip(1), xsel(1)
72
73Vis v0.7                       November 29, 2016                      Vis v0.7
Impressum