crosspaste-desktop

<div align="center"> <img src="doc/en/marketing.webp" width="986px" height="518px" alt="poster" /> <h1>CrossPaste: Universal Pasteboard Across Devices</h1> <p> <b>Copy anything and paste it on any device, seamlessly</b> <br /> <br /> <a href="https://github.com/CrossPaste/crosspaste-desktop/blob/main/README.zh-CN.md">简体中文</a> · <a href="https://crosspaste.com/en/" target="_blank">Official Website</a> · <a href="https://deepwiki.com/CrossPaste/crosspaste-desktop" target="_blank">Wiki</a> · <a href="https://crosspaste.com/en/download" target="_blank">Download</a> · <a href="https://crosspaste.com/en/video?from=github" target="_blank">Video</a> <br /> </p>

<a href="https://trendshift.io/repositories/15491?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-15491" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/15491" alt="CrossPaste%2Fcrosspaste-desktop | Trendshift" width="250" height="55"/></a> <a href="https://trendshift.io/repositories/15491?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-15491" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/15491/weekly?language=Kotlin" alt="CrossPaste%2Fcrosspaste-desktop | Trendshift" width="250" height="55"/></a>

<a href="https://github.com/sponsors/CrossPaste"><img src="https://img.shields.io/badge/sponsor-30363D?style=social&logo=GitHub-Sponsors&logoColor=#white" height="30px"></a> <img src="https://img.shields.io/github/stars/CrossPaste/crosspaste-desktop?style=social" height="30px">

</div>

✨ 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

The extension auto-discovers a CrossPaste desktop app running on the same machine and syncs clipboard content with it. To iterate on extension code, run npm run dev inside web/ for a fast Vite dev loop, then reload the extension in Chrome. The extension imports a Kotlin/JS core library produced by ./gradlew :core:jsBrowserProductionLibraryDistribution (also run as part of :web:build) — re-run that task whenever you change core/ sources.

🗺️ Roadmap

CrossPaste is continuously evolving! v2.2 brings a full command-line mode — copy, paste, and search your history straight from the terminal. Here's what we're working on next:

• [ ] Plugin system — let the community extend CrossPaste with custom paste types and integrations

This is just a small part of our plans. Want to learn more details and long-term plans? Check out our full roadmap.

🙋 FAQ

Here are some FAQs that have been collected. If you have other questions, please create an issue to let us know.

🤝 Support the project

• 🌟 Star this repository: This is the easiest way to support CrossPaste and costs nothing.
• 🪲 Report bugs: Report any bugs you find on the issue tracker.
• 📖 Translate: Help translate and polish CrossPaste into your language.
• 📝 Contribute: Code, comment on issues, and any contributions that can help the project are welcome.
• 💖 Sponsor: Support financially via GitHub Sponsors to help with ongoing development and maintenance.

📝 Contributors

<!-- contributors --><a href="https://github.com/guiyanakuang"><img src="https://wsrv.nl/?url=github.com/guiyanakuang.png&w=120&h=120&fit=cover&mask=circle&output=png" width="60" height="60" alt="guiyanakuang" /></a>&nbsp;<a href="https://github.com/amir1376"><img src="https://wsrv.nl/?url=github.com/amir1376.png&w=120&h=120&fit=cover&mask=circle&output=png" width="60" height="60" alt="amir1376" /></a>&nbsp;<a href="https://github.com/Blushyes"><img src="https://wsrv.nl/?url=github.com/Blushyes.png&w=120&h=120&fit=cover&mask=circle&output=png" width="60" height="60" alt="Blushyes" /></a>&nbsp;<a href="https://github.com/emmanuel-ferdman"><img src="https://wsrv.nl/?url=github.com/emmanuel-ferdman.png&w=120&h=120&fit=cover&mask=circle&output=png" width="60" height="60" alt="emmanuel-ferdman" /></a>&nbsp;<a href="https://github.com/Fldicoahkiin"><img src="https://wsrv.nl/?url=github.com/Fldicoahkiin.png&w=120&h=120&fit=cover&mask=circle&output=png" width="60" height="60" alt="Fldicoahkiin" /></a>&nbsp;<a href="https://github.com/swording-k"><img src="https://wsrv.nl/?url=github.com/swording-k.png&w=120&h=120&fit=cover&mask=circle&output=png" width="60" height="60" alt="swording-k" /></a>&nbsp;<a href="https://github.com/sunxiang0918"><img src="https://wsrv.nl/?url=github.com/sunxiang0918.png&w=120&h=120&fit=cover&mask=circle&output=png" width="60" height="60" alt="sunxiang0918" /></a>&nbsp;<!-- contributors -->

💖 Sponsors

<!-- sponsors --><a href="https://github.com/liaokaime"><img src="https://wsrv.nl/?url=github.com/liaokaime.png&w=120&h=120&fit=cover&mask=circle&output=png" width="60" height="60" alt="liaokai" /></a>&nbsp;<a href="https://github.com/jaepil-choi"><img src="https://wsrv.nl/?url=github.com/jaepil-choi.png&w=120&h=120&fit=cover&mask=circle&output=png" width="60" height="60" alt="Jaepil.Choi" /></a>&nbsp;<!-- sponsors -->