network_radio
Skill37 starsChanged 33 days agoMITView on GitHub
Use this skill when the user asks to play, switch, adjust volume, query status, or stop a network radio station. Always call the synchronous control script. It starts and controls a background radio player daemon when needed. Do not call the daemon script directly. 电台通过 audio.open_output() 使用固件提供的默认音频输出,不再接受 codec_name。需要可用的扬声器设备和网络。 Play 上海经典947: Switch to 杭州90.7 without changing volume: Set volume to 35 without restarting playback: Play a direct stream URL: Query current status: Stop the radio:
In this repository24 other files it gives its agents.
- air_mouseSkill
- bilibili_up_fansSkill
- china_a_share_quoteSkill
- cloudmusicSkill
- current_ip_infoSkill
- current_weatherSkill
- dfrobot_matrix_lidar_8x8_i2cSkill
- dfrobot_stcc4_i2cSkill
- example_skillSkill
- flashbackSkill
- gimbal_color_detectSkill
- gimbal_motion_detectSkill
- github_repo_starSkill
- movement_detectionSkill
- servo_dogSkill
- stock_quotes_displaySkill
- token_usageSkill
- unihiker_buttonSkill
- unihiker_expansion_batterySkill
- unihiker_expansion_irSkill
- unihiker_expansion_motor_controlSkill
- unihiker_expansion_servo_controlSkill
- unihiker_expansion_WS2812Skill
- weather_clockSkill
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 3 are distinctive, and 6 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
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 18
Use this skill when the user asks to play, switch, adjust volume, query status, or stop a network radio station.
- Distinctive: line 20
Always call the synchronous control script.
- Distinctive: line 167
If no close match exists and the user did not provide a URL, ask the user to choose a station.
- Very specific: line 168
Always run {CUR_SKILL_DIR}/scripts/control_network_radio.lua with lua_run_script and timeout_ms: 12000.
- Very specific: line 169
Use action: "play" when starting radio from idle or when the user simply says to play a station.
- Very specific: line 170
Use action: "switch" when the user asks to change station while radio may already be playing.
- Very specific: line 171
Use action: "volume" when the user asks to set, raise, lower, or adjust volume.
- Very specific: line 172
Use action: "status" when the user asks what is playing or current volume.
- Very specific: line 173
Use action: "stop" when the user asks to stop, pause, cancel, quit, close, or turn off the radio.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 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
Network Radio
Use this skill when the user asks to play, switch, adjust volume, query status, or stop a network radio station.
Always call the synchronous control script. It starts and controls a background radio player daemon when needed. Do not call the daemon script directly.
电台通过 audio.open_output() 使用固件提供的默认音频输出,不再接受 codec_name。需要可用的扬声器设备和网络。
Available Stations
- 崂山921
- 长沙101.7城市之声
- 上海经典947
- 湖北经典音乐广播
- 成都年代音乐怀旧好声音
- 山东经典音乐广播
- 杭州90.7
- 天津TIKI 100.5
Control Args Schema
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": ["play", "switch", "volume", "stop", "status"],
"default": "status"
},
"station": {
"type": "string",
"description": "Station title or a distinctive title fragment. Use one of the available station names unless the user provides a direct URL."
},
"url": {
"type": "string",
"description": "Optional direct http or https MP3 stream URL. If set, it overrides station."
},
"title": {
"type": "string",
"description": "Display title used when url is provided directly."
},
"volume": {
"type": "integer",
"minimum": 0,
"maximum": 100
},
"wait_ms": {
"type": "integer",
"default": 8000,
"minimum": 1000
}
},
"required": ["action"]
}Tool Call Inputs
Play 上海经典947:
{
"path": "{CUR_SKILL_DIR}/scripts/control_network_radio.lua",
"args": {
"action": "play",
"station": "上海经典947",
"volume": 70
},
"timeout_ms": 12000
}Switch to 杭州90.7 without changing volume:
{
"path": "{CUR_SKILL_DIR}/scripts/control_network_radio.lua",
"args": {
"action": "switch",
"station": "杭州90.7"
},
"timeout_ms": 12000
}Set volume to 35 without restarting playback:
{
"path": "{CUR_SKILL_DIR}/scripts/control_network_radio.lua",
"args": {
"action": "volume",
"volume": 35
},
"timeout_ms": 12000
}Play a direct stream URL:
{
"path": "{CUR_SKILL_DIR}/scripts/control_network_radio.lua",
"args": {
"action": "play",
"title": "自定义电台",
"url": "http://example.com/live.mp3",
"volume": 70
},
"timeout_ms": 12000
}Query current status:
{
"path": "{CUR_SKILL_DIR}/scripts/control_network_radio.lua",
"args": {
"action": "status"
},
"timeout_ms": 12000
}Stop the radio:
{
"path": "{CUR_SKILL_DIR}/scripts/control_network_radio.lua",
"args": {
"action": "stop"
},
"timeout_ms": 12000
}Behavior
playstarts the background daemon when needed, opensaudio_dac, and plays the selected station.switchreuses the daemon, stops the current stream, and starts the new station.volumecallsoutput:set_volume()in the daemon and does not restart playback.statusreads the last daemon status and does not start playback.stopsends a stop command to the daemon; the daemon stops playback, closes audio resources, records the radio as stopped, and exits.- The daemon job name is
network_radio_playerand its exclusive group isaudio_output. - Runtime commands use
thread.syncqueues namednetwork_radio_cmdandnetwork_radio_reply; the last status snapshot is stored under the DATA root asnetwork_radio/status.json, resolved withstorage.get_root_dir().
Recommended Flow
- For play or switch requests, choose the closest station from
Available Stations. - If no close match exists and the user did not provide a URL, ask the user to choose a station.
- Always run
{CUR_SKILL_DIR}/scripts/control_network_radio.luawithlua_run_scriptandtimeout_ms: 12000. - Use
action: "play"when starting radio from idle or when the user simply says to play a station. - Use
action: "switch"when the user asks to change station while radio may already be playing. - Use
action: "volume"when the user asks to set, raise, lower, or adjust volume. Pass an absolutevolumevalue from 0 to 100. - Use
action: "status"when the user asks what is playing or current volume. - Use
action: "stop"when the user asks to stop, pause, cancel, quit, close, or turn off the radio. - Report the script output directly. If the script returns an error, report that error directly to the user.
可选触摸界面
用户要求屏幕控制时,用 lua_run_script_async 启动 {CUR_SKILL_DIR}/scripts/network_radio_app.lua,指定 name: "network_radio_ui"、exclusive: "display"、replace: false、timeout_ms: 0。界面通过当前 lvgl.init(options) 自动接入显示和触摸;播放器仍为独立后台任务。只有用户明确要求替换显示任务时才允许 replace: true。
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.

