PARCELLITE(1) General Commands Manual PARCELLITE(1)

Parcellite - Lightweight GTK+ Clipboard Manager

parcellite [OPTION]

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.

-?, --help
Show help options
and primary contents safe. It also displays the status Icon (depending on -n) and preferences.
Do not use status icon
Print clipboard contents
Print primary contents

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.


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


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

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

generally checking all these boxes is appropriate.

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.


'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.


'Capture hyperlinks only' - If checked will only save http, ftp://, etc.


'Confirm before clearing history' - If checked, will pop up a confirmation box when clearing history.


'Disable clearing history' - prevents history from accidentally being cleared.


'Use Line Number prefix when saving history' - If checked adds a N0000 or P0000 for normal/persistent history, where 0000 is the line number.


'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.

'Running Unity' - Check this box if you are running Unity.

'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.

Website: http://parcellite.sourceforge.net

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

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