Cliphoard

Local, keyboard-first clipboard history for Linux/X11. History is encrypted with SQLCipher and unlocked with a passphrase that Cliphoard does not store.

Install a .deb

Install the package on Debian, Ubuntu, or Mint:

sudo apt install ./cliphoard_1.0.0_amd64.deb

The package installs the cliphoard command, desktop launcher, tray icon, autostart entry, and a copy of this README at /usr/share/doc/cliphoard/README.md. Start it from the desktop menu, tray, or with cliphoard. On first start, enter a passphrase. An older plaintext database is migrated only after confirmation; Cliphoard then offers to remove its retained backup.

Build from source

Run this from the repository root:

sudo apt update
sudo apt install cargo rustc dpkg-dev libgtk-4-dev libdbus-1-dev libx11-dev libxfixes-dev libxtst-dev pkg-config
cargo test --locked --all-features
cargo build --release --locked --features gui
packaging/build-deb.sh
sudo apt install ./target/cliphoard_1.0.0_amd64.deb

An isolated Docker build produces the same package:

docker build -t cliphoard-builder .
docker run --rm -v "$PWD/target:/out" cliphoard-builder

Use

  • Ctrl+Alt+V opens or hides the popup.
  • Ctrl+Alt+R pauses or resumes recording.
  • Enter copies; Ctrl+Enter pastes; Escape hides the popup.
  • Double-click an entry to inspect its full contents.
  • The tray menu opens the popup or quits Cliphoard completely.

Remove or disable autostart

Remove the package and its system autostart entry:

sudo apt remove cliphoard

If it was installed with dpkg and apt cannot find it:

sudo dpkg -r cliphoard

Keep Cliphoard installed but disable autostart for your user:

mkdir -p ~/.config/autostart
printf '%s\n' '[Desktop Entry]' 'Hidden=true' > ~/.config/autostart/io.cliphoard.Cliphoard.desktop

Delete local history, configuration, logs, and migration backups after quitting:

rm -rf ~/.local/share/cliphoard ~/.config/cliphoard ~/.local/state/cliphoard

The last command is permanent. Backups and filesystem snapshots are outside Cliphoard’s control.

Runtime paths are ~/.local/share/cliphoard/cliphoard.db, ~/.config/cliphoard/config.toml, and ~/.local/state/cliphoard/.

Description
No description provided
Readme 305 KiB
2026-09-27 19:20:01 +00:00
Languages
Rust 99%
Shell 0.7%
Dockerfile 0.3%