Crosspaste Desktop

CrossPaste: Universal Pasteboard Across Devices

  <b>Copy anything and paste it on any device, seamlessly</b>
  
  
  简体中文
   ·
  Official Website
   ·
  Wiki
   ·
  Download
   ·
  Video

✨ Features

• 🔄 Real-time Sharing: Instantly share pasteboard content across devices, seamlessly.
• 🖥️ Unified Cross-platform: Consistent interface on Mac, Windows, and Linux. No need to change habits.
• 📋 Rich Type Support: Handle various pasteboard types: Text, Color, URL, HTML, RTF, Image, File.
• 🔒 End-to-End Encryption: Using asymmetric encryption to fully protect your data security.
• 🌐 LAN-only Serverless: Local storage, serverless architecture. Privacy protection, in your control.
• 🧹 Smart Space Management: Auto-cleanup options manage pasteboard storage without manual effort.
• 🔍 Built-in OCR: Extract text from images locally — no network calls, your screenshots never leave the device.
• 🤖 MCP Server: Expose your pasteboard history to AI assistants (Claude, etc.) via the Model Context Protocol.
• 🌍 Chrome Extension: Sync clipboard with the browser — copy on a web page, paste on any device.
• ⌨️ Command-Line: Copy, paste, and search your history from the terminal and scripts. See the CLI guide.

🏗 Getting Started with Development

1. clone the repository

   git clone https://github.com/CrossPaste/crosspaste-desktop.git
   

2. Compile and run the application

   cd crosspaste-desktop
   ./gradlew app:run
   

First start will download JBR / gradle dependencies.

If you encounter the following error:

FAILURE: Build failed with an exception.

* What went wrong:
java.net.SocketException: Connection reset
> java.net.SocketException: Connection reset

you might need a VPN to download these dependencies.

To configure a proxy for gradle, add the following settings to gradle.properties, and adjust the parameters to match your proxy configuration:

systemProp.https.proxyHost=localhost
systemProp.https.proxyPort=8080
systemProp.https.proxyUser=userid
systemProp.https.proxyPassword=password
systemProp.http.nonProxyHosts=*.nonproxyrepos.com|localhost

Additionally, a series of technical blogs about CrossPaste is being published (approximately one article per week). If you're interested in developing cross-platform applications, you're welcome to read them.

🌍 Building the Chrome Extension

The Chrome extension lives in web/ and is built via Gradle. Node.js (>= 18) is required — the npmInstall task will fetch dependencies on first build.

1. Build the extension

   ./gradlew :web:build
   

   The unpacked extension is emitted to web/dist/.

2. Load it into Chrome

   • Open chrome://extensions/
   • Enable Developer mode in the top-right corner
   • Click Load unpacked and select the web/dist/ directory