Beta reference. Prepared from development builds for this version. This reference does not describe the current stable release.

A verified stable reference is not available yet. Choose a prepared beta version above.

Do · Actions · supported

Set Windows playback device

Change the Windows default playback endpoint. Console + Multimedia covers normal app audio; Communications is separate for calling apps.

action.windows_set_default_playback · 2.8.0

Browse all entries

Requirements and availability

Windows and an available playback endpoint selected from the local list.

Picker contexts: automation, timer, command, pad.

Operating systems: windows.

Behavior

Select a local playback endpoint. Roles default to console_multimedia; communications and all are separate choices. Open apps may retain their current audio stream.

Configure in the app

Open: Do → Advanced Actions (commands only) → Add action

Steps

Choose action category Utilities, select Set Windows playback device, and click Add action.
Expand the action card. Configure the Fields below; check Editor defaults for your context and any operation-dependent fields.
Choose resource values from real app pickers. Set output Platform separately from the trigger Where setting when the action offers it.
Use Move action up / Move action down to position this action, then save the containing command, automation, timer or SheevPad button.

Limitations

Picker availability does not supply missing event variables. Check prerequisites and originating provider.
An action return value is not automatically a sequence variable. Only documented producers create template outputs.

Fields

Field Input / options Defaults / limits Availability

Field	Input / options	Defaults / limits	Availability
Playback device `deviceId`	windows_audio_device_select	Editor defaults: {"automation":"","timer":"","command":"","pad":""}	Literal value / selected resource
Windows default roles `roles`	select Console + Multimedia (recommended): console_multimedia Communications only: communications All roles: all	Declared UI default: `console_multimedia` Editor defaults: {"automation":"console_multimedia","timer":"console_multimedia","command":"console_multimedia","pad":"console_multimedia"}	Literal value / selected resource
Already-open apps may keep their existing device until they reopen their audio stream. `migrationNote`	info	Editor defaults: {"automation":null,"timer":null,"command":null,"pad":null}	Information only

Playback device
deviceId

windows_audio_device_select

Editor defaults: {"automation":"","timer":"","command":"","pad":""}

Literal value / selected resource

Windows default roles
roles

select

Console + Multimedia (recommended): console_multimedia
Communications only: communications
All roles: all

Declared UI default: console_multimedia

Editor defaults: {"automation":"console_multimedia","timer":"console_multimedia","command":"console_multimedia","pad":"console_multimedia"}

Literal value / selected resource

Already-open apps may keep their existing device until they reopen their audio stream.
migrationNote

info

Editor defaults: {"automation":null,"timer":null,"command":null,"pad":null}

Information only

Contract details

Declared Contexts: [ "timer", "automation", "command", "pad" ]
Picker Contexts: [ "automation", "timer", "command", "pad" ]
Hidden From Picker: false
Required Variables: []
Failure Behavior: See the behavior for local skips/errors and context entries for sequence continuation.
Outputs: []

Examples

Illustrative configuration; replace fixture resources in the editor. This is not an import file.

{
  "deviceId": "fixture-playback",
  "roles": "console_multimedia"
}

Related entries

Source and verification

Source-reviewed for 2.8.0. Connected-service validation remains subject to release UAT.

src/features/automations.js — ACTION_REGISTRY.windows_set_default_playback
public/index.html — getBuilderActionEntries / createDefaultAction

Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1