| name | audio |
| description | Low-level speaker and microphone hardware control — adjust volume, play test tones, record raw audio. Do NOT use for TTS/speech (that is the Voice skill). |
Audio Control
Quick Start
Control the device's speaker and microphone hardware directly. Use this for volume adjustments, test tones, and raw audio recording. This is LOW-LEVEL hardware control only.
Workflow
- Determine the user's audio hardware need:
- Volume adjustment -> use
POST /audio/volume
- Check current volume -> use
GET /audio/volume
- Diagnostics / test -> use
POST /audio/play-tone
- Raw recording -> use
POST /audio/record
- Optionally check device availability first:
GET /audio
- Execute the appropriate API call
- Confirm the action to the user
Examples
Input: "Louder please" / "Turn it up"
Output: Check current volume with GET /audio/volume, then increase by ~15 with POST /audio/volume. Confirm: "Volume set to 85%."
Input: "Set volume to 50%"
Output: Call POST /audio/volume with {"volume": 50}. Confirm: "Volume set to 50%."
Input: "Mute" / "Too loud"
Output: Call POST /audio/volume with {"volume": 0}. Confirm: "Muted."
Input: "I can't hear you"
Output: Check current volume with GET /audio/volume, then increase it. Confirm with the new level.
Input: "Say something" / "Tell me a joke"
Output: Do NOT use this skill. Just reply normally — your voice pipeline handles TTS automatically.
Tools
Use Bash with curl to call the HTTP API at http://127.0.0.1:5001.
Check audio devices
curl -s http://127.0.0.1:5001/audio
Response:
{
"output_device": 0,
"input_device": 1,
"available": true
}
Set volume
curl -s -X POST http://127.0.0.1:5001/audio/volume \
-H "Content-Type: application/json" \
-d '{"volume": 70}'
Volume range: 0 (mute) to 100 (max).
Get current volume
curl -s http://127.0.0.1:5001/audio/volume
Response: {"control": "Speaker", "volume": 70}
Play test tone
curl -s -X POST "http://127.0.0.1:5001/audio/play-tone?frequency=440&duration_ms=500"
Plays a sine wave. Use for audio testing only. Keep it short (< 1 second).
Record audio
curl -s -X POST "http://127.0.0.1:5001/audio/record?duration_ms=3000"
Records from the microphone and returns a WAV file.
Error Handling
- If
GET /audio returns "available": false, inform the user: "The speaker/microphone is not connected right now."
- If the API is unreachable, inform the user: "I couldn't access the audio hardware. The service may be unavailable."
- If the user requests a volume outside 0-100, clamp to the valid range.
Rules
- Default volume is usually 70%. Adjust based on user preference.
- Audio = volume knob, raw mic recording, test beeps. No AI speech processing.
- Voice = AI-powered speech (TTS/STT). Uses Audio hardware underneath but is a separate skill.
- When the user says "I can't hear you" or "too loud", adjust volume via this skill.
- Do NOT use this skill for TTS or speech output — that is handled by the Voice skill and the automatic voice pipeline.
Output Template
[Audio] {action} — {details}
Examples:
[Audio] Volume set — 70%[Audio] Volume set — muted (0%)[Audio] Test tone played — 440Hz, 500ms[Audio] Recording captured — 3000ms
