Watch without getting up.
Play, pause, seek, change the volume. Map the shortcuts your player supports and the PC answers like a TV.
ESP32-C3 · Open-source firmware · GPL-3.0
Streaming, vibe coding, presenting, shortcuts.
Hand your everyday keys to the remote beside you.
Already have a compatible remote? An ESP32-C3 board costs about $5 and a remote about $10; a full set runs about $15.
Prices are project estimates. Check compatibility before you buy.
OKpress once to play / pause
Give the remote you already own a second life
Standard Bluetooth HID; the system keyboard driver stays untouched
Special keys are converted on the board before they are sent
Single keys or combos, however you work
01 / SCENARIOS
No new workflow to learn.
Just the shortcuts you already use, in your hand.
Play, pause, seek, change the volume. Map the shortcuts your player supports and the PC answers like a TV.
Map confirm, cancel or any combo to the remote. The voice key is just another shortcut — no microphone audio is streamed.
Flip slides, step through photos, control music. Set the shortcuts once and keep your pace away from the keyboard.
02 / DEVICE INTERFACE
See the real device UI first, then try it yourself.
Xiaomi remotes use a preset; other remotes are learned key by key.
Key mappings, remote settings and runtime status on one page.
Every physical key gets a card: single keys, combos or media keys, as you like.
One Xiaomi preset and two learning slots, each keeping its own mapping and settings.
Check the Bluetooth link, the Wi-Fi window, free heap and the board pinout.
It plays automatically; click anything to take over.
Every new key it finds adds an editable card.
Press any key on the remote and its card shows up here.
Click the remote to take over any time, then open a new card to set its shortcut.
Pressing the same key again only highlights its card; nothing is added twice.A browser demo; no real device is connected. Autoplay stops as soon as you interact, and “Restart” clears the cards and mappings on this page before replaying it.
03 / BUILT TO BE SIMPLE
The bridging happens on the board; your PC just sees a standard Bluetooth keyboard. Open the web page only when you want to change something.
About $5 for the board, plus a compatible Bluetooth remote at around $10 — ideally one you already own.
It connects as a standard Bluetooth HID device and never modifies, replaces or injects a keyboard driver, which keeps it clear of anti-cheat, antivirus and system-stability trouble.
Connecting, Wi-Fi setup and key mapping each have their own entry. A device that already runs the firmware never needs reflashing just to change Wi-Fi.
All 13 keys are supported, including the special ones Windows usually cannot read; the board converts them to standard HID before sending them on.
The key path from remote to PC runs over Bluetooth; the config page’s Wi-Fi only opens inside its own time window.
The firmware ships under GPL-3.0-or-later, with readable source and config so you can keep improving it.
04 / COMPATIBILITY
The status below comes from the project README;
platforms that were not verified are not claimed as supported.
| Role | Device / platform | Project record |
|---|---|---|
| Board | ESP32-C3 · about $5 | Verified · the only supported MCU |
| Remote | Xiaomi Bluetooth Remote 2 Pro · RC003 | Verified · 13 keys + battery |
| Remote | China Mobile · CMCC_Voice_Remote | Verified · some physical keys do not respond |
| Remote | Other standard BLE remotes | Learning mode · verify per model |
| PC | Windows 10 / 11 | Verified |
| PC | Linux / macOS | Not verified |
| Mobile | iPhone / iPad · iOS | Not supported |
Bluetooth HID support on your PC and the browser requirement for the USB connection are two different things; the section below checks this browser for Web Serial.
05 / GET CONNECTED
A blank board gets the installer; a device that already runs the firmware can update, join Wi-Fi, show logs or open its config page.
Once you pick the port, the official component recognizes the device: a blank board is offered MiRemoteBridge; an existing device gets update, Wi-Fi, logs and its config page.
Loading the official component…
Erase installs and factory resets are still confirmed in the official ESP Web Tools dialog.
Checking Web Serial and the official component…