Cliptoo

Advanced clipboard manager for Linux KDE. Use your clip history as a library of things. Small footprint, fast performance.

Features

Performance

• Persistent History: SQLite FTS5 search with prefix matching.
• Fast Search: Real-time filtering with match highlighting.
• Virtualized Scrolling: only visible rows are rendered.
• Deduplication: SHA-256 hashing skips repeat copies.

Clipboard & Paste

• Capture: text, rich text, HTML, images, and file paths.
• Paste: Enter pastes via an evdev virtual keyboard; optional plain-text mode.
• Global Hotkey: toggle the window via keyboard shortcut (default Ctrl+Alt+Q).
• Quick Paste: hold Right Alt and press 1–9.

Content

• Filters: text, links, images, colors, bookmarks, ++.
• Images: hover previews for all common image formats.
• QR codes: decode QR images via right-click; copy the text or open the URL.
• Colors: displays color swatch for all CSS formats.
• URLs and Files: fetched titles and favicons; file size, mtime, and type.
• Tags: ##-prefixed search.
• Code: monospace view toggle for code clips.

Organization & Tools

• Bookmarks: exempt from auto-cleanup.
• Multi-select: Ctrl+click, Shift+click, Ctrl+A to select; Delete to remove (double click safeguard).
• Merge: multi-select then Ctrl+M (or right-click → Merge Selected) joins into one clip.
• Reordering: move clips up/down or top/bottom.
• Transforms: upper, lower, camel, kebab, snake, trim, timestamp, ++.
• Send To / Compare: specify external apps or a diff tool.

Storage & Maintenance

• Cleanup: prune by age and/or count, clear caches, remove dead file clips, reclassify.
• Backup: JSON export/import, full history or bookmarks only.
• Statistics: DB size, clip count, copy/paste counts.

Customisation

• Light/Dark/System theme, accent color, fonts, row padding, hover-preview delay and size.

System Integration

• Tray and autostart.
• App blacklist: ignore selected applications.

---

Install

Download GitHub Latest Release:

Platform	Format	Install
Linux	AppImage	chmod +x cliptoo-*-x86_64.AppImage && ./cliptoo-*-x86_64.AppImage
Debian / Ubuntu	.deb	sudo apt install ./cliptoo_*_amd64.deb
Fedora / RHEL	.rpm	sudo dnf install ./cliptoo-*.x86_64.rpm
Arch / CachyOS	.pkg.tar.zst	sudo pacman -U cliptoo-*.pkg.tar.zst
Arch / CachyOS	PKGBUILD (local build)	make package && sudo pacman -U .pkg/cliptoo-*.pkg.tar.zst
Any	source	make install (installs to /usr/local; see requirements)

Note

The AppImage adds itself to the application menu, installs its icon, and repoints the entry when you move or rename it.

---

Development

Tech Stack

Component	Technology
Language	Rust 2024
UI	Slint, Qt 6 backend
Clipboard	wl-clipboard-rs, wayland-client, wlr/ext data-control
Storage	SQLite + FTS5 (rusqlite)
Runtime	Tokio
Images	image, resvg, jxl-oxide, rqrr
Colour	palette
D-Bus / portals	ashpd, zbus
Tray / input	Slint SystemTrayIcon, evdev
HTTP	reqwest (rustls)

Data lives in ~/.local/share/Cliptoo/ (DB, images), config in ~/.config/Cliptoo/, cache in ~/.cache/Cliptoo/, logs in ~/.local/state/Cliptoo/Logs/.

Requirements

Wayland with KDE Plasma 6. xdg-desktop-portal-kde provides the global hotkey portal and ships with Plasma.

Building needs Rust stable (2024 edition, rustup) plus the Qt 6, Wayland, xkbcommon, fontconfig, and dav1d development headers, clang, and mold:

Distro	Command
Debian/Ubuntu	sudo apt install qt6-base-dev qt6-wayland libwayland-dev libxkbcommon-dev libfontconfig1-dev libdav1d-dev pkg-config clang mold
Fedora	sudo dnf install qt6-qtbase-devel qt6-qtwayland libwayland-devel libxkbcommon-devel fontconfig-devel dav1d-devel clang mold pkgconfig
Arch	sudo pacman -S qt6-base qt6-wayland wayland wayland-protocols libxkbcommon fontconfig dav1d clang mold pkgconf

Local builds must use those linkers: set linker = "clang" and rustflags = ["-C", "link-arg=-fuse-ld=mold"] under [target.x86_64-unknown-linux-gnu] in ~/.cargo/config.toml. CI passes the same values through CARGO_TARGET_*.

Build & Run

git clone https://github.com/dcog989/cliptoo.git && cd cliptoo

cargo install cargo-edit cargo-outdated cargo-sweep   # optional

cargo run                              # debug build and run
cargo test --workspace
cargo clippy --workspace --all-targets -- -D warnings
cargo fmt --all -- --check
cargo fmt --all                        # apply formatting
slint-lsp format -i src/ui/ui/*.slint
make translations                      # rebuild PO catalogs from @tr()

cargo outdated -w
cargo upgrade && cargo update --verbose
cargo sweep --time 14
cargo clean

bun install                            # website build tools
bun run website                        # live site rendered from README.md
bun run website:build                  # static site in website/dist

Release

Releases use Cocogitto (cargo install cocogitto / sudo pacman -S cocogitto) and Conventional Commits, configured in cog.toml.

cog bump --auto               # bump version, sync manifests, write `CHANGELOG.md`, commit, tag, push
cog bump --version 1.23.4     # manual version
cog changelog                 # changelog preview

---

License

GNU General Public License v3.0.