Scroll to navigation

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

NAME

GPaste - A lightweight clipboard manager for the Gnome desktop

SYNOPSIS

gpaste-client [options...] [command [arguments...]]
command | gpaste-client [add | add-password <name> | replace <uuid>]

DESCRIPTION

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

With no command, gpaste-client adds what is piped into it, or displays the history when nothing is. add, add-password and replace take their last argument from what is piped when it is not given. No other command reads what is piped. With no command, --help and --version do not read it either, and neither do the options that change how the history is displayed, which then display it without adding what is piped: --favourites, --oneline, --raw, --reverse, --use-index or --zero.

A command that talks to the daemon refuses any argument, option value or piped text that is not valid UTF-8, file paths included. It starts the daemon when none is running, and waits for it to serve a history -- while it settles its storage, questions to the user included, for up to two minutes -- before it calls it, failing at once on a GPaste 45 or 50 an update left running. Only daemon-reexec and migrate, which have to reach such a daemon, call it without waiting.

Printed on a terminal, an item's control characters show as U+FFFD rather than reach the terminal, which an escape sequence would have act on it; line breaks and tabs stay. Written to a file or a pipe, items are as they are.

COMMANDS

Display the history with indexes
Display the size of the current history
Display the items of the history matching <pattern>, a Perl-compatible regular expression matched whatever the case; a password is matched by its name. Quote what the shell or the expression would read otherwise, as in gpaste-client search 'c++'
Get the name of the current history
Back up <history>, the current one when not given, as <backup>
Switch to the history <name>, starting a new one when there is none
Delete the history <name>, the current one when not given
List available histories
Add the text into the history. Without <text>, the text is everything read from stdin
Add the name / password pair to the history. Without <password>, the password is everything read from stdin bar the one newline ending its line: given as an argument, it would be kept in the shell's history file and shown to every user of the system while the command runs. A store printing more than the password, as pass show does with an entry's other lines, is cut to its first line first: pass show bank | head -n 1 | gpaste-client add-password bank
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. Without <contents>, they are everything read from stdin
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 <name>, the current one when not given
Start tracking clipboard changes
Stop tracking clipboard changes
Upload the item matching <uuid> to a pastebin service, and print the url it landed at; only a text item can be uploaded, any other is refused
Upload the item matching <uuid> to a pastebin service, and print the url it landed at, as upload does, a text item alone; the daemon then puts the url where it can be pasted, as the keyboard shortcut does: in the history, or on the clipboard alone should the history refuse it
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
Check the history folder and every history, and put right what can be: restrict the folder and every folder in it to their owner, and encrypt the histories left under another passphrase with the one the history in use takes, which the daemon asks for theirs to do. Prints what it found and did, and exits with a failure status when anything is left wrong
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

Display the help, as help does
Display the version, as version does
Only display the pinned items, when listing the history or a search
Address items by their index rather than their uuid: their position in the history, starting at zero, as gpaste-client history --use-index displays it, and a search under it beside each match. Every argument naming an item is read as an index then, each of merge's included, while text, names, search patterns, paths and history names keep their usual meaning. An index is an unsigned decimal number and nothing else: one with a sign or a space in front, or anything after its digits, is refused
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, or each history list-histories lists, a history's name being free to hold a line break
Add <string> to the beginning and the end of each item merge joins
Add <string> between each item merge joins