DEV Community

Amartya Chowdhury
Amartya Chowdhury

Posted on

I Built wireclip in Rust to Stop My Friend From Emailing Themselves Links

#devchallenge #weekendchallenge #hf26challenge

This is a submission for the Hacktoberfest Weekend Challenge: Build for a Friend

What I Built

I built wireclip (wclip)—a zero-configuration, privacy-first local network clipboard synchronization daemon written in Rust.

The Story Behind It

My friend and I both run minimalist Linux setups on our laptops. We spend most of our days in the terminal, writing code, testing APIs, and managing local servers. But whenever we needed to test an API response on our phones, sign into 2FA apps, or quickly pass code snippets, long URLs, or tokens between our laptops and mobile devices, the workflow ground to a halt.

My friend kept resorting to emailing themselves links, pasting secret keys into public messaging apps, or typing out long strings character-by-character on their phone keyboard. They needed a dead-simple way to mirror their desktop clipboard to their phone—and vice-versa—over our local Wi-Fi without third-party cloud services monitoring or logging sensitive clipboard data.

So, I built wireclip (wclip) for them. It runs as a lightweight, single-binary background daemon on your desktop, serving a local WebSockets-powered PWA accessible over your subnet. Anything you copy on your laptop instantly streams to your phone, and whatever you send from your phone gets written directly to your system clipboard.

Demo

wireclip demo

Real-time, two-way clipboard synchronization over local Wi-Fi between a Linux desktop and mobile PWA.

Code

GitHub logo aether-flux / wclip

Zero-config, privacy-first local network clipboard synchronization daemon in Rust.

WireClip

Zero-config, privacy-first local network clipboard synchronization daemon in Rust.

WireClip is a lightweight background service that seamlessly syncs text between your desktop workstation and mobile devices over your local Wi-Fi network. Built with an earthy, warm minimalist interface, it keeps your sensitive clipboard data strictly inside your local subnet—no cloud services, no third-party accounts, and zero tracking.

recording_20261004_11-46-14.mp4

Features

  • Instant Two-Way Sync: Text copied on desktop streams to your phone; text sent from your phone is instantly written to your desktop clipboard.
  • Wayland Native & Cross-Platform: Direct support on Linux (Wayland/X11), macOS, and Windows via arboard.
  • Low Latency: Real-time bi-directional streaming powered by WebSockets.
  • PWA Ready: Clean, warm-toned web interface optimized for mobile browsers with HTTP fallback for secure clipboard copying on local IP addresses.
  • Single Binary: Everything, including the frontend assets, is compiled into a single lightweight Rust executable.

Prerequisites

Linux (Wayland)

For instant event-driven background sync…

View on GitHub

How I Built It

wireclip is built using Rust with performance, safety, and modern display protocols in mind:

  • Rust & Tokio: Handles system event loops and concurrent WebSocket communication with near-zero resource footprint.
  • Axum: Serves the minimal mobile-friendly PWA frontend and maintains low-latency WebSocket connections for instant text streaming.
  • arboard: Provides clipboard support on Wayland, X11, macOS, and Windows.
  • HTTP Fallback Engineering: Modern mobile browsers restrict navigator.clipboard on non-secure (http://) IP addresses. I implemented an unnoticeable document.execCommand('copy') fallback element so tap-to-copy works flawlessly on local LAN connections.
  • Grounded Earthy Aesthetic: Tailored with a warm, minimalist dark theme that feels calm, elegant, and native on mobile screens.

During development, I leveraged open-weight AI models as a thought partner to rapidly prototype flows, iron out cross-device network bindings, and streamline UI styling.

Why Does Open Innovation Matter?

Open innovation made it possible to design and build a privacy-respecting, low-level system utility from scratch in a single weekend. Proprietary ecosystems lock users into cloud-synced clipboards that transmit sensitive keystrokes, API keys, and credentials through external servers.

Having access to open frameworks, open-weight models, and open-source display protocol libraries empowered me to build a zero-dependency tool that keeps user data entirely inside their own local network where it belongs.

Top comments (0)