NAME

       Parcellite - Lightweight GTK+ Clipboard Manager

SYNOPSIS

       parcellite [OPTION]

DESCRIPTION

       Parcellite  is  a  lightweight  GTK+  clipboard  manager.  This  is  a stripped down, basic-features-only
       clipboard manager with a small memory footprint for those who like simplicity.

       Parcellite features a clipboard CLI. Unrecognized options and the contents of  your  standard  input  get
       copied to your clipboard. See CLI EXAMPLES.

       Look at the tool tips by hovering over each item in the prefrences dialog.

OPTIONS

       -?, --help
              Show help options

       Parcellite by default runs as daemon. In this mode Parcellite will keep your clipboard
              and primary contents safe.  It also displays the status Icon (depending on -n) and preferences.

       -n, --no-icon
              Do not use status icon

       -c, --clipboard
              Print clipboard contents -p, --primary Print primary contents

ACTIONS

       Parcellite's  actions  perform  commands  using  the  contents  of your clipboard. "%s" in the command is
       replaced with the clipboard contents. Use double quotes "%s"  to  expand  env  variables  like  $HOME  to
       /home/your_name  Use  single  quotes '%s' to feed your action with env variables without shell expansion.
       Use %% if you want a literal %.  See the man page for gnuC printf (man 2 printf) for more information.

CLI EXAMPLES

        echo "copied to clipboard" | parcellite
        parcellite "copied to clipboard"
        echo "copied to clipboard" | parcellite -c

Hotkeys

        The available  hotkey  modifiers  are  <Ctrl>,  <Alt>  <Shift>,  <Release>,  <Meta>,  <Super>,  <Hyper>,
       <Mod[1-5]>

Preferences

       Right-click on the parcellite icon in the systray to access the preferences.

Behavior Tab

       Clipboards
              generally checking all these boxes is appropriate.

       History
               Check 'Save history' to save history on close.
               'Position  history'  -  Set  the  location where history appears. If unchecked, appears where the
              mouse is.
               'X' - X location in pixels. 0 is top of screen.
               'Y' - Y location in pixels. 0 is left of screen.

               'Max Data Size (MB)' - Set Maximum amount of data to copy for each  entry  in  MBytes.  0  is  no
              limit.

       Miscellaneous
               'Search As You Type' - If checked, does a search-as-you-type. Turns red if not found. Goes to top
              (Alt-E) line when no chars are entered for search

               'Case Sensitive Search' - If checked, does case sensitive search.

               'Ignore Whitespace Only' - If checked, will ignore any  clipboard  additions  that  contain  only
              whitespace.

               'Trim Whitespace' - If checked, will trim whitespace from beginning and end of entry.

               'Trim Newlines' - If checked, will replace newlines with spaces.

Display Tab

        'Show in Single line' does nothing.

        'Show in reverse order' reverses the history so the first entry is last and the last is first.

        'Persistent History' Adds a list that is permanent and never goes away.

        'Persistent  As  Separate  List'  Enables the persistent history hotkey, and the persistent history will
       appear with this key.

        'Persistent On Top' If the above option is checked, this has no effect. Otherwise,  if  this  option  is
       checked the Persistent History will appear on the top of the list. Unchecked, it appears on the bottom.

        'Paste All Entry Delimiter' Delimiter to denote start of a history entry.

        'Alternate  Non-printing  Display'  If  checked,  displays  tabs,  newlines,  and  spaces with alternate
       characters.

        'Omit items' refers to omitting characters that don't fit in the  history  window  width.  This  is  for
       display only.

        'Multiuser' If checked, enables checking for multiple users.

        'Parcellite  Icon  Name' Sets the name of the Parcellite icon. This name is used by gnome, which usually
       looks in /usr/share/pixmaps. See the Open Desktop Spec for more details.

History Dialog Behavior

       Use the Ctrl or Shift key in conjunction with right-click.

       If you hold Ctrl, then it toggles the delete on a single item.

       If you hold Shift while holding down right-click (this is like a right-drag), then it toggles  each  item
       as it enters the item.

       To complete the delete, hit enter.

SEE ALSO

       Website: http://parcellite.sourceforge.net

AUTHOR

       Written by Gilberto "Xyhthyx" Miralla <xyhthyx@gmail.com>. Gilberto is no longer maintaining the project.
       'Rickyrockrat' is his replacement.

BUGS

       Please include your ~/.config/parcellite/parcelliterc file when filing a bug.  This  will  give  me  your
       preferences.
        Please report any bugs to the bug tracker via this web page:
        http://sourceforge.net/projects/parcellite/support
        Click  on 'Bugs' under 'Project Trackers' to file a bug if you are registered with Source Forge. If not,
       email rickyrockrat (rickyrockrat at users.sourceforge.net), or click the  'project  administers'  in  the
       link above.

                                                  August 7 2011                                    PARCELLITE(1)