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