parcellite(1)

1PARCELLITE(1)               General Commands Manual              PARCELLITE(1)
2
3
4

NAME

6       Parcellite - Lightweight GTK+ Clipboard Manager
7

SYNOPSIS

9       parcellite [OPTION]
10

DESCRIPTION

12       Parcellite  is a lightweight GTK+ clipboard manager. This is a stripped
13       down, basic-features-only clipboard manager with a small  memory  foot‐
14       print for those who like simplicity.
15
16       Parcellite  features a clipboard CLI. Unrecognized options and the con‐
17       tents of your standard input get copied  to  your  clipboard.  See  CLI
18       EXAMPLES.
19
20       Look at the tool tips by hovering over each item in the prefrences dia‐
21       log.
22

OPTIONS

24       -?, --help
25              Show help options
26
27       Parcellite by default runs as daemon. In this mode Parcellite will keep
28       your clipboard
29              and  primary  contents  safe.   It also displays the status Icon
30              (depending on -n) and preferences.
31
32       -n, --no-icon
33              Do not use status icon
34
35       -c, --clipboard
36              Print clipboard contents -p, --primary Print primary contents
37

ACTIONS

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

CLI EXAMPLES

47        echo "copied to clipboard" | parcellite
48        parcellite "copied to clipboard"
49        echo "copied to clipboard" | parcellite -c
50

Hotkeys

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

Preferences

56       Right-click on the parcellite icon in the systray to access the prefer‐
57       ences.
58
59

Behavior Tab

61       Clipboards
62              generally checking all these boxes is appropriate.
63
64       History
65               Check 'Save history' to save history on close.
66               'Position history' - Set the location where history appears. If
67              unchecked, appears where the mouse is.
68               'X' - X location in pixels. 0 is top of screen.
69               'Y' - Y location in pixels. 0 is left of screen.
70
71               'Max Data Size (MB)' - Set Maximum amount of data to  copy  for
72              each entry in MBytes. 0 is no limit.
73
74       Miscellaneous
75               'Search  As  You Type' - If checked, does a search-as-you-type.
76              Turns red if not found. Goes to top (Alt-E) line when  no  chars
77              are entered for search
78
79               'Case  Sensitive  Search'  -  If  checked,  does case sensitive
80              search.
81
82               'Ignore Whitespace Only' - If checked, will  ignore  any  clip‐
83              board additions that contain only whitespace.
84
85               'Trim  Whitespace'  -  If  checked,  will  trim whitespace from
86              beginning and end of entry.
87
88               'Trim Newlines' - If checked, will replace newlines  with  spa‐
89              ces.
90
91

Display Tab

93        'Show in Single line' does nothing.
94
95        'Show  in  reverse  order'  reverses the history so the first entry is
96       last and the last is first.
97
98
99        'Persistent History' Adds a list that  is  permanent  and  never  goes
100       away.
101
102        'Persistent  As  Separate List' Enables the persistent history hotkey,
103       and the persistent history will appear with this key.
104
105        'Persistent On Top' If the  above  option  is  checked,  this  has  no
106       effect.  Otherwise,  if  this  option is checked the Persistent History
107       will appear on the top of the list. Unchecked, it appears on  the  bot‐
108       tom.
109
110        'Paste  All  Entry  Delimiter'  Delimiter to denote start of a history
111       entry.
112
113        'Alternate Non-printing Display' If checked, displays tabs,  newlines,
114       and spaces with alternate characters.
115
116        'Omit  items' refers to omitting characters that don't fit in the his‐
117       tory window width. This is for display only.
118
119        'Multiuser' If checked, enables checking for multiple users.
120
121        'Parcellite Icon Name' Sets the name of the Parcellite icon. This name
122       is  used  by  gnome, which usually looks in /usr/share/pixmaps. See the
123       Open Desktop Spec for more details.
124
125

History Dialog Behavior

127       Use the Ctrl or Shift key in conjunction with right-click.
128
129       If you hold Ctrl, then it toggles the delete on a single item.
130
131       If you hold Shift while holding down right-click (this is like a right-
132       drag), then it toggles each item as it enters the item.
133
134       To complete the delete, hit enter.
135

AUTHOR

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

BUGS

144       Please include your ~/.config/parcellite/parcelliterc file when  filing
145       a bug.  This will give me your preferences.
146        Please report any bugs to the bug tracker via this web page:
147        http://sourceforge.net/projects/parcellite/support
148        Click on 'Bugs' under 'Project Trackers' to file a bug if you are reg‐
149       istered with Source Forge. If not, email rickyrockrat (rickyrockrat  at
150       users.sourceforge.net),  or click the 'project administers' in the link
151       above.
152
153
154
155
156                                 August 7 2011                   PARCELLITE(1)