MiRemoteBridge

Product Introduction

1. Definition: MiRemoteBridge is an open-source firmware (GPL-3.0 licensed) for the ESP32-C3 microcontroller that functions as a Bluetooth Low Energy (BLE) to Human Interface Device (HID) bridge. It transforms compatible Bluetooth remotes into standard, driverless Bluetooth keyboards and media controllers for PCs.
2. Core Value Proposition: It exists to provide a universal, cost-effective, and non-invasive method for PC control, eliminating the need for custom drivers, administrative rights, or system modifications. Its primary value is enabling wireless PC control with a Bluetooth remote using a low-cost ESP32-C3 bridge, supporting advanced key remapping directly from a web browser.

Main Features

1. Driverless Bluetooth HID Emulation: The firmware configures the ESP32-C3 to advertise itself as a standard Bluetooth keyboard (HID profile) to the host PC. This means Windows, Linux, or macOS recognizes it as a generic input device, requiring no custom kernel drivers, driver signing, or system patching. This ensures broad compatibility and avoids conflicts with security software or anti-cheat systems.
2. Browser-Based Configuration & Key Remapping: All device setup—including initial Wi-Fi configuration, key mapping, and firmware updates—is performed through a Web Serial interface in a compatible browser (like Chrome or Edge). Users can remap any physical remote button to a single key, a key combination (e.g., Ctrl+S), or a media key (e.g., Play/Pause). This is done via a responsive web UI without needing to reflash the microcontroller.
3. Dual Remote Support Modes:
   • Preset Mode for Xiaomi RC003: Offers full, out-of-the-box support for all 13 keys on the Xiaomi Bluetooth Remote 2 Pro (model RC003), including special keys that are translated into standard HID codes on the ESP32-C3 before being sent to the PC.
   • Learning Mode for Generic BLE Remotes: For other Bluetooth remotes, the firmware can enter a learning mode. Each button press is captured as a raw BLE key code, which the user can then assign to a desired keyboard shortcut or media action within the web UI, enabling support for a wide range of remotes.

Problems Solved

1. Pain Point: The inability to use inexpensive, ubiquitous Bluetooth remotes (like those shipped with TV boxes) for PC control due to proprietary protocols or lack of HID driver support. Traditional solutions often involve sketchy third-party software that requires admin rights, injects drivers, or poses security risks.
2. Target Audience:
   • Home Theater PC (HTPC) Enthusiasts: Users who want couch-based control for media playback on a PC connected to a TV.
   • Presenters and Educators: Individuals who need to control slideshows (e.g., PowerPoint, Google Slides) or music playback remotely while moving around a room.
   • Productivity Hackers & Developers: Users seeking ergonomic or context-specific shortcut controllers for coding, video editing, or workflow automation ("vibe coding").
   • DIY and Open-Source Hardware Tinkerers: Makers interested in affordable IoT bridging projects with the ESP32-C3 platform.
3. Use Cases:
   • Couch Media Control: Playing, pausing, and seeking in VLC, Kodi, or Plex without a keyboard.
   • Remote Presentation Control: Advancing slides, starting a slideshow (F5), or controlling background music during a talk.
   • Hands-Confirm Shortcuts: Mapping a remote's "OK" button to "Enter" for code execution or dialog confirmation, or "Back" to "Escape."
   • Legacy Remote Revival: Giving old or unused Bluetooth remotes a new purpose as PC input devices.

Unique Advantages

1. Differentiation: Unlike software-based solutions (e.g., Unified Remote, EventGhost plugins) that run on the host OS, MiRemoteBridge is a hardware bridge. It offloads all translation and emulation to the external ESP32-C3 device. This makes it more secure (no OS-level software), more reliable (doesn't depend on a running OS service), and universally compatible as a standard HID device.
2. Key Innovation: The integration of Web Serial for full device management. This eliminates the need for separate flashing tools (like esptool.py) or a dedicated configuration application. The entire lifecycle—flashing, Wi-Fi setup, key remapping, and logging—is handled through a secure browser page, drastically simplifying the user experience for a technical hardware project.

Frequently Asked Questions (FAQ)

1. Is MiRemoteBridge safe for Windows and does it trigger antivirus? Yes. Because the ESP32-C3 appears as a standard Bluetooth keyboard using the native Windows HID driver, it does not install, modify, or inject any custom drivers. This standard method is recognized as safe by Windows Defender and most antivirus software, and it will not trigger anti-cheat mechanisms in games.
2. What do I need to buy to build a MiRemoteBridge? You need two components: an ESP32-C3 development board (e.g., Seeed Studio XIAO ESP32C3, priced around $5) and a compatible Bluetooth remote. The verified and fully supported remote is the Xiaomi Bluetooth Remote 2 Pro (Model RC003). Other standard BLE remotes may work in learning mode but require verification.
3. Can I use MiRemoteBridge on a Mac or Linux PC? The firmware makes the ESP32-C3 a standard Bluetooth HID device, which is a universal standard. Therefore, it should work with macOS and Linux. However, the project maintainers have not officially verified these platforms. The primary development and testing focus is Windows 10/11.
4. How does the device connect? Do I need Wi-Fi? The device uses two wireless connections: Bluetooth (to connect the remote to the ESP32-C3 and the ESP32-C3 to your PC) and Wi-Fi (only used temporarily to serve the configuration web page to your browser). Once configured, the Wi-Fi on the ESP32-C3 can be turned off, and it will operate solely over Bluetooth for key forwarding.
5. What happens if I press a button not mapped in the remote's learning mode? If a generic remote sends a BLE key code that the MiRemoteBridge firmware has not yet learned and mapped, it will be ignored and not forwarded to the PC. You must first press the button to "learn" its code in the web UI and then assign an action to it.