couch.
← Using Couch

APPLE TV

Control Apple TV

Select a paired Apple TV device and press OK to open its controls. This Rust Companion client is experimental; pairing and behavior still need validation on your Apple TV.

Apple TV screen showing connected Companion status, playback controls, Wake and Apps.
Companion controls provide navigation and playback commands without claiming a now-playing feed.
Apple TV Apps tray with an example installed TV app.
Apps reads the paired Apple TV’s installed-app catalog.

Physical buttons

Default behavior. An activity can override individual mappings.

Physical button mappings for Apple TV
ButtonWhat it does
D-pad and OKNavigate Apple TV and select its focused item.
Back and MenuSend Apple TV’s Back/Menu command. Short presses stay in the control screen.
HomeSend Home to Apple TV.
Volume + / −Send volume commands; response depends on Apple TV’s audio setup.
Channel + / −Send channel commands where the active app supports them.
PowerRequest sleep. Couch does not infer Apple TV’s current power state or toggle it blindly.
Hold BackHold for about 0.6 seconds to return to Couch’s previous device list.
Mute and color buttonsNot available through this Companion client. Map another device in an activity if it supplies those functions.

Pair once in Connections

Add an Apple TV connection in the web UI, find the device and request its on-screen PIN. Discovery supplies the Companion port, which varies by device. Keep Apple TV awake while pairing. An Apple ID password is not required.

Apps and playback

Add the connection as a device in a room, then open it on the remote. Apps displays the catalog reported by the paired Apple TV; tap an entry to launch it. Previous, play, pause and next are available on the screen. Available behavior depends on the active app.

Sleep and wake are separate

The physical Power button requests sleep. Touch Wake to resume Apple TV. A successful command is not a confirmed power-state report. If the connection is unavailable, turn on the device and use Reconnect.

What the screen does not claim

This Companion connection does not yet supply artwork, a timeline or current playback metadata. Seek, stop, mute and color buttons are not exposed. Use an activity to route receiver volume or other supported commands to a different device.