PARCELLITE(1)

📦
version 1.2.6 · 2 versions
, in debian bookworm, fedora 43, fedora 44, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 NAME 💖

okay bestie, gather round — this is the manual for parcellite, aka Parcellite — Lightweight GTK+ Clipboard Manager. yes the name is in the title and yes it's also the name of the command. slay. 💅

🌸 SYNOPSIS 🌸

parcellite [OPTION]

✨ DESCRIPTION ✨

So Parcellite is a lightweight GTK+ clipboard manager. Think of it as the stripped-down, basic-features-only clipboard bestie with a tiny memory footprint, made for the girlies who just want simplicity and no drama. 🎀

But here's the iconic part: Parcellite has a clipboard CLI. Any unrecognized options AND the contents of your standard input get copied straight to your clipboard. fr fr. Peep the CLI EXAMPLES if you don't believe me. 👀

Also: hover over each item in the preferences dialog to see the tool tips. little treats everywhere. ✨

👑 OPTIONS 👑

  • -?, --help — shows the help options. classic.

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

  • -n, --no-icon — do not use the status icon. bye icon 🫶
  • -c, --clipboard — print clipboard contents
  • -p, --primary — print primary contents

🎀 ACTIONS 🎀

Parcellite's actions run commands using the contents of your clipboard. The "%s" in the command gets replaced with the clipboard contents. periodt. 💅

  • 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 %

Want more lore? See the man page for gnuC printf (man 2 printf). iykyk. 📖

🦋 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. that's the whole vibe check.

Behavior Tab

Clipboards

generally checking all these boxes is appropriate. no notes. 💅

History

  • Check Save history to save history on close.
  • Position history — set the location where history appears. If unchecked, it 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 the 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 the 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 the beginning and end of entry.
  • Trim Newlines — if checked, will replace newlines with spaces.

Display Tab

  • Show in Single line does nothing. literally nothing. iconique. 💀
  • 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 the 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. passing the torch, we love to see it. 🫶

💀 BUGS 💀

Please include your ~/.config/parcellite/parcelliterc file when filing a bug. This will give me your preferences. bestie they just want to know your settings, don't be shy. 🙈

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.

and that's the whole page, bestie 💖 this was the Parcellite manual, version 1, dated August 7 2011. go forth and manage those clipboards, you absolute icon. ✨🎀🦋

📦 where this page comes from