Skip to content
develicit edited this page Nov 16, 2026 · 3 revisions

ClipSync Technical Wiki

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.

Reading guide

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

End-to-end flow

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.

Documentation baseline

  • Reviewed source: master commit 76c63f9, dated 2026-11-16.
  • The workspace package version is 0.2.0, with a minimum Rust version of 1.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.

Project links

Source repository · Installation and usage · Releases · Contributing · Private vulnerability reporting

Clone this wiki locally