PhoneBox
PhoneBox turns an old Android phone into a desk panel and touch control deck for Windows, Linux, and macOS, with over 120 widgets, 30 templates, system stats, AI coding quotas, music, automation, and USB or Wi-Fi pairing without accounts.
Visit ersinkoc/phoneboxOverview
PhoneBox pairs a full-screen Android app with a small desktop agent to turn an old Android phone into a customizable desk panel and touch control deck for Windows, Linux, and macOS. It supports USB or Wi-Fi connections, browser-based layout editing, and local operation without PhoneBox accounts or cloud services.
Key Features
- Visual layout editor with more than 120 widgets and 30 templates on a 12 x 6 grid, multiple pages, portrait or landscape layouts, and Smart Stack.
- PC monitoring for CPU, GPU, RAM, disks, network, ping, charts, GPU details, and process controls.
- AI coding views for Claude, Codex, and Antigravity quotas, reset times, burn-rate forecasts, local sessions, GitHub reviews and CI status, plus Claude Code permission Allow or Deny.
- Control Deck touch controls for apps, URL shortcuts, key combinations, macros, application audio, microphone, media, OBS, tasks, dev servers, and display brightness.
- USB or Wi-Fi and Tailscale connectivity with a pinned certificate and paired key; PhoneBox has no accounts or telemetry and does not require a cloud service.
- Webhook values and notifications plus Home Assistant controls and rules that can switch pages based on computer activity.
Use Cases
- Repurpose an old Android phone as a secondary desk display for system, network, and process monitoring.
- Keep AI coding quotas, sessions, GitHub reviews, and Claude Code permission prompts visible while coding.
- Use the phone as a touch control deck for media, OBS, apps, shortcuts, volume, microphone, and display brightness.
- Push CI, script, or Home Assistant values and notifications through webhooks and automate page changes with rules.
Getting Started
- Install the desktop agent with the Windows PowerShell setup script or the Linux/macOS shell setup script; setup checks the download, installs adb if missing, and can install the phone app.
- Connect an Android 5+ phone over USB with USB debugging enabled, or enable Wi-Fi in settings and pair a phone by scanning the QR code.
- Open the local settings page, choose a template under Pages, drag and resize widgets, then save; Live preview shows unsaved edits with live data.
Deployment & Requirements
- Windows 10/11 x64, Linux x64 or ARM64 with glibc, or macOS on Apple silicon or Intel for release builds.
- An Android 5+ phone, with Android 6 or later recommended; there is no iOS version.
- USB requires a data cable and USB debugging; Wi-Fi pairing works without either. Release agents include .NET, so the runtime does not need separate installation.
- Widgets depend on host hardware, installed tools, and permissions; advanced Control Deck features have their own platform requirements, and there are no release builds for Windows ARM or musl Linux such as Alpine.
Before You Adopt
- License: MIT. Review its terms before using, modifying, or distributing the project.
- Windows release agents are currently unsigned while the SignPath Foundation application is pending.
- The native audio and display controls are Windows-only.
- USB debugging should be authorized only on computers you trust.