NAME

       xclip - command line interface to X selections (clipboard)

SYNOPSIS

       xclip [OPTION] [FILE]...

DESCRIPTION

       Reads  from  standard  in, or from one or more files, and makes the data available as an X
       selection for pasting into X applications. Prints current X selection to standard out.

       -i, -in
              read text into X selection from standard input or files (default)

       -o, -out
              print the selection to standard out (generally for piping to a file or program)

       -f, -filter
              when xclip is invoked in  the  in  mode  with  output  level  set  to  silent  (the
              defaults),  the  filter option will cause xclip to print the text piped to standard
              in back to standard out unmodified

       -r, -rmlastnl
              when the last character of the selection is a newline character, remove it. Newline
              characters  that  are  not the last character in the selection are not affected. If
              the selection does not end with a newline character, this  option  has  no  effect.
              This  option  is  useful  for  copying  one-line output of programs like pwd to the
              clipboard to paste it again into the command  prompt  without  executing  the  line
              immediately due to the newline character pwd appends.

       -l, -loops
              number  of  X  selection  requests  (pastes into X applications) to wait for before
              exiting, with a value of 0 (default) causing xclip to wait for an unlimited  number
              of  requests until another application (possibly another invocation of xclip) takes
              ownership of the selection

       -t, -target
              specify a particular data format using the given target atom.  With -o the  special
              target atom name "TARGETS" can be used to get a list of valid target atoms for this
              selection.  For more information about target atoms refer to ICCCM section 2.6.2

       -d, -display
              X display to use (e.g. "localhost:0"), xclip defaults to the value in  $DISPLAY  if
              this option is omitted

       -h, -help
              show quick summary of options

       -selection
              specify  which  X  selection  to  use,  options  are  "primary"  to  use XA_PRIMARY
              (default), "secondary" for XA_SECONDARY or "clipboard" for XA_CLIPBOARD

       -version
              show version information

       -silent
              fork into the background to wait for requests, no informational output, errors only
              (default)

       -quiet show informational messages on the terminal and run in the foreground

       -verbose
              provide a running commentary of what xclip is doing

       -noutf8
              operate  in  legacy  (i.e.  non  UTF-8)  mode for backwards compatibility (Use this
              option only when really necessary, as the old behavior was broken)

       xclip reads text from standard in or files and makes it available to other X  applications
       for  pasting as an X selection (traditionally with the middle mouse button). It reads from
       all files specified, or from standard in if no files are specified. xclip can  also  print
       the contents of a selection to standard out with the -o option.

       xclip  was  designed  to  allow  tighter  integration  of  X applications and command line
       programs. The default action is to  silently  wait  in  the  background  for  X  selection
       requests (pastes) until another X application places data in the clipboard, at which point
       xclip exits silently. You can use the -verbose option to see if and  when  xclip  actually
       receives selection requests from other X applications.

       Options can be abbreviated as long as they remain unambiguous. For example, it is possible
       to use -d or -disp instead of -display.  However,  -v  couldn't  be  used  because  it  is
       ambiguous  (it  could  be short for -verbose or -version), so it would be interpreted as a
       filename.

       Note that only the first character of the selection specified with the  -selection  option
       is  important.  This  means that "p", "sec" and "clip" would have the same effect as using
       "primary", "secondary" or "clipboard" respectively.

EXAMPLES

       I hate man pages without examples!

       uptime | xclip

       Put your uptime in the X selection. Then middle click in an X application to paste.

       xclip -loops 10 -verbose /etc/motd

       Exit after /etc/motd (message of the  day)  has  been  pasted  10  times.  Show  how  many
       selection requests (pastes) have been processed.

       xclip -o > helloworld.c

       Put the contents of the selection into a file.

       xclip -t text/html index.html

       Middle  click  in an X application supporting HTML to paste the contents of the given file
       as HTML.

ENVIRONMENT

       DISPLAY
              X display to use if none is specified with the -display option.

REPORTING BUGS

       Please report any bugs, problems, queries, experiences, etc. directly to the author.

AUTHORS

       Kim Saunders <kims@debian.org> Peter Åstrand <astrand@lysator.liu.se>

                                                                                         XCLIP(1)