table of contents
other versions
- trixie 45.3-1
- testing 50.8-1
- unstable 51.0-3
- experimental 51.0-2
| 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¶
- gpaste-client [history]
- Display the history with indexes
- gpaste-client history-size
- Display the size of the current history
- gpaste-client search <pattern>
- Display the items of the history matching <pattern>
- gpaste-client get-history
- Get the name of the current history
- gpaste-client backup-history
- Back up the current history
- gpaste-client switch-history
- Switch to another history
- gpaste-client delete-history
- Delete a history
- gpaste-client list-histories
- List available histories
- gpaste-client add <text>
- Add the text into the history
- gpaste-client add-password <name> <password>
- Add the name / password pair to the history
- gpaste-client delete-password <name>
- Delete the password <name>
- gpaste-client make-password <uuid> <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
- gpaste-client get <uuid>
- Get the item matching <uuid> from the history
- gpaste-client select <uuid>
- Put the item matching <uuid> from the history into the clipboard
- gpaste-client replace <uuid> <contents>
- Replace the contents of the item matching <uuid> from the history
with the provided one
- gpaste-client strip-rich-text <uuid>
- 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
- gpaste-client merge [--decoration|-d <string>] [--separator|-s <string>] <uuid> … <uuid>
- 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
- gpaste-client delete <uuid>
- Delete the item matching <uuid> from the history
- gpaste-client favourite <uuid>
- 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.
- gpaste-client unfavourite <uuid>
- 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.
- gpaste-client file <path>
- Put the content of the file at <path> into the clipboard
- command | gpaste-client
- Put the output of the command into the history
- gpaste-client empty
- Empty the history
- gpaste-client start
- Start tracking clipboard changes
- gpaste-client stop
- Stop tracking clipboard changes
- gpaste-client upload <uuid>
- Upload the item matching <uuid> to a pastebin service, and print the
url it landed at
- gpaste-client ui
- Launch the graphical tool
- gpaste-client daemon-reexec
- Re-execute the daemon, for example after upgrading GPaste
- gpaste-client migrate
- Migrate the history to a different storage backend
- gpaste-client change-passphrase
- Change the passphrase of the encrypted history, re-encrypting it with the
new one
- gpaste-client preferences
- Launch the configuration tool
- gpaste-client version
- Display the version
- gpaste-client daemon-version
- Display the daemon version
- gpaste-client help
- Display the help
- gpaste-client about
- Display the about dialog
- gpaste-client show-history
- Make the GNOME Shell extension display the history
OPTIONS¶
- --favourites
- Only display the pinned items, when listing the history or a search
- --use-index
- Use the item index instead of its uuid
- --timeout <seconds>
- 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
- --oneline
- Display each item on one line, without new lines
- --raw
- Display the item raw (without index)
- --reverse
- Display the items in reverse order
- --zero
- Use NUL character instead of new lines between each item