Muse Gadgets: Open source hardware for your Muse
Muse Gadgets is an open-source project for building custom devices that connect to Muse. Makers can use an off-the-shelf ESP32 board or a Raspberry Pi/Linux computer, then attach displays, buttons, sensors, audio components, actuators, and other hardware. The project provides the relevant SDKs and firmware and is intended for experimentation by hobbyists and hackers. The documentation warns that tinkering can damage hardware, void warranties, cause power issues, or create other costs.
The repository includes two primary device SDKs:
- ESP32 Device SDK: Connects ESP32 boards to Muse and supports features such as image displays, audio input and output, and additional sensors.
- Linux Device SDK: Turns a Raspberry Pi or other Linux computer into a Muse gadget, including support for custom commands that can perform system administration or Home Assistant tasks.
The Muse Gadgets Test iPhone application can stream a phone camera feed or video clip over Wi-Fi to an ESP32 gadget display. The board can decode H.264 or VP8 video, with support for 30 frames per second on round 466-pixel displays. Instructions for the video protocol are provided in protocols/VIDEO.md.
Before flashing or pairing a gadget, users must obtain an SDK token and review the Gadget SDK Terms. Pairing is performed through the Muse iOS or Android app under Settings > Devices, with Developer mode enabled. Gadgets appear with names beginning with “MuseGadget.” Each project directory includes a README.md, while AGENTS.md provides guidance for coding agents.
The repository also includes an opt-in, board-neutral diagnostic core for battery-input power profiling. Its isolated diagnostic mode does not require pairing or an SDK token, but hardware authorization and fixture safety remain necessary.
Users can share projects and receive support through the community Discord. The main project is licensed under Apache License 2.0, although numerous third-party components retain their upstream licenses, including MIT, BSD, CC0, GPL, SIL Open Font, public-domain, and other terms. Dependencies are fetched during builds under their own licenses, and applications built with the included Muse Gadgets Test projects are licensed under the GPL.