Clipboard Management

Vicinae fully integrates with your system clipboard and includes a powerful clipboard history module.

Environment Support

Clipboard behavior can vary significantly depending on the desktop environment or compositor in use. Below is a table showing which environments Vicinae currently supports.

Introduction

When launched, Vicinae starts a clipboard server that monitors clipboard activity in the current environment.

You can quickly check whether clipboard management is active by opening the clipboard history command.

If the option shows Pause clipboard or Resume clipboard, it means a working clipboard server is currently tracking clipboard activity.

If it displays an error instead, your environment may not be supported, or another issue may have occurred. The logs can help you pinpoint the cause.

Ignored selections

A clipboard selection can be completely ignored in any of the following circumstances:

It contains a vicinae/concealed offer (mostly for internal use)
It contains a special password manager hint offer indicating that the selection is a password. One popular example is x-kde-passwordManagerHint.
It is fully empty (clipboard clear)
The primary offer (the offer that is used to show the data in the history) is empty.

The clipboard history command allows you to tag selections with custom keywords. Simply activate the Edit keywords action (defaults to ctrl+E) on any selection and enter the desired keywords. These tags make it easier to locate a selection later through search.

Encryption

Clipboard history is stored in two locations:

metadata and full text search index is stored in a sqlite database
the data itself is stored on the filesystem

Both are fully encrypted if the "encrypt sensitive data" is enabled, which is ON by default on Windows and macOS.

Eviction policy

You can configure clipboard history so that entries older than a given threshold get automatically evicted. You can also decide to never evict entries that you explicitly tagged or pinned.