Speaker Access

Speaker Access

Speakers, USB audio interfaces, and other playback devices use the same audio entitlement as microphones. Add it when your app needs to play sounds, speak responses, emit alerts, or run full-duplex voice interactions.

Add the entitlement from your project directory:

wendy project entitlements add audio

Inspect Output Devices

List audio devices on the target:

wendy device audio list

Choose the speaker or output device ID, then set it as default:

wendy device audio set-default --id 2

The selected output becomes the default device used by apps that play through ALSA defaults.

Test Audio Routing

The Wendy CLI can stream microphone input back to your local machine with:

wendy device audio listen --id 1

For speaker playback inside your deployed app, make sure the app uses ALSA or a media framework that targets the default audio output. USB speakerphones usually expose both an input and output device, so wendy device audio list is the fastest way to confirm WendyOS sees both sides.

App Configuration

A minimal speaker app uses:

{
  "appId": "com.example.speaker",
  "version": "1.0.0",
  "entitlements": [
    { "type": "audio" }
  ]
}

Then deploy:

wendy run