Scroll to navigation

GPASTE-CLIENT(1) General Commands Manual GPASTE-CLIENT(1)

NAME

GPaste - A lightweight clipboard manager for the Gnome desktop

SYNOPSIS

[command |] gpaste-client [options...]

DESCRIPTION

GPaste is a modular clipboard management system with a fully DBus-based daemon, a CLI client and a gtk+ tray icon.

COMMANDS

Display the history with indexes
Display the size of the current history
Display the items of the history matching <pattern>
Get the name of the current history
Back up the current history
Switch to another history
Delete a history
List available histories
Add the text into the history
Add the name / password pair to the history
Delete the password <name>
Make the item matching <uuid> from the history a password named <name>. Handed the uuid of an item that is already a password, it renames that one instead of creating a second one, and leaves its timeout alone unless --timeout says otherwise
Get the item matching <uuid> from the history
Put the item matching <uuid> from the history into the clipboard
Replace the contents of the item matching <uuid> from the history with the provided one
Drop the rich text flavours of the item matching <uuid>, keeping the plain text it shows
A text item is the only kind this takes: a uris item's special mimes are how a file list is handed over, not another spelling of its text
Editing a text item, or turning one into a password, drops its rich text too
Merge the items matching the uuids from the history and put the result in the clipboard
If foo bar and baz are respectively uuids 5cb227f9-857d-490b-8ea1-f5f33f59f04e b4a7aa02-ef9a-4c29-b951-ebbdb4ed279b and 99da883b-0544-4cb4-92dd-733420a9db6d in history and you run
gpaste-client merge -d '"' -s ',' 5cb227f9-857d-490b-8ea1-f5f33f59f04e b4a7aa02-ef9a-4c29-b951-ebbdb4ed279b 99da883b-0544-4cb4-92dd-733420a9db6d
You will end up with "foo","bar","baz" in your clipboard
Delete the item matching <uuid> from the history
Pin the item matching <uuid>. A pinned item is never dropped automatically: neither the history size limit nor the memory one may evict it, so the history grows past its cap rather than let one go. Emptying or deleting the history, or deleting the item by uuid, still drops it.
Unpin the item matching <uuid>, putting it back under both caps. It may be evicted straight away, if that is what was keeping the history over one of them.
Put the content of the file at <path> into the clipboard
Put the output of the command into the history
Empty the history
Start tracking clipboard changes
Stop tracking clipboard changes
Upload the item matching <uuid> to a pastebin service, and print the url it landed at
Launch the graphical tool
Re-execute the daemon, for example after upgrading GPaste
Migrate the history to a different storage backend
Change the passphrase of the encrypted history, re-encrypting it with the new one
Launch the configuration tool
Display the version
Display the daemon version
Display the help
Display the about dialog
Make the GNOME Shell extension display the history

OPTIONS

Only display the pinned items, when listing the history or a search
Use the item index instead of its uuid
How long a password stays on the clipboard once it is the active item, for add-password and make-password. When it runs out, the next item that is not a password is selected, or the clipboard is emptied if the history holds none. 0 lets a password stay for as long as anything else would, and 65535 is as high as it goes. Without this option, a password already in the history keeps the timeout it carries and the countdown running for it, while one being created takes the password-timeout setting
Display each item on one line, without new lines
Display the item raw (without index)
Display the items in reverse order
Use NUL character instead of new lines between each item