Your music, your rooms and your Mac — within reach on Stream Deck. AirPlay by Dloper puts dedicated audio routing and Screen Mirroring controls directly onto your Stream Deck keys, rotary dials, and the Stream Deck Neo InfoBar. Send Apple Music to any speaker, group multiple rooms into named scenes, route whole-system Mac audio, and hold to restore built-in speakers in 1.2 seconds.
Requirements & Permissions
- Stream Deck App: Version 7.6 or later.
- Operating System: macOS 14 (Sonoma) or later on Apple Silicon or Intel Macs.
- Network: Mac and AirPlay receivers (HomePods, Apple TVs, AirPlay-compatible speakers and smart TVs) must be on the same reachable Wi-Fi / Ethernet network.
- Required macOS Permissions:
- Accessibility: Needed for system receiver discovery and Screen Mirroring toggling. Granted in System Settings > Privacy & Security > Accessibility.
- Automation: Needed to control Apple Music output routing. Granted in System Settings > Privacy & Security > Automation under Stream Deck.
Universal Native Helper: The plugin bundles a universal native helper binary (Intel + Apple Silicon). No external command line tools, terminal scripts, or third-party packages need to be installed manually.
Install and Get Started
- Visit the AirPlay Plugin Page or find AirPlay on Elgato Marketplace.
- Click Open in Stream Deck to install the plugin automatically.
- Locate the AirPlay category in the Stream Deck actions sidebar.
- Drag an action onto your canvas:
- AirPlay Audio onto standard LCD keys.
- AirPlay Screen Mirroring onto standard LCD keys.
- AirPlay Receiver Dial onto an encoder slot on Stream Deck +.
- AirPlay Status onto the Stream Deck Neo InfoBar.
- Click the action to open its Property Inspector, grant any required permissions, and select your AirPlay destination.
Actions Walkthrough
1. AirPlay Audio
Toggle audio playback to AirPlay destinations with physical button control.
- Routing Modes: Choose between Apple Music only (routes only music tracks, leaving system notification sounds on your Mac) or Whole system audio (routes all system sounds to the AirPlay receiver).
- Tap Control: Tap the key to connect to the configured receiver or scene. Tap again to disconnect.
- 1.2-Second Hold (Hold. You're Home.): Press and hold continuously for 1.2 seconds to instantly restore audio back to your Mac's built-in speakers. In Music mode, this also disconnects all active AirPlay speakers.
- Scrolling Key Titles: Long destination names smoothly scroll inside the key canvas so titles are never clipped by Stream Deck's native borders.
Visual Status Feedback:
- Yellow Pulse: Indicates immediate connection or checking progress.
- Green Key: Indicates confirmed active connection with a checkmark.
- Red Alert: Displays a 4-second warning if connection or discovery fails.
Enable "Use steady status colours" in the Property Inspector to keep colors solid with no pulsing animation.
2. Multi-Room Speaker Scenes (Apple Music)
Group multiple speakers across your home or office into a single key:
- Set audio routing to Apple Music only.
- Enable Use an AirPlay scene in the Property Inspector.
- Select each speaker from the discovery list (e.g. Living Room, Kitchen, Office).
- Enter an optional Scene Title (e.g. Downstairs).
AirPlay stores unique network addresses for each selected speaker, ensuring same-name receivers (like multiple HomePods) are accurately addressed. A scene is considered active when every configured speaker is engaged.
3. AirPlay Screen Mirroring
Connect or disconnect an AirPlay display or Apple TV with one tap.
- Select Find displays and pick your AirPlay TV or wireless monitor.
- Press the key to initiate connection. If your TV requires an on-screen passcode, enter it on your Mac.
- Press again to disconnect.
- Note: Mirroring versus desktop extension is configured in macOS System Settings > Displays.
4. AirPlay Receiver Dial (Stream Deck + & Encoders)
Designed for rotary dials on Stream Deck + and compatible encoder surfaces:
| Interaction |
Behavior |
| Rotate the dial |
Browse through available AirPlay receivers without interrupting current audio. |
| Push the dial |
Connect immediately to the displayed receiver. |
| Tap the touch strip |
Instantly return audio playback to your Mac's internal speakers. |
5. AirPlay Status (Stream Deck Neo InfoBar)
Place this action on the 232 × 50 Neo InfoBar ribbon. It displays the current Apple Music or system audio destination in real-time (updated every ~2 seconds), leaving all eight Neo keys available for actions.
Troubleshooting & FAQs
No AirPlay receivers found
- Ensure your Mac and AirPlay devices are connected to the exact same Wi-Fi or Ethernet network and subnet.
- Verify that the receiver is awake and not in standby mode.
- Check if macOS itself can see the receiver in System Settings > Sound or the Control Center menu bar item.
- Click Find AirPlay devices again. Discovery times out safely after 45 seconds if no devices respond.
Apple Music output fails to switch
- Open System Settings > Privacy & Security > Automation and ensure Stream Deck has permission to control Music.
- Make sure the Apple Music application is installed and running on your Mac.
- Test connecting to a single speaker before combining multiple speakers into a scene.
Holding 1.2s does not restore built-in speakers
The Mac must expose an internal output (e.g. "MacBook Pro Speakers" or "Mac mini Speakers"). On certain desktop Mac configurations connected exclusively to external monitors or audio interfaces, ensure built-in output is visible in macOS Sound settings.
Screen Mirroring fails or stays disconnected
- Verify that Stream Deck is authorized under System Settings > Privacy & Security > Accessibility.
- In System Settings > Control Center, set Screen Mirroring to Always Show in Menu Bar.
- If an AirPlay passcode is displayed on your TV screen, enter it once into the macOS prompt.
Need Further Assistance?
If you encounter an issue not covered in this guide, reach out to our team: