Repository navigation
Home
ClipSync is an end-to-end encrypted clipboard tool that synchronizes text, images, and files across macOS, Linux, and Windows. This wiki introduces the structure and behavior of the current Rust implementation for developers exploring the project.
| Page | What it covers |
|---|---|
| Architecture | Client, shared core, relay, and process boundaries |
| Repository structure | The 12 crates, directories, and code entry points by feature |
| Pairing and sync | Code-based pairing, encrypted transfers, receiving, and reconnection |
| Security and storage | Trust model, key and token storage, and current guarantees |
| Development and testing | Builds, tests, regression checks, coverage, and CI |
| Relay operations | TLS configuration, in-memory state, restarts, and observability |
After two devices pair, each client stores its keys locally. The client core then detects clipboard changes, encrypts the content, and sends it through the WebSocket relay. The receiving device validates and decrypts the item before applying it to its clipboard or inbox. The relay can see routing metadata and ciphertext.
The CLI and desktop app share local storage and the per-user daemon. Mobile apps call the core through this repository's UniFFI library; the Swift/Kotlin applications and their platform clipboard handling live in separate repositories.
- Reviewed source: master commit
76c63f9, dated 2026-11-16. - The workspace package version is
0.2.0, with a minimum Rust version of1.95. This baseline includes changes merged after the v0.2.0 release. - For detailed APIs, fields, and errors, consult the repository's interface reference.
- When behavior changes, review the related wiki text and diagrams together with the repository's
docs/files. The wiki is a separate Git repository and is not synchronized automatically.
Source repository · Installation and usage · Releases · Contributing · Private vulnerability reporting
Baseline: source 76c63f9 · 2026-11-16 · Wiki home · Source repository. The wiki is a separate Git repository and is not synchronized with product sources automatically.