Omarchy Linux TLS 1.2+ Pinned Zero Telemetry MIT License

Command Omarchy.From your phone.

OmaLink brings Android Continuity, Wayland Remote Desktop, Wireless Trackpad, OS Control, and Live AI Agent Sessions to Omarchy Linux — powered by a pure Python 3.11+ bridge, an Omarchy top-bar plugin, and pinned TLS encryption with zero cloud relays.

omalink-bridge.service · TLS 1.2+ · Pixel 8 linked
1-Command Omarchy Plugin Marketplace Install
$ omarchy plugin add https://github.com/M30W-M1X/omalink.git --enable

No account. Zero tracking. Digest-verified standalone install →

One encrypted link for Continuity, Remote Control, and AI Agents.

Built natively for Hyprland and Omarchy Linux with zero pip dependencies and live Omarchy theme syncing across every screen on Android.

Live AI Sessions

Peek, approve & reply

Auto-discovers open agy and claude sessions, alerts your phone when an agent asks a question, and lets you reply or continue builds with 1 tap.

Phone ↔ Omarchy

Native Continuity

Omarchy top-bar Connected Device card with real phone name & 10-segment battery bar, mirrored notifications with inline quick-reply, clipboard sync, and Find My Phone with 1-tap stop.

Control & Remote

Desktop, Trackpad & PTY

Wayland screen streaming (grim), wireless trackpad & slide remote, PipeWire audio & MPRIS media controls, interactive xterm PTY shell, and 2-way file explorer.

0pip
Pure Python 3.11+ standard-library bridge
5icons
Animated mascots & switchable Android app icons
TLS1.2+
SHA-256 cert pinning + 256-bit bearer token
0cloud
100% local LAN / Tailscale — nothing phones home

Top-bar native on Omarchy. Theme-synced on Android.

OmaLink watches ~/.config/omarchy/current/theme/colors.toml and re-themes the entire Android app & terminal palette whenever you switch Omarchy themes.

OmaLink Home screen with Arcane Agy mascot and quick launch tiles
Home & Mascot
Animated Anime Wizard mascot and switchable Android app icon picker
Avatars & App Icons
Companion Tools bottom sheet
Tools Sheet
Omarchy Control Plane with vitals, audio, and media controls
Control Plane
Continuity with phone notifications and universal clipboard
Continuity
Wireless Trackpad and Presentation Remote
Trackpad & Slides
Interactive PTY terminal
PTY Terminal
Sanctum Settings with QR/mDNS pairing, TLS, and vitals shade
Sanctum & TLS

Direct device-to-desktop link. No middleman server.

Every notification, clipboard snippet, keystroke, file transfer, and agent reply travels directly between your phone and your Omarchy machine.

Local Link Architecture · Zero External Relay
OMALINK ANDROID APP (io.github.m30w_m1x.omalink) TLS 1.2+ · SHA-256 CERT PIN · 256-BIT BEARER TOKEN PYTHON 3.11+ BRIDGE · omalink-bridge.service HYPRLAND · PIPEWIRE · WAYLAND · AGY / CLAUDE · TOP BAR

No cloud backend exists. Your phone discovers your desktop over local mDNS (_omalink._tcp), a scanned QR code (omalink://pair), or your private Tailscale IP.

Zero tracking, zero analytics. Read our full plain-English Android Privacy Policy for exact details on every optional Android permission.

Hardened for real LAN and desktop use.

Every transport boundary, file path, confirmation dialog, and release artifact fails closed by default.

APinned TLS 1.2+Self-signed TLS is enabled by default and verified with constant-time 64-hex SHA-256 certificate pinning on Android and loopback cert.pem verification on desktop.
BHeader-First Auth256-bit cryptographically random bearer token (secrets.token_urlsafe(32)) verified with hmac.compare_digest before reading any HTTP body, with IPv6 /64 rate limiting.
CRequest-Bound PromptsAndroid pairing deep links and share handoffs require explicit confirmation bound to the exact displayed request and discard it if the pending item changes.
DPer-Connection Clip IDTop-bar Send Clip binds to a unique 128-bit per-connection client_id, sends only the current clipboard text (no history fallback), and strictly honors Android's autoSyncClipboard toggle.
ESafe File & URI BoundsNo-follow symlink handling, sensitive path blocklist (~/.ssh, ~/.gnupg, ~/.config/omalink), URI scheme allowlist, and a 2 MB WebSocket frame cap.
FDigest-Verified ReleasesStandalone installer binds to an immutable 40-char commit SHA, verifies all 11 runtime files via sha256sum before starting, and ships release SHA256SUMS.
GZero Cloud Backupandroid:allowBackup="false" prevents pairing tokens from leaving your device via cloud backups. Full source under the MIT License.

Install in one command, or verify every SHA-256 digest.

Requires Python 3.11+ on Omarchy Linux (zero pip packages needed) and Android 7.0+ (API 24+).

Option 1 · Omarchy Plugin Marketplace (Recommended)
omarchy plugin add https://github.com/M30W-M1X/omalink.git --enable
Option 2 · Digest-Verified & Commit-Pinned Standalone Installer (v3.7.2)
curl -fsSLO https://github.com/M30W-M1X/omalink/releases/download/v3.7.2/install.sh && \
curl -fsSLO https://github.com/M30W-M1X/omalink/releases/download/v3.7.2/SHA256SUMS && \
echo "41f04e259b3d24f25fe31ad8428bfb7bea2ecd6c7ae44e98da954f451081444a  install.sh" | sha256sum -c - && \
grep '  install.sh$' SHA256SUMS | sha256sum -c - && \
bash install.sh --ref 53b97e0ce96bde53d5e86754f88f4c0719e61445
Android Companion APK · Verify Against Release SHA256SUMS (v3.7.2)
curl -fsSLO https://github.com/M30W-M1X/omalink/releases/download/v3.7.2/app-release.apk && \
curl -fsSLO https://github.com/M30W-M1X/omalink/releases/download/v3.7.2/SHA256SUMS && \
grep '  app-release.apk$' SHA256SUMS | sha256sum -c -
Pairing

1-Tap QR or LAN mDNS

Click the OmaLink wizard icon in your Omarchy top bar to view the live pairing QR code, scan it with your phone camera, or tap Scan LAN (mDNS) in Sanctum Settings.

Firewall (UFW)

Allow bridge port on LAN

If UFW is enabled on your Omarchy machine, allow port 7842/tcp on your local network: sudo ufw allow 7842/tcp.

Frequently asked questions.

Does OmaLink send any of my data to external servers or track usage?

No. OmaLink has zero telemetry, zero analytics, zero ads, and no cloud backend. All communication stays strictly between your phone and your paired Omarchy desktop over your LAN or private Tailscale network. See our Privacy Policy.

Can I use OmaLink away from home?

Yes. If both your Omarchy desktop and Android phone are on the same Tailscale tailnet, OmaLink automatically includes your Tailscale IP in the pairing QR code so you can connect securely from anywhere.

How does Find My Phone work?

Click Ring Phone in the Omarchy top-bar panel to trigger an alarm sound on your linked phone. Just like Apple Find My iPhone, a high-priority heads-up notification and in-app Find My Phone Alert dialog appear immediately so you can silence it with 1 tap.

Which AI coding agents are supported?

OmaLink supports launching, monitoring, and resuming agy (Antigravity), claude (Claude Code), codex, kimi, and opencode, plus live session discovery, peek, and interactive reply for open agy and claude sessions.

Your Omarchy desktop, in your pocket.

Encrypted by default, theme-synced live, and 100% open source.