Getting started

How to build a Muse gadget for Meta’s Muse

Short answer

Build a gadget for Meta’s Muse by choosing a supported ESP32 board or a Linux computer with Bluetooth LE, reviewing the SDK terms and obtaining a personal token. Follow the official build or installation path for that device, then pair it in the Muse app. Capabilities depend on the hardware and account permissions; the directory provides source links rather than device testing.

SourceSDK READMEChecked 3 Oct 2026

Four steps from a bare board to a gadget that talks to Meta’s Muse. Each step summarises the official guide and links to it. Checked on 3 Oct 2026.

Before you flash.

Flashing custom firmware can brick a board and void its warranty, and the risk is yours. Check each project's README for recovery steps first.

Step 1: Choose your hardware

Start with an ESP32 board listed in the official README, a Raspberry Pi (3B+, 4, 5 or Zero 2 W), or another Linux computer with Bluetooth LE. The features available depend on your device. Check the official hardware list before choosing a board.

Compare boards ESP32 or Linux?

Step 2: Get a token and review terms

Every gadget needs an SDK token to pair, including personal builds. Get one under Account > SDK tokens on the official site and review the Gadget SDK Terms first.

Open SDK tokens Read the Gadget SDK Terms

Step 3: Flash and pair

ESP32 boards

Choose an ESP32 board listed in the official README, a USB data cable and a macOS or Linux computer. The official firmware requires ESP-IDF 6.0.1. Follow the board-specific build and flash instructions, then pair with the Muse app.

Official ESP32 setup guide

Linux and Raspberry Pi

Use a supported Raspberry Pi or a Linux computer with Bluetooth LE already on your network. Follow the official installer instructions as the account Muse should use, then pair through the Muse app. Muse receives that account's permissions.

Official Linux setup guide

In the Muse app, turn on Settings > Devices > Developer mode, then add your device. Device names begin with MuseGadget.

Browse what others built

Explore community projects and the official hardware resources.

Projects Resources

1Step 1: Choose your hardware

2Step 2: Get a token and review terms

3Step 3: Flash and pair