Vitra documentation
Vitra is a fast, local clipboard manager under active pre-alpha development. It combines a lightweight Rust agent for always-running work with an on-demand PySide6 and Qt Quick interface for browsing and acting on clipboard history.
Vitra is not production-ready. The current development target is Ubuntu with GNOME Shell 50 on Wayland. Do not interpret the cross-platform architecture as current Windows, macOS, or general Linux support.
Ubuntu-first by design
Ubuntu is the first complete platform implementation, not a temporary generic Linux skin. It provides a focused environment for proving secure history, Wayland clipboard capture, desktop shortcuts, lifecycle integration, and a UI that belongs on its host desktop.
Windows and macOS remain first-class future targets. Expansion is intended to use native clipboard, credential-store, startup, shortcut, tray, packaging, and visual integration on each operating system. The goal is a genuinely native feel per platform rather than identical behavior forced through one lowest-common-denominator adapter.
Working vertical slice
The current Ubuntu GNOME implementation provides:
- a
systemd --userRust agent; - text capture through a GNOME Shell 50 extension on Wayland;
- authenticated, bounded local IPC;
- validation and duplicate suppression;
- XChaCha20-Poly1305 encrypted SQLite history;
- a 256-bit history key stored through the operating system credential store;
- configurable retention from 1–100,000 unpinned entries, preserving pins;
- authenticated history reads, pin changes, and single-item deletion;
- an on-demand searchable UI with keyboard navigation and copy actions; and
- a compact
Super+Vquick-history mode.
The idle agent has remained below its 10 MB resident-memory target during development measurements. That is a development result, not a guarantee for every future platform or build.
Current boundaries
- Text is the only established capture type.
- Ubuntu GNOME Wayland is the only verified desktop path.
- Corruption recovery, bulk controls, broader Linux support, packaging hardening, and full security review remain incomplete.
- Windows and macOS capture and lifecycle adapters do not yet exist.
- The v1 direction is local-only: no accounts, cloud sync, OCR, AI features, or plugin system.
Documentation
- Ubuntu GNOME development guide — install, launch, operate, and diagnose the current vertical slice.
- Architecture and security — process boundaries, native-platform strategy, encrypted storage, IPC, and security limitations.
Vitra is available under the MIT licence.