NAME

cclipd - clipboard manager daemon for wayland.

SYNOPSIS

cclipd [OPTIONS...]

DESCRIPTION

cclipd monitors wayland clipboard and saves clipboard contents to database. Saved entries can later be retrieved with cclip(1).

OPTIONS

-d DB_PATH

Path to database file.
Default is $XDG_DATA_HOME/cclip/db.sqlite3, where XDG_DATA_HOME defaults to $HOME/.local/share if it is unset.

-t PATTERN

MIME type pattern to accept. Can be supplied multiple times. Each offered MIME type will be matched against all patterns using fnmatch(3) in the same order they were supplied on command line. First offered MIME type that matches will be accepted (see EXAMPLES for details).
Default is * (accept the first offered MIME type unconditionally).

-s SIZE

Minimal clipboard entry size. Smaller entries will be ignored.
Default is 1 (accept everything).

-c ENTRIES

Maximum number of untagged entries to keep in the database. Oldest untagged entries exceeding this limit are automatically deleted. Tagged entries are never automatically deleted.
Default is 1000.

-P PREVIEW_LEN

Maximum length of generated previews in bytes.
Default is 128.

-p

Also monitor primary selection (disabled by default).

-S

Do not ignore data marked as secret. By default secret data like passwords is ignored.

-e

Exit with error if database doesn't exist instead of creating it.

-v

Increase verbosity of logging.

-h

Print help message and exit 0.

-V

Print version and exit 0.

SIGNALS

cclipd has special handling for the following signals:

SIGINT, SIGTERM

Will cause cclipd to exit cleanly.

SIGUSR1

Will cause cclipd to close and reopen database connection.

EXAMPLES

Try to accept image/png MIME type if available, then try to accept anything that starts with image/, and finally fall back to text/plain;charset=utf-8:

cclipd -t "image/png" -t "image/*" -t "text/plain;charset=utf-8"

Accept only images greater than or equal to 1024 bytes in size and store up to 500 database entries:

cclipd -t "image/*" -s 1024 -c 500

Accept only text from both clipboard and primary selection, saving to ~/.cache/cclip/mydb, with verbose logging:

cclipd -vv -p -t "text/*" -d ~/.cache/cclip/mydb

COMPOSITOR SUPPORT

cclipd uses wlr_data_control_unstable_v1 wayland protocol for clipboard interaction. You can check if your compositor supports wlr_data_control_unstable_v1 here:

https://wayland.app/protocols/wlr-data-control-unstable-v1#compositor-support

SECURITY

Since cclipd stores clipboard data in an unencrypted sqlite database, everyone who has read access to the database file can read its contents. One can delete sensitive data from the database using secure delete option provided by cclip(1).

BUGS

Please report bugs to https://github.com/heather7283/cclip/issues.

When reporting bugs:

• Provide backtrace with symbols if you experience a crash.
• Describe steps necessary to reproduce the issue.

SEE ALSO

cclip(1), wl-clipboard(1)