TypeBridge

Phone as Keyboard & Mouse

Website  ·  Download  ·  中文

---

👋 What is TypeBridge?

TypeBridge is a macOS desktop app. Open the app, scan a code — your phone instantly becomes a wireless keyboard and trackpad for your Mac. Type, control the cursor, or use your voice, all from one device.

You can also send messages through Feishu, DingTalk, or WeCom bots — they'll land right where your cursor is on the desktop.

🧩 Why does this exist?

Presenting slides from across the room? Browsing from the couch and don't want to get up? Tired of copying text back and forth between your phone and AI coding tools?

TypeBridge does one thing well: turn your phone into a wireless keyboard and trackpad for your Mac. Type, move the cursor, use your voice — just scan a code and you're set.

✨ Highlights

Feature
Trackpad mode	Move the cursor with one finger, scroll with two, tap to click. No Bluetooth. No pairing. Scan and go.
Text input	Type on your phone, text appears on your Mac — wherever the cursor is. Voice-to-text works too, using your phone's built-in input method.
Quick commands	One-tap shortcuts: arrow keys, Cmd+Z/X/C/V, Enter, Escape, and more. No need to reach for the keyboard.
Built-in WebChat	No bot setup needed. Start a local WebChat session and scan the QR code to bind your phone — once bound, it stays paired across app restarts (LAN-only). Traffic stays on your LAN.
IM bot support	Feishu, DingTalk, and WeCom bots feed into the same FIFO queue. Messages are handled one at a time — no focus conflicts.
Works by pasting	TypeBridge writes to the clipboard and simulates Cmd+V, keeping it compatible with VS Code, Terminal, browsers, Obsidian, Slack, and more.
Image support	Images sent through IM channels are injected via the system clipboard.
Optional auto-submit	After pasting, TypeBridge can press Enter or a custom key. Handy for chat windows, terminals, and AI assistants.
Quick inputs	Save frequent text as short triggers. Send /key to replace the whole message with its content, or use $key inline within a sentence — expanded before injection across every channel (WebChat, Feishu, DingTalk, WeCom).
Tactile mobile keyboard	Five focused tabs (Direction · Edit · Clipboard · Navigation · Screenshot). Arrows and Backspace support long-press auto-repeat at iOS-keyboard cadence (16Hz). Every key has crisp pressed feedback with optional haptics on Android.
Smoother in-app updates	The About panel embeds a status bar that shows download progress live, with cancel and retry on failure — and never blocks you from keeping using the app.

🔄 How it works

1. Launch TypeBridge on your Mac and start a WebChat session.
2. Scan the QR code on your phone — the phone is paired instantly. The binding persists across app restarts as long as you're on the same Wi-Fi. Then switch to typing or trackpad mode.
3. Type, use voice input, or control the cursor — your Mac responds instantly.
4. With auto-submit enabled, TypeBridge sends Enter or your configured key after each paste.
5. You can also use Feishu, DingTalk, or WeCom bots — messages go into the same FIFO queue.

📡 Supported channels

Channel	What you need	Best for
WebChat	No account. Start a session and scan the QR code.	Personal use, quick trials, offline workflows
Feishu	Self-built app (App ID + Secret)	Teams already using Feishu
DingTalk	Internal app (Client ID + Secret, Stream Mode)	Teams already using DingTalk
WeCom	Smart Bot (Bot ID + Secret)	Teams already using WeCom

🖥️ System requirements

macOS 13+ (Apple Silicon or Intel)

On first launch, TypeBridge asks for Accessibility permission. It is used to send Cmd+V and optional submit keys to the frontmost app; TypeBridge does not read or monitor your screen.

🛠️ Development

Prerequisites

Dependency	Version
Node.js	20+
Rust	stable (1.95+)
Go	1.21+
Xcode Command Line Tools	required

📖 First-time setup: see docs/DEV_SETUP.md for the full environment bootstrap, common error fixes, and mirror configuration.

Quick Start

# 1. Install npm deps (root + webchat-local subproject)
npm install && cd webchat-local && npm install && cd ..

# 2. Build Go sidecars (three channels, aarch64)
mkdir -p src-tauri/binaries
for bridge in feishu-bridge dingtalk-bridge wecom-bridge; do
  (cd "$bridge" && GOPROXY=https://goproxy.cn,direct GOOS=darwin GOARCH=arm64 \
    go build -ldflags '-s -w' \
      -o "../src-tauri/binaries/${bridge}-aarch64-apple-darwin" .)
done

# 3. Build webchat-local static assets (tauri dev does not trigger this)
cd webchat-local && npm run build && cd ..

# 4. Start dev mode (first cold build ~5-10 min, subsequent rebuilds are incremental)
npm run tauri dev

Project Layout

type-bridge/
├── src/                     React frontend (Vite + Tailwind + Zustand)
├── src-tauri/               Tauri / Rust backend
│   └── src/
│       ├── injector.rs      Text injection via CGEventPost + NSPasteboard
│       ├── sidecar.rs       Go sidecar process management
│       ├── webchat.rs       Built-in LAN WebChat server host
│       ├── queue.rs         FIFO injection queue + feedback
│       └── ...
├── feishu-bridge/           Feishu Go sidecar (long-connection WebSocket)
├── dingtalk-bridge/         DingTalk Go sidecar (Stream Mode)
├── wecom-bridge/            WeCom Go sidecar (WSS + AES image decrypt)
├── website/                 Product site (Next.js, single-page landing)
├── webchat-local/           WebChat mobile SPA (Vite + React + TS)

Development notes

• Go sidecars require manual rebuild — tauri dev does not recompile Go. After editing .go files, run go build for the affected bridge, then restart tauri dev.
• webchat-local requires manual rebuild — tauri dev does not trigger the Vite build for webchat-local. After editing files under webchat-local/, run cd webchat-local && npm run build.
• Frontend HMR works automatically for src/ changes.
• Rust changes are picked up automatically by tauri dev (cargo rebuild).

Build & Package

# Single arch
npm run tauri build -- --target aarch64-apple-darwin

# Both archs
./scripts/build-all.sh

Output: src-tauri/target/{arch}/release/bundle/dmg/TypeBridge_*.dmg

📄 License

MIT