gadget-roku-tvs-and-players
Skill2.8k starsChanged 26 days agoApache-2.0View on GitHub
Control Roku TVs, streaming sticks/boxes and Roku-powered displays that answer the local External Control Protocol (ECP) on TCP 8060 through Muse Home Link. Covers discovery, device info, apps, remote keys, text entry, deep links, search, and Roku TV volume, input and power.
- Sends data out
Trending
More talk lately.thin dataabout the whole repository
Who's talking about facebookincubator/muse-gadget-sdk
- @j4ck.xyz“I still wouldn't trust Meta with my personal context for agents, but what they're doing with Muse is pretty …”Bluesky · Oct 2, 2026 · 7 likes
- A Hacker News story“Open source SDK to build Muse gadgets”Hacker News · Oct 3, 2026 · 2 points
- ComBba/muse-gadget-sdk“CI preflight: wait for the installer serial close before SDK token setup”GitHub · Oct 17, 2026 · 1 reactions
- @sarubot.bsky.social“muse-gadget-sdk — Metaが放つ、ESP32やラズパイをAIガジェットへ変貌させるSDK。今週スター急増中の注目作! …”Bluesky · Oct 7, 2026 · 1 likes
- aegisfleet/tool-survey-report“feat: add survey report for Muse Gadget SDK”GitHub · Nov 9, 2026
The biggest 5 of 14 mentions linking to the repository that our crawl found. Each line is their own headline.
See all 14
Talked about on GitHub, Bluesky and Hacker News (14 times).
On GitHub · 11
- Oct 17, 2026CI preflight: wait for the installer serial close before SDK token setup — ComBba/muse-gadget-sdk1 reaction · 2 comments
- Nov 9, 2026feat: add survey report for Muse Gadget SDK — aegisfleet/tool-survey-report0 reactions · 4 comments
- Oct 14, 2026Fix S3-2.06 ES7210 microphone and native USB serial console — polygoku/waveshare-amoled-206-debug0 reactions · 5 comments
- Oct 12, 2026Integration blocker: native Muse gadget command invocation — 1chris2many/muse-portal-kit0 reactions
- Oct 12, 2026Integration blocker: authoritative per-device reply correlation — 1chris2many/muse-portal-kit0 reactions · 2 comments
6 more on GitHub
- Oct 11, 2026[fork CI preflight] #181 candidate a6fd89c — ComBba/muse-gadget-sdk0 reactions · 1 comment
- Oct 11, 2026[fork CI] #179 Use the custom avatar in the UI simulator — ComBba/muse-gadget-sdk0 reactions · 1 comment
- Oct 11, 2026[fork CI] #181 Add validated avatar restore and host status — ComBba/muse-gadget-sdk0 reactions · 1 comment
- Oct 11, 2026[fork CI] #180 Validate avatar candidates before replacing the current renderer — ComBba/muse-gadget-sdk0 reactions · 1 comment
- Oct 11, 2026[fork CI] #174 Reject incomplete bench screenshots without padding pixels — ComBba/muse-gadget-sdk0 reactions · 1 comment
- Oct 11, 2026[fork CI] #177 Abort bench screenshots when USB console output stalls — ComBba/muse-gadget-sdk0 reactions · 1 comment
On Bluesky · 2
- Oct 2, 2026I still wouldn't trust Meta with my personal context for agents, but what they're doing with Muse is pretty cool & fun icl… — @j4ck.xyz7 likes and reposts
- Oct 7, 2026muse-gadget-sdk — Metaが放つ、ESP32やラズパイをAIガジェットへ変貌させるSDK。今週スター急増中の注目作! ・C言語製のESP32/Linux用SDK。センサーやオーディオをMuseエコシステムに即統合 ・AIエージェント「Muse… — @sarubot.bsky.social1 likes and repost
On Hacker News · 1
- Oct 3, 2026Open source SDK to build Muse gadgets2 points
In this repository57 other files it gives its agents.
- esp32/AGENTS.mdAGENTS.md
- linux/AGENTS.mdAGENTS.md
- gadget-amazon-echoSkill
- gadget-apple-homepod-miniSkill
- gadget-apple-tv-4kSkill
- gadget-bambu-lab-p2sSkill
- gadget-bambu-lab-printersSkill
- gadget-brother-printersSkill
- gadget-dyson-pure-hot-cool-hp04Skill
- gadget-ecowitt-gatewaysSkill
- gadget-elgato-key-lightSkill
- gadget-epson-printersSkill
- gadget-esphome-devicesSkill
- gadget-espsomfy-rtsSkill
- gadget-eufy-robovac-tuyaSkill
- gadget-freebox-player-popSkill
- gadget-google-castSkill
- gadget-google-home-maxSkill
- gadget-google-home-speakerSkill
- gadget-google-nest-audioSkill
- gadget-google-nest-hub-maxSkill
- gadget-google-nest-hubSkill
- gadget-google-nest-miniSkill
- gadget-google-nest-thermostatsSkill
- gadget-google-pixel-tabletSkill
- gadget-google-tv-streamerSkill
- gadget-homewhiz-laundrySkill
- gadget-hp-color-laserjet-pro-m254dwSkill
- gadget-insignia-fire-tvSkill
- gadget-irobot-roomba-braavaSkill
- gadget-lg-webos-tvsSkill
- gadget-logitech-squeezeboxSkill
- gadget-lutron-smart-bridgesSkill
- gadget-meross-smart-plugsSkill
- gadget-miele-g7566-dishwasherSkill
- gadget-moonraker-3d-printersSkill
- gadget-philips-hue-bridgesSkill
- gadget-pixoo-64Skill
- gadget-ratgdo-v32-garage-doorSkill
- gadget-roborock-vacuumsSkill
- gadget-samsung-tizen-tvsSkill
- gadget-shelly-plugsSkill
- gadget-sinricpro-cloud-devicesSkill
- gadget-sonoff-rf-bridgeSkill
- gadget-sonos-speakersSkill
- gadget-teslaSkill
- gadget-tplink-kasa-ep10Skill
- gadget-tplink-kasa-ep25Skill
- gadget-tuya-cloud-devicesSkill
- gadget-tuya-wifi-devicesSkill
- gadget-unifi-network-consolesSkill
- gadget-velux-klf200Skill
- gadget-vesync-humidifierSkill
- gadget-vizio-d40f-g9Skill
- gadget-wyze-rtsp-camerasSkill
- gadget-yi-hack-camerasSkill
- gadget-zigbee2mqtt-gatewaysSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 2 are distinctive, and 6 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
6
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 27
If SSDP and mDNS find nothing, ask the user for the IP.
- Very specific: line 31
Read and follow the Home Link networking and safety rules in ~/docs/devices/home_link.md.
- Very specific: line 33
Read ecp-setting-mode first.
- Very specific: line 47
Read the state the request depends on: /query/active-app, /query/apps, /query/media-player or power-mode.
- Very specific: line 63
Turn the TV on or off: check power-mode, send the key, wait a few seconds, check again.
- Very specific: line 69
After the user changes the network-control setting, re-read /query/device-info and report the new ecp-setting-mode.
- Very specific: line 85
Treat serial-number, device-id, wifi-mac, ethernet-mac, bluetooth-mac, user-device-name, default-device-name (contains a serial fragment), …
- Distinctive: line 133
No screenshots, no account sign-in, no sideloading, and no control of DRM playback beyond the normal remote keys.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Roku TVs and Players (ECP)
Local HTTP control over the LAN using Roku's External Control Protocol (ECP), sent through Muse Home Link. No cloud account, pairing or client key; access is governed by a network-control setting on the device (see Limits).
Identify the Device
- Confirm the target is a Roku:
GET http://<ip>:8060/query/device-infomust return XML containing<vendor-name>Rokuand a<model-number>. - Also read
model-name,software-version,power-modeandis-tv. Players and TVs differ in which keys they accept, and behavior varies by OS version. - Discovery:
- Known IP: the user can find it under Settings > Network > About. A DHCP reservation keeps it stable.
- SSDP: multicast
M-SEARCHto239.255.255.250:1900withST: roku:ecp. TheLOCATIONheader is the base URL (http://<ip>:8060/). - mDNS: Roku TVs with AirPlay advertise
_airplay._tcp,_hap._tcp,_spotify-connect._tcpand_display._tcp; the TXT record carriesmanufacturer=Rokuand the A record the IP. - If SSDP and mDNS find nothing, ask the user for the IP. Do not scan the subnet.
Prerequisites
Read and follow the Home Link networking and safety rules in ~/docs/devices/home_link.md.
- Read
ecp-setting-modefirst. On a Roku TV running OS 16.0.4 the default islimited, where only/query/device-infoand/query/active-appanswer; everything else returns 403 (ECP command not allowed in Limited mode.). If the mode is notenabledorpermissive, tell the user the setting must be changed on the TV and stop. Do not retry or look for a workaround. A 401 ondevice-infomeans the setting isDisabled; same advice. - ECP has no per-request authentication. Only talk to a device the user named or approved, stay on the local network, and never expose port 8060 to the internet.
- Get user confirmation before anything with side effects: launching apps, power keys, input changes, typing text, Channel Store pages. Reads are always fine.
Workflow
- Confirm the device and read
ecp-setting-mode(see Identify the Device and Prerequisites). - Read the state the request depends on:
/query/active-app,/query/apps,/query/media-playerorpower-mode. - Get user confirmation for anything with side effects, then send one request per call. For menu navigation, keys about 170 ms apart worked reliably.
- Re-query the affected state, because an accepted request does not prove the screen changed.
Common cases:
- What's playing?
/query/active-app, then/query/media-player. - Open an app by name:
/query/apps, match the name,POST /launch/<id>. - Type a search string:
Searchkey, thenLit_per character. Then stop and ask the user what is on screen: ECP can't read search results or keyboard focus. Do not sendSelectright after typing: focus is usually still on the on-screen keyboard, soSelectmay type the highlighted letter instead of opening a result. To open a result, move focus to the results first and confirm with the user. On some voice-remote models theSearchkey may start voice input. - Turn the TV on or off: check
power-mode, send the key, wait a few seconds, check again.
Verify the Result
- Re-query the state the action should have changed (
active-app,media-player,power-mode). An HTTP 200 means the request was accepted, not that the screen changed. - After the user changes the network-control setting, re-read
/query/device-infoand report the newecp-setting-mode.
Request Shape
Reads (GET, XML)
| Endpoint | Returns |
/query/device-info | model, software version, power mode, network type, ecp-setting-mode, ecp-tls-enabled, supports-warm-standby, supports-wake-on-wlan, and more. supports-tv-power-control and supports-audio-volume-control are documented for OS 15+ but were absent on an OS 16.0.4 TV, so do not depend on them. |
/query/apps | installed channels with numeric app IDs |
/query/active-app | foreground app; on the home screen it returns <app>Roku</app> with no id |
/query/media-player | player state, plugin, position, duration |
/query/icon/<appId> | app icon (binary) |
/query/tv-channels, /query/tv-active-channel | tuner lineup and current channel (TV models only); empty elements are normal when no lineup is set up |
Treat serial-number, device-id, wifi-mac, ethernet-mac, bluetooth-mac, user-device-name,
default-device-name (contains a serial fragment), network-name (Wi-Fi SSID) and
user-device-location as sensitive. Do not echo them unless asked.
Actions (POST, empty body)
curl -s -X POST http://<ip>:8060/keypress/Home
curl -s -X POST http://<ip>:8060/launch/<appId>
curl -s -X POST "http://<ip>:8060/launch/<appId>?contentID=<id>&MediaType=<type>"
curl -s -X POST "http://<ip>:8060/search/browse?keyword=<text>&launch=true"
curl -s -X POST http://<ip>:8060/install/<appId>- Keys (
/keypress/<KEY>;keydown/keyupto hold): Home, Back, Select, Up, Down, Left, Right, Rev, Play, Fwd, InstantReplay, Info, Search, Enter, Backspace, FindRemote. - Roku TV only: VolumeUp, VolumeDown, VolumeMute, PowerOff, ChannelUp, ChannelDown,
InputTuner, InputHDMI1-4, InputAV1.
PowerOnandPowerare also accepted (see Power). - Text entry: one request per character,
/keypress/Lit_<char>. Percent-encode the character as UTF-8 unless it is an ASCII letter, digit,-,.,_or~: space isLit_%20,#isLit_%23,?isLit_%3F,&isLit_%26,€isLit_%E2%82%AC. - Deep links:
contentID(under 255 chars, URL-encoded) andMediaType(series, season, episode, movie, shortFormVideo, tvSpecial). Support is per app; an unsupported link just opens the app. - Search:
keywordis required; optionaltitle,type(movie, tv-show, person, channel, game),season,tmsid,match-any,provider,provider-id,show-unavailable,launch. Percent-encode each value (&in a keyword is%26). Reliability is limited (see Limits). /install/<appId>only opens the Channel Store page; the user confirms the install on screen.
Limits
- Network control setting (Settings > System > Advanced system settings > Control by mobile
apps > Network access):
Limited(default),Enabled,Permissive,Disabled. Observed on an OS 16.0.4 Roku TV:Limitedanswers only device-info and active-app (403 elsewhere);EnabledandPermissiveboth allowed every read and keypress tried;Disabledreturned 401. Differences in scope betweenEnabledandPermissive(such as which source addresses are allowed) were not tested. Only the user can change the setting on the TV. Afterwards re-read/query/device-infoand report the newecp-setting-mode. - Power (Roku TV 65R8CX, OS 16.0.4):
PowerOff,PowerOnandPowerworked;PowerToggledid not. In standby the TV kept answering ECP andpower-modereadReady(on isPowerOn).PowerOnandPowerare not in Roku's public key list, so treat them as observed behavior, not a guarantee. Other models, players and deeper standby states may not answer at all, and ECP cannot wake a device that is not listening. - Search is best effort.
/search/browsecan return 200 with missing results; fall back to typing withSearchplusLit_(see Workflow). - LAN only, plain HTTP.
ecp-tls-enabledwastrueon the tested TV; plain HTTP on 8060 still worked. - Developer-only endpoints (
chanperf,sgnodes,registry,exit-app,fwbeacons, ...) need developer mode and are out of scope. - No screenshots, no account sign-in, no sideloading, and no control of DRM playback beyond the normal remote keys. Do not change device settings other than through the normal remote keys the user asked for.
Sources
- Roku ECP reference: https://developer.roku.com/docs/developer-program/dev-tools/external-control-api.md
- Archived SDK ECP doc (apps, active-app, install, search/browse): https://sdkdocs-archive.roku.com/External-Control-API_1611563.html
- Roku Community, "Did 12.5 break search/browse ECP?": https://community.roku.com/discussions/developer/did-12-5-break-searchbrowse-ecp/912374
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

