One cursor. Every screen.
Seamless, non-root mouse, keyboard, smooth scrolling, and clipboard sharing between macOS, Linux, and Android, with Windows coming next.
What is SEAM • Preview • Install • Technology Stack • How It Works • Build from Source • Contributing
SEAM brings an Apple Universal Control experience to macOS, Linux, and Android (with Windows support coming next).
Move your desktop cursor past the edge of your display and it flows directly onto your Android phone sitting beside your laptop. Unlike screen-mirroring tools (scrcpy) that trap your pointer inside a desktop video window, or accessibility-based apps that draw fake overlay cursors, SEAM registers real virtual hardware HID devices in Android's Linux kernel (/dev/uhid) without root. You get Android's genuine native hardware pointer, 120 Hz smooth scrolling, desktop keyboard shortcuts, and automatic bidirectional clipboard sync over USB or Wi-Fi, from a native macOS menu-bar app or a Linux GTK 3 Control Center & CLI, with no Android app to install.
macOS Menu-Bar Popover: Liquid Glass UI & drag-to-arrange display layout (MP4 · MOV) |
Android Screen: Genuine native hardware cursor sprite driven via /dev/uhid (no root, no screen mirroring)
|
- Download SEAM-macOS-arm64.dmg (or SEAM-macOS-arm64.zip) from the latest GitHub Release.
- Open the disk image and drag SEAM into Applications.
- On first launch, right-click SEAM.app → Open (builds are ad-hoc signed, not notarized with an Apple Developer ID).
- Look for the laptop & iPhone icon in your macOS menu bar.
- Debian, Ubuntu, or Linux Mint (
.deb): Download seam_1.1.0_amd64.deb from the latest GitHub Release and install it:sudo apt install ./seam_1.1.0_amd64.deb
- Any Linux distro (rootless
.tar.gz): Download seam-1.1.0-linux-x86_64.tar.gz, extract it, and run./install.sh(installs to~/.localwith desktop launcher & icon, nosudoneeded). - Make sure
adb(android-tools-adb/platform-tools) is on yourPATH, then launch SEAM Control Center from your app menu or run:seam app # GTK 3 Control Center seam connect --edge right # Headless screen-edge session
- Enable USB Debugging (or Wireless Debugging) once under Android Developer Options.
- Plug your phone in for a moment (or connect via Wireless Debugging). SEAM automatically pushes the
32 KBseam-agent.jaragent, starts the/dev/uhidvirtual mouse & keyboard, and attaches both USB and Wi-Fi links. - Unplug anytime: the background daemon keeps Wi-Fi (
TCP/UDP 27186) ready for cable-free reconnection. - (macOS Optional) Grant SEAM permission in System Settings → Privacy & Security → Accessibility to enable global
CGEventTapcapture alongside the built-in non-activating panel fallback.
- Edge Crossing: Move your pointer past the side where you positioned your phone. Drag either tile inside the macOS popover or Linux Control Center to match your desk.
- Desktop Shortcuts on Android: On macOS,
Cmd+C/Cmd+V/Cmd+X/Cmd+A/Cmd+Z,Cmd+Left/Right(line start/end),Cmd+Up/Down(document top/bottom),Opt+Left/Right(word jump), andOpt+Backspace(delete word) translate cleanly to Android. On Linux, standardCtrlandAltshortcuts pass straight through. - Emergency Return to Desktop:
Ctrl + Option + QorCtrl + Option + Cmd + Escon macOS;Ctrl + Alt + Qon Linux.
flowchart TB
subgraph Host["Desktop Host (macOS SEAM.app / Linux seam)"]
direction LR
UI["macOS Liquid Glass Popover<br/>or Linux GTK 3 Control Center"]
HID["Physical Trackpad, Mouse & Keyboard"]
Capture["QuartzEdgeEngine (macOS)<br/>or X11GrabEngine (Linux X11)"]
CursorCtrl["Cursor Decouple & Hide<br/>(Quartz / XFixes)"]
KeyMap["HID Keycode Translator<br/>(6KRO + macOS/Linux Shortcuts)"]
ClipHost["Host Clipboard Watcher<br/>(NSPasteboard / X11 Selection)"]
Mux["Transport Multiplexer<br/>(HMAC-SHA256 & Auto-Failover)"]
UI -->|"Edge Position"| Capture
HID --> Capture
Capture --> CursorCtrl
Capture --> KeyMap
Capture -->|"Hi-Res Scroll & Pointer Deltas"| Mux
KeyMap -->|"6KRO HID Key Reports"| Mux
ClipHost <-->|"OP_CLIPBOARD_SET / EVENT"| Mux
end
subgraph Transport["Dual Authenticated Transport (SEAM-Wire v1)"]
direction LR
USB["USB ADB Transport<br/>ADB localabstract:seam_uhid<br/>SO_PEERCRED uid=2000 + HMAC-SHA256"]
WIFI["Wi-Fi Hybrid Transport<br/>TCP Control (Port 27186)<br/>+ 42B Signed UDP Fast-Path"]
end
Mux <==>|"Primary / Hot Standby"| USB
Mux <==>|"Primary / Hot Standby (< 10 ms Failover)"| WIFI
subgraph Android["Android Background Agent (seam_agent, Zero-APK uid=2000)"]
direction LR
Coord["DualTransportCoordinator<br/>(UsbLocalSocketServer + WifiTransportServer)"]
Engine["SeamInputEngine<br/>(Curve Velocity Shadow Tracker & Edge Return)"]
UHID["Linux /dev/uhid<br/>(16-bit Relative Mouse + 6KRO Keyboard)"]
AOSP["AOSP InputReader & PointerController<br/>(Native Hardware Cursor Sprite)"]
Scroll["SmoothScrollInjector<br/>(InputManagerGlobal 120 Hz ACTION_SCROLL)"]
ClipAnd["AndroidClipboardController<br/>(IClipboard Binder + Silent Timestamp Check)"]
Display["DisplayTelemetry<br/>(DisplayManagerGlobal Metrics & Rotation)"]
Coord <--> Engine
Engine -->|"UHID_INPUT2"| UHID
UHID --> AOSP
Engine -->|"1/32-Notch Fractional Scroll"| Scroll
Engine <-->|"Bidirectional Sync"| ClipAnd
Display --> Engine
end
USB <==>|"Encrypted Stream"| Coord
WIFI <==>|"Encrypted TCP + Signed UDP"| Coord
sequenceDiagram
autonumber
participant Desktop as Desktop Host (macOS / Linux)
participant Link as USB / Wi-Fi (SEAM-Wire v1)
participant Phone as Android Agent (seam_agent)
participant OS as Android Kernel & System
Desktop->>Link: Mutual HMAC-SHA256 Handshake
Link->>Phone: Authenticate Session (USB + Wi-Fi Standby)
Phone-->>Desktop: OP_DISPLAY_INFO (Resolution, DPI, Rotation)
Note over Desktop,Phone: You move your pointer past the configured screen edge
Desktop->>Desktop: Decouple & hide desktop cursor (no warp bounce)
Desktop->>Link: OP_CURSOR_ENTER + OP_CLIPBOARD_SET (sync host clipboard)
Link->>Phone: Home pointer & update Android IClipboard
Phone->>OS: /dev/uhid mouse report + IClipboard.setPrimaryClip
loop Active Control on Android (120 Hz)
Desktop->>Link: Mouse Deltas & Scroll (42B Signed UDP / USB)
Link->>Phone: Deliver Input Frame
Phone->>OS: /dev/uhid Pointer Sprite + SmoothScrollInjector ACTION_SCROLL
Desktop->>Link: Keyboard Reports (6KRO HID + Shortcut Translation)
Phone->>OS: /dev/uhid 6KRO Key Report
end
Note over Phone,OS: Copy on Android or push pointer back to the return bezel
OS-->>Phone: IOnPrimaryClipChangedListener -> OP_CLIPBOARD_EVENT
Phone-->>Desktop: Sync copied text to Host Clipboard
Phone-->>Desktop: OP_EDGE_RETURN (exit Y ratio)
Desktop->>Desktop: Restore & show desktop cursor at matching edge height
SEAM/
├── README.md
├── CONTRIBUTING.md
├── LICENSE
├── Makefile
├── .github/workflows/
│ └── release.yml # Automated Linux CI (cargo test) + .deb/.tar.gz release publisher
├── assets/
│ ├── app-icon.png # Exported 1024×1024 Icon Composer AppIcon
│ ├── android-native-cursor.jpg # Native Android hardware pointer screenshot
│ ├── seam-demo.gif # Animated demo preview
│ ├── seam-demo.mp4 # 60 fps H.264 demo clip
│ ├── seam-demo.mov # Original screen recording
│ ├── social-preview.png # 1280×640 GitHub social preview card
│ ├── download-macos.svg
│ ├── download-linux.svg
│ └── windows-soon.svg
├── release/
│ ├── SEAM-macOS-arm64.dmg # Ready-to-install macOS disk image (bundles Android agent)
│ └── SEAM-macOS-arm64.zip # Portable zipped SEAM.app bundle
├── scripts/
│ ├── build-agent.sh # Zero-Gradle DEX compiler (javac + Android SDK d8)
│ ├── build-host.sh # Swift release build, Icon Composer export & SEAM.app bundler
│ ├── install-linux.sh # Rootless Linux builder & ~/.local installer
│ └── package-linux.sh # Linux .tar.gz and .deb release packager
├── macos-host/
│ ├── Package.swift
│ ├── Resources/AppIcon.icon/ # Apple Icon Composer document (laptopcomputer.and.iphone)
│ └── Sources/SeamHost/
│ ├── Main.swift # App & CLI entrypoint (app, edge, devices, usb/wifi/switch tests)
│ ├── UI/ # SeamMenuBarController, SeamPopoverView, ArrangementView, LiquidGlass, SeamAppViewModel
│ ├── Input/ # QuartzEdgeEngine, BackgroundCursorController, MacKeycodeTranslator, MacClipboardSyncEngine
│ ├── Protocol/ # SeamWireProtocol & CryptoKit SeamAuthenticator
│ ├── Transport/ # SeamTransport, UsbAdbTransport, WifiHybridTransport & SeamTransportMultiplexer
│ └── Bootstrap/ # UsbBootstrapper (ADB / Wireless Debugging / mDNS / LAN probe)
├── linux-host/
│ ├── Cargo.toml
│ ├── src/
│ │ ├── main.rs # CLI & GUI entrypoint (app, connect, devices, info)
│ │ ├── protocol/ # SEAM-Wire v1 codec & HMAC-SHA256 authenticator
│ │ ├── transport/ # USB ADB socket, Wi-Fi TCP/UDP fast-path & multiplexer
│ │ ├── bootstrap/ # ADB device discovery, agent push & Wi-Fi probe
│ │ ├── input/ # X11 edge watcher, pointer/keyboard grab, X11 keymap & clipboard
│ │ ├── session/ # Active session coordinator & edge return handling
│ │ └── ui/ # GTK 3 Control Center & interactive arrangement view
│ └── tests/ # Protocol, keymap, input, transport & session test suites
├── android-agent/
│ └── src/main/java/com/seam/agent/
│ ├── Main.java # Daemon & diagnostics CLI (--server, --info, --self-test, --calibrate)
│ ├── core/ # SeamInputEngine
│ ├── clipboard/ # AndroidClipboardController
│ ├── pointer/ # PointerLinearizer & SmoothScrollInjector
│ ├── protocol/ # SeamProtocol & SeamAuthenticator
│ ├── transport/ # DualTransportCoordinator, UsbLocalSocketServer, WifiTransportServer
│ ├── uhid/ # UhidDevice, HidDescriptors, HidKeycodes
│ └── telemetry/ # DisplayTelemetry, DisplayMetricsSnapshot, NetworkTelemetry
└── research/ # Architecture specifications & protocol notes
- Prerequisites: macOS 14+ (Apple Silicon
arm64) with Xcode (Swift 6+,ictool,actool), JDK 17+, and Android SDK (adb,d8,platforms/android-35/android.jarin~/Library/Android/sdk).
# Compile Android DEX agent (dist/seam-agent.jar), Swift host (dist/seam-host), and dist/SEAM.app
make build
# Launch SEAM in the macOS Menu Bar
open dist/SEAM.app- Prerequisites: Rust toolchain (
cargo,rustc),libx11-dev,libxfixes-dev,libgtk-3-dev,pkg-config,adb, plus JDK 17+ & Android SDK (d8,android.jar) if rebuildingdist/seam-agent.jar.
# Build dist/seam-agent.jar (if not already present)
./scripts/build-agent.sh
# Build & install rootless to ~/.local (includes desktop entry & icon)
./scripts/install-linux.sh
# Run Rust test suite
(cd linux-host && cargo test)
# Build .tar.gz and .deb release packages under build/release/
./scripts/package-linux.sh 1.1.0make edge # Terminal-based macOS <-> Android edge-crossing session
make devices # List discovered Android devices
make usb-test # Benchmark USB ADB socket transport & mutual auth
make wifi-test # Benchmark Wi-Fi Hybrid (TCP + 42B HMAC-SHA256 UDP) transport
make switch-test # Test live zero-downtime USB <-> Wi-Fi switching & failover
make device-info # Inspect display geometry, /dev/uhid & PointerChoreographer
make self-test # Run on-device /dev/uhid cursor & keyboard self-test
make calibrate # Verify 16-bit corner homing & velocity control calibrationSee research/README.md for deep technical specifications.
SEAM is open to pull requests, bug reports, and hardware compatibility feedback (especially Windows host support, Wayland native support, and testing across Android OEMs). See CONTRIBUTING.md for setup steps, verification commands, and PR guidelines.
Distributed under the MIT License.

