Bring Muse to Android hardware. An open-source runtime that turns Android phones, tablets and TVs into programmable Muse gadgets: display, media, voice, camera and local automation, according to each device’s capabilities. Build new uses with Kotlin and Python. No root. No Termux.
Get started · 繁體中文 · Commands · Ask a question
Phone, tablet and TV layouts from 0.3.0; see device validation for tested hardware. Download 0.3.0 to try this interface. Published APKs use development signing; production signing remains planned.
The interesting engineering boundary is small: Kotlin owns Android hardware and lifecycle; Python owns command validation, scenes and integrations; the upstream SDK owns pairing and cloud transport. Muse commands, local controls and scenes share one command catalog.
git clone --recurse-submodules https://github.com/hypery11/muse-gadget-everywhere.git
cd muse-gadget-everywhere
./gradlew :app:assembleDebug # JDK 17, Android SDK 35, Python 3.11
adb install -r app/build/outputs/apk/debug/app-debug.apkArchitecture & extension points · Build prerequisites / modern runtime · Checks & first contributions
CI builds both universal and modern development APKs with checksums. Download artifacts from a successful Actions run while signed into GitHub; these are development builds, not production-signed releases.
| You want to… | Use it for… |
|---|---|
| Give your device a voice and a display | Message cards, images and buttons; spoken reminders with Android TTS |
| Play something | Native audio/video, queues, subtitles and playback controls; choose another Cast receiver |
| Run a small routine | Local scenes triggered manually, on a schedule or by an event while the service runs |
| Give Muse eyes and ears | Visible, opt-in camera capture and push-to-talk; on-device Chinese OCR and barcode reading |
| Connect your home | Optional Home Assistant states/events and MQTT; outgoing actions are opt-in |
The app uses the unmodified upstream Muse Gadget SDK for pairing and cloud communication. The Android layer adds local controls and native hardware features. This is an independent community project, not an official Muse app.
Download 0.3.0: Universal APK — including Chromecast · Modern APK — 64-bit / 16 KiB · Release notes and checksums. These development-signed APKs use the same signing certificate as the published 0.2 APK. Use adb install -r to update without uninstalling; see upgrade instructions. You can also build from source.
- Install on your Android device. Android 7.0+ is the minimum. Use the universal build for Chromecast; devices with 16 KiB pages need the modern build. Choose a build and connect ADB →
- Try it locally. Open the app → Start service → Try a card → Show card. A visible message is your first success; no Muse account is needed for this step.
- Connect Muse when ready. Home → Pair with Muse. Save an SDK token from gadgets.muse.ai, open setup, then use the Muse phone app → Settings → Devices → Add Device. Pairing requires BLE peripheral support.
- Start the service after pairing. Wait for Connected to your Muse. Ask Muse to show a message on your device. Pairing help →
Remote commands that open screens/apps in the background also need Android overlay access: Device → Diagnostics & setup → Grant overlay. Camera, microphone and home integrations are optional.
Local control demonstration, recorded from the app. Cloud control was verified separately; this animation does not depict a Muse chat.
The TV uses a focusable side rail; phones use bottom navigation. Display, Media, Scenes and Device tools each have their own page. Inputs survive tab changes, command responses have a readable summary, and full details remain available.
Real hardware testing centers on Chromecast with Google TV (Android 12, 32-bit userspace). The native runtime was also tested on Android API 24 and 35 emulators, including a 16 KiB ARM64 image. This is not a claim that every Android device has been tested.
- Chromecast: BLE pairing, Muse cloud commands, Cast playback/pause/resume/stop, TTS, display cards and reboot reconnection.
- Device/emulator regression: native media, OCR/barcodes, local scenes, lifecycle and UI navigation.
- Still needs community testing: physical phones/tablets, real Home Assistant/MQTT installations and a 72-hour soak.
Compatibility matrix · Validation summary · Reproduce the checks · Report your device
The 0.3 upgrade restricts file commands to an app workspace and makes the trusted developer shell opt-in. Native cryptography dependency advisories remain open; see security boundaries for the known limits.
Build instructions · Full command guide · Troubleshooting · Roadmap
You can help without writing code: report a device, improve a setup step, translate a guide, or share a useful scene in Discussions. Developers can start with CONTRIBUTING.
If this helps you build something with Android and Muse, star the repo to follow its development. A device report, extension or short demo helps the next person get started, too.
New to Muse?
Cloud control needs a Muse account, phone app and SDK token; Muse SDK terms apply. Local controls can run without pairing.
Apache-2.0. Upstream SDK and third-party notices are preserved; see NOTICE and upstream integration.