pull/this/repo
RepoPrivacy, phones and devices#stream-deck-alternative#android#obs#windows

PhoneBox: turn an old Android phone into a free Stream Deck for your PC

By Pull This RepoPosted 5 min read

Short answer

PhoneBox is a free, MIT-licensed app that turns an old Android phone into a touch control panel for a Windows, Mac or Linux computer. Buttons open apps, send shortcuts and mute your mic, and the panel shows music, live CPU and GPU stats and OBS controls. A small agent runs on the computer. A 15-key Stream Deck was $119.99 on sale.

PhoneBox turns the old Android phone in your drawer into a touch control panel for your computer. Buttons open apps, fire keyboard shortcuts and mute your mic, and the same screen shows your music, live CPU and GPU stats and OBS scene controls. It is free and open source. The paid gadget people compare it to, a 15-key Elgato Stream Deck, was $119.99 on sale ($149.99 list) on Elgato's US store when we checked on 16 November 2026.

What is PhoneBox?

PhoneBox is two pieces: a full-screen Android app and a small desktop agent for Windows 10 and 11, macOS or Linux. The agent reads your computer's stats and carries out the commands you tap on the phone. You design the panel in a visual editor that opens in your browser.

The repo was created on 7 November 2026 and had 3,199 stars when we checked on 18 November 2026. That is more than double the 1,496 it had when our video went out two days earlier. The code is MIT licensed and mostly C#. The latest release is v0.9.21.

From the README, the panel can show:

  • Touch controls: app and URL shortcuts, key combinations and macros, application audio, microphone, media, OBS and system controls
  • PC monitoring: CPU, GPU, RAM, disks, network and ping, with charts and process controls
  • Everyday widgets: Now Playing, internet radio, clocks, weather, calendars, notes, checklists and timers
  • Automation: webhook values, Home Assistant controls and rules that react to activity on the computer
  • AI coding panels: usage quotas and local coding sessions for a few AI coding tools

The editor now lists 123 widgets and 30 templates on a 12 by 6 grid, up from the 115 widgets in our guide. Layouts work with the phone upright or sideways, and several phones can each have their own layout.

How do you set up PhoneBox?

You need an Android phone, a supported computer and either a USB data cable or the same Wi-Fi network. When we made the video, the README asked for Android 7 or newer. It now says Android 5 or newer, with 6 or later recommended. There is no iPhone app.

1. Install the desktop agent. The README offers a one-line setup script. It downloads the latest release, checks its SHA-256 checksum and opens the settings page:

powershell
irm https://raw.githubusercontent.com/ersinkoc/phonebox/main/setup.ps1 | iex
terminal
curl -fsSL https://raw.githubusercontent.com/ersinkoc/phonebox/main/setup.sh | bash

The first line is for PowerShell on Windows, the second for Linux or macOS. The README itself says to read the scripts before running them. If you would rather see every file first, use the manual route: download the agent zip for your system, the .apk for the phone and the SHA256SUMS file from the latest release, then compare the hash. On Windows:

text
certutil -hashfile PhoneBoxAgent-<version>-win-x64.zip SHA256

On macOS or Linux, shasum -a 256 <file> does the same job. Unzip the agent and run it. Its settings open at http://127.0.0.1:8765.

Windows users can also use Scoop:

powershell
scoop bucket add phonebox https://github.com/ersinkoc/phonebox
scoop install main/adb phonebox/phonebox

2. Connect the phone. Pick one route:

USBWi-Fi only
Turn on Developer options, then USB debugging, plug in a data cable and accept the prompt on the phone. Let setup install the app, or use Settings, General, Install the phone app.Install the APK by hand. In the agent settings turn on General, Wi-Fi & Tailscale, save, restart, then choose Pair a phone over Wi-Fi, scan the QR code and confirm the check code.

USB wakes the panel when the phone connects and handles app updates. Wi-Fi needs no developer options, but you update the app by hand.

3. Build your panel. In the settings page open Pages, pick a template, drag and resize widgets, then Save. Live preview shows unsaved edits. On the phone, swipe, tap the page dots or use the volume keys to change pages.

How do you control OBS from your phone?

Three steps, from the project docs. In OBS, open Tools, WebSocket Server Settings, turn the server on and set a password. Enter that address and password in the PhoneBox agent settings. Then add an OBS widget to a page and turn on control. In the hosted demo we tapped a Camera scene and then Start recording, and the button switched to Stop recording.

A sensible first page for streamers: browser, music app, screenshot shortcut, mute mic, play and pause, next track, a volume slider, start recording and two scene buttons.

What is the catch?

  • Android only. There is no iOS version.
  • An agent has to keep running on your computer. It can start at login.
  • A touchscreen, not keys. No physical clicky buttons like a Stream Deck.
  • Unsigned on Windows. The README says the agents are unsigned while a SignPath Foundation application is pending, so SmartScreen or antivirus software may warn or block them.
  • Not every control works everywhere. The platform table shows GPU, media and volume support differing between Windows, Linux and macOS.
  • It is brand new and moves fast. The release number went from v0.9.11 to v0.9.21 in two days.

Who is PhoneBox for?

It suits streamers who want scene buttons and a mic mute without buying hardware, people with a spare Android phone and a desk stand, and anyone who wants their PC's temperatures and music on a second screen. If you need real keys you can press without looking, a hardware deck still does that better.

How does PhoneBox compare with other free Stream Deck apps?

AppWhat it isLicence
PhoneBoxAndroid panel plus a desktop agent for Windows, Mac and Linux, with stats, music and OBSMIT
Macro-Deckmacro pad for Windows with a phone or browser client and pluginsApache-2.0
DroidDeckAndroid phone as a Stream Deck for a Windows PC, with hotkeys, macros and per-app audioApache-2.0
edgepadAndroid phone as a trackpad, remote and control deckMIT

What did we run for the video?

We did not install PhoneBox on our own computer. Everything in the video is the authors' hosted live demo of the real panel, running in a browser with demo data, plus the GitHub page and Elgato's store page. The setup steps above come from the README and the setup docs. You can try the same demo yourself at ersinkoc.github.io/phonebox before installing anything.

For more ways to give old hardware a new job, see Free My TV, which cleans up the Google TV home screen, and Deadboard, a browser game about repairing a dead laptop motherboard.

Pull it. Stash it.

Questions people ask

Can I use an old Android phone as a Stream Deck?

Yes. PhoneBox runs a full-screen panel on the phone and a small agent on your computer. Touch buttons open apps and URLs, send key combinations and macros, control media, the microphone and OBS. It is a touchscreen, so there are no physical keys.

Is PhoneBox free?

Yes. It is open source under the MIT licence, and the README says it needs no root, no PhoneBox account and no cloud service. The phone app is not in any app store; it comes only from the repository's releases page.

Does PhoneBox work with an iPhone?

No. The README says there is no iOS version. The phone app runs on Android 5.0 and newer, with Android 6 or later recommended.

Can PhoneBox control OBS?

Yes. Turn on the WebSocket server in OBS under Tools, enter its address and password in the PhoneBox agent settings, then add an OBS widget to a page. The project's Control Deck docs list scenes, source visibility, recording and streaming.

Why does Windows warn about the PhoneBox agent?

The README says the release agents are unsigned while its SignPath Foundation application is pending, so SmartScreen or antivirus software may warn or block them. Its setup docs also mention Smart App Control on Windows 11.

Sources

  1. 1PhoneBox repository and README
  2. 2PhoneBox installation guide (docs/SETUP.md)
  3. 3PhoneBox Control Deck docs (docs/CONTROL-DECK.md)
  4. 4PhoneBox hosted live demo
  5. 5PhoneBox latest release (v0.9.21, 2026-11-18)
  6. 6GitHub API: ersinkoc/phonebox (stars, licence, language, created date, checked 2026-11-18)
  7. 7Elgato Stream Deck US product page (price read 2026-11-16)
  8. 8Macro-Deck-App/Macro-Deck
  9. 9ggfto/DroidDeck
  10. 10akshit-bansal11/edgepad

Get tomorrow's repo in your feed

One free, open source repo a day as a short video, shown working, with the catch named. Pull it. Stash it.