{"slug": "show-hn-turn-an-old-android-phone-into-a-customizable-pc-control-deck", "title": "Show HN: Turn an Old Android Phone into a Customizable PC Control Deck", "summary": "Developer Ersin Koc released PhoneBox, an open-source tool that turns an Android 5+ phone into a customizable control panel for Windows, Linux and macOS computers over USB or Wi-Fi, with no root, account or cloud service required. PhoneBox pairs a full-screen Android app with a desktop agent and a browser-based visual editor offering 126 widgets, 30 templates, multiple pages and a live preview, covering PC monitoring, touch controls, automation and AI coding session tracking for Claude, Codex and Antigravity quotas plus local Claude Code, Codex and OpenCode sessions. Release agents are currently unsigned while the SignPath Foundation application is pending, so SmartScreen or antivirus software may warn or block them.", "body_md": "**English** ·\n  [Türkçe](https://github.com/ersinkoc/phonebox/blob/main/docs/README.tr.md) ·\n  [Deutsch](https://github.com/ersinkoc/phonebox/blob/main/docs/README.de.md) ·\n  [Français](https://github.com/ersinkoc/phonebox/blob/main/docs/README.fr.md) ·\n  [Español](https://github.com/ersinkoc/phonebox/blob/main/docs/README.es.md) ·\n  [Italiano](https://github.com/ersinkoc/phonebox/blob/main/docs/README.it.md) ·\n  [Português](https://github.com/ersinkoc/phonebox/blob/main/docs/README.pt.md) ·\n  [Nederlands](https://github.com/ersinkoc/phonebox/blob/main/docs/README.nl.md) ·\n  [Polski](https://github.com/ersinkoc/phonebox/blob/main/docs/README.pl.md) ·\n  [Русский](https://github.com/ersinkoc/phonebox/blob/main/docs/README.ru.md) ·\n  [Ελληνικά](https://github.com/ersinkoc/phonebox/blob/main/docs/README.el.md) ·\n  [Tiếng Việt](https://github.com/ersinkoc/phonebox/blob/main/docs/README.vi.md) ·\n  [中文 (简体)](https://github.com/ersinkoc/phonebox/blob/main/docs/README.zh.md)\n\n**Turn an old Android phone into a desk panel for your computer.**\n\nPC stats, AI coding sessions, music and touch controls over USB or Wi-Fi.\n\nWindows, Linux and macOS. No root, PhoneBox account or cloud service required.\n\n[**Try the live demo**](https://ersinkoc.github.io/phonebox/) ·\n  [**Download**](https://github.com/ersinkoc/phonebox/releases/latest) ·\n  **Quick start**\n\n<sub>Example layouts with demo data.</sub>\n\nPhoneBox pairs a full-screen **Android app** with a small **desktop agent**. Build your panel in a browser-based\nvisual editor: **126 widgets**, **30 templates**, multiple pages and a live preview. Connect several phones with\ntheir own layouts, or switch one phone between paired computers.\n\n| Use it for | What appears on the phone | \n|---|---|\n| **PC monitoring** | CPU, GPU, RAM, disks, network and ping; charts, GPU details and process controls | \n| **AI coding** | Claude, Codex and Antigravity quotas, reset times and burn-rate forecasts; local Claude Code, Codex and OpenCode sessions (native and inside WSL); GitHub reviews and CI status | \n| **Touch controls** | App and URL shortcuts, key combinations and macros; application audio, microphone, media, OBS and system controls through [Control Deck](https://github.com/ersinkoc/phonebox/blob/main/docs/CONTROL-DECK.md) | \n| **Everyday use** | Now Playing, internet radio, clocks, weather, calendars, notes, checklists, pomodoro and timers | \n| **Automation** | Webhook values and notifications, Home Assistant controls and rules that react to activity on the computer | \n\nTap an AI session for its model, timing and token details. Opt in to Codex, Claude Code or OpenCode permission prompts\nto answer **Allow**, **Deny** (and **Always allow** for OpenCode) from the phone. Optional\n[CodexBar integration](https://github.com/ersinkoc/phonebox/blob/main/docs/GUIDE.md#widgets) adds quota providers and a cost overview.\n\n<sub>A tour with demo data: notifications, permission prompts and automatic page switching. [Watch the MP4](https://github.com/ersinkoc/phonebox/blob/main/docs/tour-0.6.mp4)</sub>\n\nYou need an **Android 5+ phone** (Android 6 or later recommended) and a supported computer. USB uses a data cable and USB debugging; Wi-Fi pairing\nworks without either. Release agents include .NET, so you do not need to install the runtime.\n\n**Windows 10/11 x64** — paste into a normal PowerShell window:\n\n```\nirm https://raw.githubusercontent.com/ersinkoc/phonebox/main/setup.ps1 | iex\n```\n\n**Linux or macOS** — run as your own user:\n\n```\ncurl -fsSL https://raw.githubusercontent.com/ersinkoc/phonebox/main/setup.sh | bash\n```\n\nSetup downloads the latest release, checks its SHA-256 checksum, offers missing dependencies and start-at-login,\nand opens the settings at [http://127.0.0.1:8765](http://127.0.0.1:8765). It can also install the Android app over USB.\nRun setup again to update or repair the installation while keeping settings and pairings.\n\n**Windows signing:** release agents are currently unsigned while the SignPath Foundation application is pending.\nSmartScreen or antivirus software may warn or block them. See the [code signing policy](#code-signing-policy)\nand [installation warnings](https://github.com/ersinkoc/phonebox/blob/main/docs/SETUP.md#quick-start). USB debugging should be authorized only on computers you trust.\n\nRead the scripts before running them: [Windows](https://github.com/ersinkoc/phonebox/blob/main/setup.ps1) · [Linux/macOS](https://github.com/ersinkoc/phonebox/blob/main/setup.sh).\nThe [installation guide](https://github.com/ersinkoc/phonebox/blob/main/docs/SETUP.md) covers options, dependencies, install paths, troubleshooting and uninstalling.\n\n| USB | Wi-Fi only | \n|---|---|\n| Enable **Developer options → USB debugging** , connect a data cable and accept the phone's authorization prompt. Let setup install the app, or use**Settings → General → Install the phone app** . | Install the APK from the [latest release](https://github.com/ersinkoc/phonebox/releases/latest) . Wi-Fi is off by default: open the settings page (tray icon, or`http://127.0.0.1:8765` ), turn on**General → Wi-Fi & Tailscale → Let the phone connect without the USB cable** , click**Save** , then**Restart to apply** at the top. Choose**Pair a phone over Wi-Fi** , scan the pairing QR code and confirm the matching check code. | \n| Wakes and opens the panel on connection; supports app updates over adb. | No adb or developer options needed; install app updates manually unless you later configure USB. | \n\nThe phone app is not in any app store; it comes only from this repository's releases. It runs on Android 5.0 and newer; there is no iOS version.\n\nFor automatic USB/Wi-Fi fallback, enable Wi-Fi and connect the phone over USB once.\n[Connection details and Tailscale setup →](https://github.com/ersinkoc/phonebox/blob/main/docs/SETUP.md#wi-fi--tailscale)\n\nOpen [http://127.0.0.1:8765](http://127.0.0.1:8765) (or double-click the Windows tray icon). Under **Pages**, choose a template, drag and\nresize widgets, then **Save**. Use **Live preview** to see unsaved edits with live data.\nSwipe, tap the page dots or use the phone's volume keys to move between pages.\n\n## **Other installation methods**\n\n- \n**Manual download:** unzip the agent for your system from the[release page](https://github.com/ersinkoc/phonebox/releases/latest) and run it. Install the APK on the phone. Checksums and build provenance accompany the release assets.\n- \n**Scoop (Windows):**\n\n```\nscoop bucket add phonebox https://github.com/ersinkoc/phonebox\nscoop install main/adb phonebox/phonebox\n```\n\n- \n**From source:** see the[installation guide](https://github.com/ersinkoc/phonebox/blob/main/docs/SETUP.md#other-ways-to-install) and[development guide](https://github.com/ersinkoc/phonebox/blob/main/docs/DEVELOPMENT.md) .\n- \n**winget:** manifests are prepared in[packaging/winget](https://github.com/ersinkoc/phonebox/blob/main/packaging/winget) ; see the installation guide for details.\n\nStart with Home, System, AI quotas, Sessions, Music, Planner, Automation or a Control Deck template, then adapt the 12 × 6 grid to your phone. Portrait and landscape layouts are supported. Smart Stack puts up to 12 widgets in one slot.\n\n| Home | AI sessions | \n|---|---|\n| **System** | **Layout editor** | \n\nScreenshots use demo data. [Browse the template gallery and widgets](https://github.com/ersinkoc/phonebox/blob/main/docs/GUIDE.md#pages--templates).\nChange fonts, size, spacing, corners and surfaces globally or for one page or widget with the [appearance guide](https://github.com/ersinkoc/phonebox/blob/main/docs/APPEARANCE.md).\n\n|  | Windows | Linux | macOS | \n|---|---|---|---|\n| Release builds | x64 | x64 / ARM64, glibc | Apple silicon / Intel | \n| CPU, RAM, disks, network, processes | ✓ | ✓ | ✓ | \n| GPU data | Windows counters; NVIDIA via `nvidia-smi` ; extra sensors via[LibreHardwareMonitor](https://github.com/ersinkoc/phonebox/blob/main/docs/SETUP.md#librehardwaremonitor-on-windows) | NVIDIA / AMD; Intel clock | Apple silicon, when exposed by macOS | \n| Media | System media sessions | `playerctl` | `nowplaying-cli` ; Spotify / Music fallback | \n| Volume | Native | `wpctl` /`pactl` | System output; availability varies by device | \n| Agent interface | Tray icon + browser settings | Browser settings | Browser settings | \n\nWidgets depend on the host's hardware, installed tools and permissions. Advanced Control Deck features have\n[their own platform requirements](https://github.com/ersinkoc/phonebox/blob/main/docs/CONTROL-DECK.md). Windows ARM and musl Linux (such as Alpine) do not have\nrelease builds. See the [full compatibility table](https://github.com/ersinkoc/phonebox/blob/main/docs/SETUP.md#what-works-where).\n\n| Guide | Contents | \n|---|---|\n| [Installation and connections](https://github.com/ersinkoc/phonebox/blob/main/docs/SETUP.md) | Setup options, warnings, manual and source installs, USB, Wi-Fi, Tailscale, updates, uninstall and troubleshooting | \n| [User guide](https://github.com/ersinkoc/phonebox/blob/main/docs/GUIDE.md) | Template gallery, widgets, AI integrations, editor, Claude Code prompts, webhooks and automation rules | \n| [Appearance](https://github.com/ersinkoc/phonebox/blob/main/docs/APPEARANCE.md) | Fonts, surfaces, presets, inheritance and live preview | \n| [Control Deck](https://github.com/ersinkoc/phonebox/blob/main/docs/CONTROL-DECK.md) | Audio, media, OBS, shortcuts, tasks, protocols, dependencies and platform limits | \n| [Discord widget](https://github.com/ersinkoc/phonebox/blob/main/docs/DISCORD.md) | Creating the Discord application, connecting it, controls and troubleshooting | \n| [Development](https://github.com/ersinkoc/phonebox/blob/main/docs/DEVELOPMENT.md) | Architecture, local demo, builds, tests, widget sources and isolated agent runs | \n| [Contributing](https://github.com/ersinkoc/phonebox/blob/main/CONTRIBUTING.md) | Contribution scope, review expectations, privacy and required checks | \n| [Changelog](https://github.com/ersinkoc/phonebox/blob/main/CHANGELOG.md) | Release history and unreleased changes | \n| [Release checklist](https://github.com/ersinkoc/phonebox/blob/main/docs/RELEASING.md) | Maintainer build, signing and publication workflow | \n\nThe [UMIDIGI BISON extras](https://github.com/ersinkoc/phonebox/blob/main/extras/umidigi-bison) contain the reversible, no-root tune-up used on the original development phone.\n\nAdd-ons are written and maintained by their authors. PhoneBox doesn't review or ship them. They run with your own\nrights on the computer and can change PhoneBox settings through `PUT /api/settings`, so read what an add-on does\nbefore you install it.\n\n| Add-on | What it does | What it sends outside the PC | \n|---|---|---|\n| [PhoneBox Games Tab](https://github.com/lucasaz/phonebox-games-tab) (Windows) | A Games page with live FPS, cover art and play time, through the push API and a Custom HTML widget | Store / Xbox apps' package names, with the Windows display language and region, to the Microsoft Store catalog ( `displaycatalog.mp.microsoft.com` ); the phone loads cover images from Microsoft's image servers and from Steam's, whose URL contains the game's Steam app ID | \n\nThe desktop settings server listens on `127.0.0.1:8765`. USB reaches the agent through `adb reverse` on a loopback\nport of its own, over TLS pinned like Wi-Fi, with a key the phone app makes and the agent reads over adb.\nOptional Wi-Fi uses HTTPS on port 8766 with a pinned certificate and a paired key. Settings and pairing endpoints\nstay local. The phone requests configured actions by ID; commands and integration credentials stay on the computer.\n\nPhoneBox has no telemetry, analytics or accounts of its own. Optional widgets and integrations contact external\nservices for weather, quotas, GitHub and other data, and the agent checks GitHub for updates.\nSupported public feeds can fall back through the agent over USB when the phone has no internet.\nThe [privacy policy](https://github.com/ersinkoc/phonebox/blob/main/PRIVACY.md) lists outbound connections and how to disable them.\nRead the [security details](https://github.com/ersinkoc/phonebox/blob/main/docs/GUIDE.md#security--privacy). To report a vulnerability, follow [SECURITY.md](https://github.com/ersinkoc/phonebox/blob/main/SECURITY.md).\n\nThe agent uses **.NET 10**; the Android app uses **Kotlin and a WebView** with plain JavaScript widgets.\nFor Android builds, install **JDK 17** and **Android SDK Platform 35** (the SDK the app is built with; the app itself\nruns on Android 5.0, API 21, and later).\nPreview the panel and editor from source with Python 3, using simulated data:\n\n```\npython tools/demo-server.py\n```\n\nOpen [http://127.0.0.1:8790/panel/](http://127.0.0.1:8790/panel/) or [http://127.0.0.1:8790/settings/](http://127.0.0.1:8790/settings/).\nSee [development commands](https://github.com/ersinkoc/phonebox/blob/main/docs/DEVELOPMENT.md#development) for running the agent, building the APK and testing changes.\nContributions are welcome; start with [CONTRIBUTING.md](https://github.com/ersinkoc/phonebox/blob/main/CONTRIBUTING.md).\n\nFree code signing provided by [SignPath.io](https://about.signpath.io/), certificate by\n[SignPath Foundation](https://signpath.org/).\n\n- **Windows agent:** the SignPath Foundation application is pending; releases are unsigned until approved.\nThe intended signing target is`PhoneBoxAgent.exe` in the`win-x64` release zip, built by the[release workflow](https://github.com/ersinkoc/phonebox/blob/main/.github/workflows/release.yml) . Every signing request requires manual approval.\nBundled runtime and library notices are in[THIRD-PARTY-NOTICES.txt](https://github.com/ersinkoc/phonebox/blob/main/agent/PhoneBox.Agent/THIRD-PARTY-NOTICES.txt) .\n- **Android app:** release APKs use the project's own signing key, independently of SignPath.\n- **Team roles:** committer, reviewer and signing approver:[ersinkoc](https://github.com/ersinkoc) .\nPull requests from other contributors are reviewed before merging.\n- **Privacy:** see the[privacy policy](https://github.com/ersinkoc/phonebox/blob/main/PRIVACY.md) .\n\nPeople who tested PhoneBox on their own hardware:\n\n- [anandyakshit](https://github.com/anandyakshit) : Android 7 support, on an Android 7.1.1 phone ([#73](https://github.com/ersinkoc/phonebox/issues/73) ).\n\n**Supported by [WrongStack](https://wrongstack.com)** ·\n  An open-source AI coding agent that remembers your codebase.\n\n[**Explore WrongStack →**](https://wrongstack.com) ·\n  **View on GitHub & give it a star ★**", "url": "https://wpnews.pro/news/show-hn-turn-an-old-android-phone-into-a-customizable-pc-control-deck", "canonical_source": "https://github.com/ersinkoc/phonebox", "published_at": "2026-11-21 10:29:11+00:00", "updated_at": "2026-11-21 11:13:16.180052+00:00", "lang": "en", "topics": ["developer-tools", "ai-tools", "ai-agents"], "entities": ["PhoneBox", "Ersin Koc", "Claude", "Codex", "Antigravity", "OpenCode", "SignPath Foundation", "Home Assistant"], "also_reported_by": [], "takeaway": "PhoneBox's Android app and desktop agent let developers monitor Claude, Codex and Antigravity quotas and answer Codex, Claude Code or OpenCode permission prompts (Allow, Deny, and Always allow for OpenCode) from a phone over USB or Wi-Fi.", "recommendation": null, "alternates": {"html": "https://wpnews.pro/news/show-hn-turn-an-old-android-phone-into-a-customizable-pc-control-deck", "markdown": "https://wpnews.pro/news/show-hn-turn-an-old-android-phone-into-a-customizable-pc-control-deck.md", "text": "https://wpnews.pro/news/show-hn-turn-an-old-android-phone-into-a-customizable-pc-control-deck.txt", "jsonld": "https://wpnews.pro/news/show-hn-turn-an-old-android-phone-into-a-customizable-pc-control-deck.jsonld"}}