claudeers.
// Integrations & Connectors

phonebox

Turn an old Android phone into a desk panel for your Windows PC: 41 widgets, visual layout editor, webhooks, PC stats, media, AI quotas, Claude Code sessions…

// Integrations & Connectors[ cli ][ api ][ desktop ][ web ][ mobile ][ claude ]#claude#android#claude-code#dashboard#desk-panel#dotnet#old-phone#stream-deck#integrations◷ MIT$open-sourceupdated 13 days ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up phonebox (release-binary project) into my current project.
Found on https://claudeers.com/phonebox
Repo: https://github.com/ersinkoc/phonebox
Homepage/docs: https://ersinkoc.github.io/phonebox/
Detected install method: release-binary → inspect the README
Category: integrations. Platforms: cli, api, desktop, web, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or install directly (release-binary)

Grab the latest release asset from GitHub.

# download a build from https://github.com/ersinkoc/phonebox/releases
// or clone
git clone https://github.com/ersinkoc/phonebox

// compatibility

Platformscli, api, desktop, web, mobile
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageC#

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

phonebox

PhoneBox

Turn an old Android phone into a desk panel for your computer: Windows, Linux or macOS.
Widgets for your PC, AI coding sessions, music, weather and anything you push to it. USB or Wi-Fi, no cloud.
▶ Try the live demo in your browser

PhoneBox on three phones: status, home and ambient pages

PhoneBox has two parts: a small Android app that runs full screen on the phone, and an agent on the computer (Windows, Linux or macOS) that feeds it over the USB cable (or over Wi-Fi / Tailscale after pairing once). You design the pages in a visual editor on the PC: 53 widgets, 23 templates, as many pages as you like.

  • Your PC at a glance: CPU, GPU, RAM, disks, network and ping; the heaviest apps, with "end one instance / end all".
  • AI coding: Claude and Codex quotas with a burn-rate forecast; every Claude Code / Codex session — the phone buzzes when one finishes or needs you, and Claude Code's permission prompts show up with Allow / Deny. GitHub review requests and your pull requests with CI status.
  • Desk companion: now playing with controls and volume, clocks, weather, sun & moon, air quality, calendar, pomodoro, timers, checklists, notes, a breathing exercise.
  • Stream Deck–style keys that launch apps, URLs or built-in actions on the PC.
  • Webhooks and rules: scripts, CI and Home Assistant push values and notifications; rules switch pages calmly when something happens (a call, music, an AI session waiting for you).

A tour of PhoneBox pages
A tour through the pages (made-up data). Full video (MP4)

Contents: Quick start · Pages & templates · Widgets · Layout editor · Claude Code prompts · Webhooks · Rules · Wi-Fi & Tailscale · Updates · How it works · Security · FAQ · Development

Quick start

You need an Android 9+ phone with USB debugging turned on, the .NET 10 SDK and adb.

Windows 10/11

winget install Microsoft.DotNet.SDK.10 Google.PlatformTools   # .NET 10 and adb
git clone https://github.com/ersinkoc/phonebox
cd phonebox
.\scripts\install.ps1 -Apk -Autostart   # agent + phone app, start with Windows (add -Serial <id> if several devices are connected)

Or install just the agent with Scoop and let it put the app on the phone (settings › General › Install the phone app, with the phone plugged in):

scoop bucket add phonebox https://github.com/ersinkoc/phonebox
scoop install phonebox/phonebox          # needs the .NET 10 Desktop Runtime and adb (scoop install extras/windowsdesktop-runtime main/adb)

A winget package (ersinkoc.PhoneBox) is prepared in packaging/winget for submission to winget-pkgs; once accepted it installs with winget install ersinkoc.PhoneBox.

Linux (Ubuntu, Debian, Fedora, Arch…) and macOS

sudo apt install adb playerctl          # Fedora: android-tools playerctl · macOS: brew install android-platform-tools
git clone https://github.com/ersinkoc/phonebox
cd phonebox
./scripts/install.sh --apk --autostart  # agent + phone app; systemd user service (Linux) or launchd agent (macOS)

Plug the phone in: it wakes up and opens the panel. The settings are at http://127.0.0.1:8765 (on Windows also from the tray icon). scripts/uninstall.ps1 [-Purge] [-Apk] / scripts/uninstall.sh [--purge] [--apk] remove everything again.

What works where
WindowsLinuxmacOS
CPU, RAM, network, disks, ping✓✓✓
CPU temperatureLibreHardwareMonitor✓ (hwmon)—
NVIDIA GPU✓✓—
Now playing + controls✓ (any app)✓ (MPRIS via playerctl)Spotify, Music
Volume✓✓ (wpctl / pactl)✓
Processes, end one / all✓✓ (your own)✓ (your own)
App icons✓✓ (icon theme)✓ (app bundles)
Shortcuts, lock, screen off✓✓ (loginctl, xset)✓ (open, pmset)
Command widgetsPowerShellbashzsh
Claude / Codex quotas & sessions, GitHub, webhooks✓✓✓ (Claude token from the Keychain)
Tray icon✓— (settings in the browser)—
Start at loginStartup foldersystemd user servicelaunchd agent

Optional extras that light up more widgets: an NVIDIA GPU (nvidia-smi), the GitHub CLI (gh auth login), Claude Code, Codex, and LibreHardwareMonitor with its web server on port 8085 for the CPU temperature.

Pages & templates

Every page is a 12 × 6 grid. Start a page from one of the 23 templates (or from scratch) and change anything.

Home — clock, weather, now playing, CPU / GPU / RAM / network tilesDashboard — gauges, clock, media and a few shortcut keys
HomeDashboard
AI quotas — Claude and Codex limits, reset times, "at this pace: full in 1 d 5 h"Sessions — Claude Code / Codex sessions and GitHub
AI quotasSessions
System — CPU, GPU, memory, disks, network and ping chartsProcesses — heaviest apps; tap one to end an instance or all of them
SystemProcesses
Status — quota rings, phone battery, top CPU, volume, sessionsAmbient — analog clock, sun & moon, air quality, quote, forecast
StatusAmbient
Markets — exchange rates, crypto, Hacker NewsFeeds — values and notifications pushed by webhooks
MarketsFeeds
Daily — checklist, time progress, timer, counter, stopwatchWorld — world clocks, hourly forecast, calendar
DailyWorld
Music — a big now-playing cardShortcuts — Stream Deck–style keys
MusicShortcuts
Planner — next up, month, agenda, checklistAutomation — rules, on air, pushed values, device batteries, notifications
PlannerAutomation
Nightstand — word clock, moon, battery care, next hoursDeep work — pomodoro, next up, sessions, quota ring, rules
NightstandDeep work

More templates: Clock, Focus (pomodoro + note), Calm (breathing), DevOps (command widgets) and Weekend (forecast, music, moon, analog clock, quote).

Getting around. Swipe; press the phone's volume keys to flip pages; tap the page dots (or long-press an empty spot) for an overview of all pages and jump straight to one. Webhooks and rules can switch pages too; they count down first ("switching to AI in 3…", with Stay and Go now) and never pull a page away while you are using the panel. The panel returns to the home page when idle (each page can stay longer, or for good), can dim to a clock at night and keeps the screen on.

Page overview

Widgets

CategoryWidgets
TimeClock (with status line and weather) · Analog clock (any time zone) · Word clock · World clocks · Calendar · Next up · Time progress (day / week / month / year) · Countdown · Pomodoro · Quick timer · Stopwatch
Weather & skyWeather · Forecast (hourly / 7 days) · Sun & moon (daylight left, UV, moon phase) · Moon · Air quality (European AQI, PM2.5, PM10, O₃, NO₂)
ComputerRules (which hold, pause) · Battery care · On air (microphone / camera / OBS) · OBS Studio (live, recording, scenes) · Device batteries (headphones, mice, keyboards) · Docker (containers, start / stop) · Metric tile · Gauge · Chart · Memory & disks · Top processes · Processes · Now playing · Volume · Shortcut grid · Big button · Command (PowerShell / bash / zsh output, refreshed every N seconds)
AI & codeAI quotas · Quota ring · AI sessions · GitHub
PersonalAgenda (Google / Outlook / iCloud calendars) · Note · Checklist (resets daily) · Counter · Breathe · Quote · Title · Phone battery
Web & dataCustom HTML (your own widget, sandboxed) · Home Assistant (entities, tap to switch) · Pushed value · Notifications (both fed by webhooks) · Hacker News · Exchange rates (ECB) · Crypto prices · Image / webcam

Widgets scale to the size you give them. Weather, air quality, rates, crypto and Hacker News come straight from free public APIs (Open-Meteo, Frankfurter, CoinGecko, HN) on the phone, without API keys, and keep their last data when offline.

Layout editor & settings

Double-click the tray icon on Windows (or open http://127.0.0.1:8765):

The layout editor

  • Pages: add pages from templates, reorder, show/hide, export and import them as files, choose how long each page may stay before the panel goes home; arrange widgets on a phone-sized canvas (drag to move, drag the corner to resize) and set their options. The widget palette is grouped by category and searchable. Live preview swaps the canvas for the real panel with your unsaved changes and live data.
  • Rules: automations, see Rules.
  • Shortcuts: add, edit, reorder and test keys (label, emoji, colour). A key runs a program, presses a key combination (ctrl+shift+m), types text or runs a macro (keys, text, waits, other shortcuts); on / off keys show their state on the phone (mute does by itself, others from a pushed value).
  • Webhooks: the webhook key, copy-paste examples, test buttons and the values pushed so far.
  • General: weather location search; calendars (ICS links from Google, Outlook or iCloud), Home Assistant and OBS connections; night mode; theme and accent colour, orientation (landscape, portrait or both), clock seconds, vibration, volume-key paging and the phone's sensors (brightness that follows the room, the night screen when the room goes dark, wave to wake it); page switching (home page, countdown, back home after); kiosk options (screen pinning, the panel as the phone's home screen so it starts after a reboot, keep the phone awake on the charger; no root needed); battery care; Claude Code permission prompts; phones (several at once, each with its own pages); Wi-Fi & Tailscale; updates.
  • Advanced: the raw JSON.

Settings live in %APPDATA%\PhoneBox\config.json (Linux: ~/.config/PhoneBox, macOS: ~/Library/Application Support/PhoneBox); the phone picks up changes within a few seconds.

Claude Code permission prompts

When Claude Code asks for permission (run a command, edit a file, use an MCP tool…), the phone shows the request — project, tool and the command or file — with Allow and Deny. Turn it on in Settings › General › Claude Code permission prompts and press Install hook: PhoneBox adds a PermissionRequest hook to ~/.claude/settings.json (and keeps a backup next to it as settings.json.phonebox.bak). If the phone is not connected or nobody answers in time, the hook returns no decision and Claude Code asks in the terminal as usual. Optionally only when you have been away from the keyboard for a minute.

Webhooks

The agent accepts data as well as serving it, so anything that can make an HTTP request can put things on the panel:

curl -X POST http://127.0.0.1:8765/api/push/temperature -d 21.5                     # shown by a "Pushed value" widget with key "temperature"
curl -X POST http://127.0.0.1:8765/api/push/build -H "Content-Type: application/json" \
     -d '{"value":"passed","sub":"main · 3m 12s"}'
curl -X POST "http://127.0.0.1:8765/api/push/door?ttl=600" -d open                    # expires after 10 minutes
curl -X POST http://127.0.0.1:8765/api/notify -H "Content-Type: application/json" \
     -d '{"title":"Deploy","text":"Production is live","level":"ok","page":"feeds"}' # toast + vibration (+ switch page)
curl -X POST http://127.0.0.1:8765/api/goto/music                                     # switch the phone to a page (id or number)
curl -X POST "http://127.0.0.1:8765/api/goto/music?countdown=0"                        # …without the on-screen countdown
curl -X POST http://127.0.0.1:8765/api/refresh                                        # refresh quotas/GitHub and the panel now (?reload=1 reloads it)
Payload fieldMeaning
value, title, sub, unit, icon, colorWhat the widget shows. Plain text or a number works too.
levelok / warn / error colours it; values like passed, failed, running are coloured automatically.
progress0–1 or 0–100: a bar under the value, or the ring in gauge style.
itemsA list (strings or {label, value, level}) for the list style.
ttlSeconds until the value disappears (also ?ttl=).

Notifications take title, text, level, vibrate, seconds, wake (light up the night screen) and page. GET /api/push lists the values and DELETE /api/push/<key> removes one; values survive restarts.

From this PC no key is needed. With Wi-Fi on, other machines on the network or Tailscale can use the same endpoints on https://<pc>:8766 with the webhook key from the settings (Authorization: Bearer <key>, or ?token=<key> for senders that cannot set headers). That key opens only the webhook endpoints, never the phone API.

Rules

Settings › Rules lets the panel react to what happens on the computer. Each rule is when → then:

WhenThen
an AI session needs you / is working (optionally for some projects)show a page
music or video plays (optionally in some apps: Spotify|Music)show a notification ({detail} = what happened)
an app is running (zoom|Teams|obs64)push a value (e.g. onair, shown by a Pushed value widget)
the microphone / the camera is in use (Windows, Linux)
a calendar event is on (optionally by title)
OBS is recording or streaming
the CPU stays above a percentage for 15 s
you have been away from the keyboard for N minutes
it is between two times (22:00-07:00)
a pushed value is on, or above / below / equal to a value (a webhook from Home Assistant, a doorbell…)run a shortcut
an AI quota is above a percentage
a GitHub review is requested · CI fails on my pull request
a device battery is low · the network is slow or unreachable
always (with the days and hours below, for schedules)

Every rule can also be limited to some days and some hours, act only when its condition lasts N seconds, rest for a while before acting again, and has a priority and its own countdown for page switches.

Page switches are calm. The phone counts down before a rule changes the page ("Claude needs me — switching to AI in 3…", tap Stay to keep the page or Go now), waits while you are using the panel, keeps a minimum time between two automatic switches and lets the higher-priority rule go first; rules that end before their turn are dropped, so a burst of rules never bounces the screen back and forth. Settings › General › Page switching sets the countdown, how long to wait after a touch, the minimum time between switches, the home page and how long a rule may keep its page. The phone's overview (and the Rules widget) pauses all rules for an hour.

With only while it lasts, the effect ends with the condition: the phone goes back to the page it was on (unless you moved on yourself) and stays on the rule's page instead of returning home when idle; a pushed value is removed again. The editor starts from examples (Claude needs me → AI page, music → Music page, on air during calls, CPU busy, away → Ambient, evenings → Calm, doorbell, quota warning, review requested, CI failed, workday mornings, low battery, too warm) and has a Test button for each rule.

Battery care (Settings › General) keeps the phone's battery between two levels, 50–80 % by default, so a panel that is always plugged in lasts longer. Phones cannot stop charging without root, so PhoneBox switches the power where it comes from: a smart plug in Home Assistant, or two shortcuts (for example uhubctl for a USB hub with switchable ports). The panel keeps running over Wi-Fi while the USB power is off.

Wi-Fi & Tailscale

Turn on Settings › General › Wi-Fi & Tailscale, restart the agent when asked, and plug the phone in once. Over USB the phone receives the PC's addresses, a secret key and the fingerprint of the agent's self-signed TLS certificate. When the cable is unplugged it switches to https://<pc>:8766 automatically and back to USB when it is plugged in again; the status line shows which one it uses.

  • The phone and the PC need to be on the same network. If they are not (separate Wi-Fi networks, another building…), install Tailscale on both: the agent offers its Tailscale address too.
  • Windows Firewall asks once when Wi-Fi is turned on; allow it for the network types you use.
  • The screen stays on, so the phone still needs a charger — just not necessarily the PC.

With several computers (each paired once over USB), the page overview on the phone lists them and switches between them over Wi-Fi.

Updates

The agent checks the latest GitHub release every 6 hours (or Settings › General › Updates › Check now) and, with automatic updates on, installs the new APK on the phone with adb install -r while it is plugged in (no prompt on the phone; over Wi-Fi the panel shows "plug in USB to update") and replaces its own files, then restarts. Android only accepts an update signed with the same key as the installed app; the agent never uninstalls to force one. See the changelog.

How it works

flowchart LR
  subgraph Phone["Android phone"]
    UI["Panel UI<br/>(WebView, assets/www)"] -->|"/agent/*"| Proxy["Native proxy<br/>(AgentLink)"]
    UI -->|weather, rates, HN| Web(("Public APIs"))
  end
  subgraph PC["Windows / Linux / macOS"]
    Agent["PhoneBox agent<br/>(.NET 10)"]
    Agent --- Mon["System, GPU, media, volume,<br/>processes, sessions, quotas, GitHub"]
    Agent --- Set["Settings page &<br/>layout editor"]
  end
  Proxy -->|"USB: adb reverse → 127.0.0.1:8765"| Agent
  Proxy -.->|"Wi-Fi / Tailscale: HTTPS :8766,<br/>pinned certificate + key"| Agent
  Hooks["Scripts, CI,<br/>Home Assistant"] -->|webhooks| Agent
  • The WebView never talks to the PC directly: requests to /agent/* are intercepted by the app and forwarded over the adb tunnel (or the pinned HTTPS connection), so there are no CORS, mixed-content or local-network issues.
  • Live events (page switches, notifications, permission prompts) arrive over one server-sent-events stream (/api/stream); plain polling remains as the fallback.
  • The agent samples only what is on screen: process lists and command widgets run only while a phone looks at them.

Security & privacy

  • The agent listens on 127.0.0.1 only. Requests with a foreign Host header (DNS rebinding) or a cross-site Origin (CSRF) are rejected; only the settings page itself is accepted from browsers.
  • The optional Wi-Fi port (8766) only serves the panel API, only over TLS pinned to the paired certificate, and only with the paired key. Settings, shortcut tests and pairing stay local. New key in the settings unpairs all phones.
  • The phone only ever sends a shortcut id; commands are defined on the PC. Command widgets work the same way: the phone asks for a widget's output and never sees the command.
  • Webhooks from other machines need the separate webhook key, which cannot open the phone API and can be replaced on its own.
  • Ending processes is limited to your own session, never touches a list of Windows-critical processes, and can be switched off in the processes widget's options.
  • Claude Code permission prompts are opt-in. The hook only posts the request to the agent on 127.0.0.1; the phone can only answer allow or deny for that one request.
  • Claude quota: read with the OAuth token Claude Code stores in ~/.claude/.credentials.json, sent only to api.anthropic.com/api/oauth/usage (the endpoint behind Claude Code's /usage). The token is read-only: PhoneBox never refreshes it, so it can't interfere with Claude Code. This endpoint is undocumented and may change.
  • Codex quota and sessions are read from local files in ~/.codex/sessions; Claude Code sessions from ~/.claude/sessions. Nothing leaves your machine except the requests listed above.

FAQ & troubleshooting

The panel says "PC not connected".

Is the agent running (tray icon)? Run adb devices: the phone must be listed as device, not unauthorized — accept the USB debugging prompt on the phone. If several devices are connected, pick the phone under Settings › General › Phone connection. Over Wi-Fi, pair once over USB and allow the agent in Windows Firewall.

Some widgets show "—" or "No data".

GPU values need an NVIDIA GPU (nvidia-smi), CPU temperature needs LibreHardwareMonitor's web server on port 8085, GitHub needs gh auth login, quotas and sessions need Claude Code / Codex to have been used on this PC.

I want the volume keys to change the phone's volume.

Turn off Settings › General › Display › The phone's volume keys switch pages.

The update was not installed on the phone.

App updates need USB (Android installs them through adb without a prompt). They also need to be signed with the same key as the installed app — if you built the app yourself, keep using your own release key.

Can I use it without root?

Yes. PhoneBox needs no root on the phone and no admin rights on the PC.

Development

python tools/demo-server.py                  # panel + settings page with made-up data: http://127.0.0.1:8790 and /settings
dotnet test agent/PhoneBox.Agent.Tests       # agent unit tests
cd tools/ui-tests; npm ci; npx playwright test; cd ../..   # browser tests of the panel and settings (against the demo)
.\scripts\build.ps1                          # dist\PhoneBox-<v>.apk + dist\PhoneBoxAgent-<v>-win-x64.zip
cd android; .\gradlew.bat assembleDebug      # APK only
dotnet run --project agent/PhoneBox.Agent    # agent from source
pwsh tools/make-icon.ps1                     # regenerate the .ico

The demo server needs only Python: size the browser window to 780 × 360 (the phone's screen in CSS pixels) and the panel behaves as on the phone, including webhooks (curl -X POST http://127.0.0.1:8790/api/notify -d hello).

The panel is plain ES modules: main.js (core, pages, navigation, data from the agent) and the widgets in widgets/. A widget is a { needs, create(box, ctx) → { update(kind) } } entry in the W registry, plus its styles in style.css and its catalogue entry (name, size, options) in widgets.json, which drives the settings editor. Templates live in templates.json.

Release APKs are signed with your own key when PHONEBOX_STORE_FILE, PHONEBOX_STORE_PASSWORD, PHONEBOX_KEY_ALIAS and PHONEBOX_KEY_PASSWORD are set (in ~/.gradle/gradle.properties or the environment); otherwise the debug key is used. Debug builds make the WebView debuggable through chrome://inspect. To publish a release: bump the version in PhoneBox.Agent.csproj and android/app/build.gradle.kts, commit, then run .\scripts\release.ps1.

Extras

extras/umidigi-bison has the reversible, no-root tune-up (debloat list, settings) used on the phone PhoneBox was built for.

License

MIT

// faq

What is phonebox?

Turn an old Android phone into a desk panel for your Windows PC: 41 widgets, visual layout editor, webhooks, PC stats, media, AI quotas, Claude Code sessions, GitHub and shortcuts. USB or Wi-Fi, no cloud.. It is open-source on GitHub.

Is phonebox free to use?

phonebox is open-source under the MIT license, so it is free to use.

What category does phonebox belong to?

phonebox is listed under integrations in the Claudeers registry of Claude-compatible tools.

29 views
★ 22 stars
unclaimed
updated 13 days ago

// embed badge

phonebox on Claudeers
[![Claudeers](https://claudeers.com/api/badge/phonebox.svg)](https://claudeers.com/phonebox)

// retro hit counter

phonebox hit counter
[![Hits](https://claudeers.com/api/counter/phonebox.svg)](https://claudeers.com/phonebox)

// reviews

// guestbook

0/500

// related in Integrations & Connectors

🔓

Use claude code and codex for free in the terminal, VSCode extension, and discord like OpenClaw (voice supported)

// integrationsAlishahryar1/⟨Python⟩★ 72,248◷ MIT[ claude ]
🔓

Bridge local AI coding agents (Claude Code, Cursor, Gemini CLI, Codex) to messaging platforms (Feishu/Lark, DingTalk, Slack, Telegram, Discord, LINE, WeChat…

// integrationschenhg5/⟨Go⟩★ 16,316[ claude ]
🔓

All parts of Claude Code's system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusli…

// integrationsPiebald-AI/⟨JavaScript⟩★ 13,191◷ MIT[ claude ]
🔓

Claude Code skill/plugin: immersive scroll-scrubbed 'fly through the world' landing pages generated with Higgsfield (Emons-style diorama flights, seamless co…

// integrationsoso95/⟨JavaScript⟩★ 11,032◷ MIT[ claude ]
→ see how phonebox connects across the ecosystem