Driver Details

New Community

Apple TV IP Control

By: David Bowdler
Updated: July 6, 2026
Version: 1.31
Download Driver
Rating: 0.0 (0 ratings)
Log in to rate this driver

Apple TV Control Driver

Full two-way control of an Apple TV (HD 4th-gen or Apple TV 4K, tvOS 15+) directly over the local network using Apple's native Companion Protocol — the same protocol as the Apple TV Remote app. No IR, no bridge hardware, and no cloud round-trip for control, so navigation is instant. Pairing is a one-time PIN exchange with secure, encrypted communication.

The driver ships two ready-made control surfaces: a browser-based Web Object dashboard (D-pad, app grid, on-screen keyboard, system and pairing tabs, live status, theme picker) that embeds in any RTI panel or opens in any browser, and an on-screen browse menu with real App Store icons for T-class / ISR hardware remotes.

Key Features

  • Navigation & Media: D-Pad, Menu/Home, Play/Pause, Next/Previous, Fast Forward/Rewind, Volume, Channel Up/Down
  • App Launching: Browse installed apps with real App Store icons, plus 50+ pre-configured launch shortcuts (Netflix, Disney+, Prime Video, YouTube, Spotify, Plex, Stan, Binge, Kayo, ABC iView, and many more)
  • Text Input: Full on-screen keyboard for search fields and text entry
  • Real-Time Feedback: Current app (with icon), volume level, screen state (Awake/Asleep/Screensaver), keyboard-active and connection status
  • Power Control: Sleep, Wake, Screensaver
  • Self-Healing Connection: Reconnects on its own — when the Apple TV changes its control port, the driver finds the new one and carries on, with no manual intervention

Multiple Apple TVs, One Licence

Control several Apple TVs from a single RTI processor — one driver instance per Apple TV, each with its own pairing and its own Web Object page, all covered by a single per-processor licence with no per-device fee.

Web Object UI

A full browser-based remote, embeddable in any RTI panel or opened on any device (iPad / iPhone / Android / desktop): Controls, Apps, Keyboard, System and Pair tabs, a live pairing-progress banner, per-browser display options, and a theme picker. It's optional — disable it entirely to use only the native browse menu.

Requirements

  • Apple TV HD (4th gen) or Apple TV 4K, tvOS 15+
  • RTI XP processor (runtime 24+). XP-8v / XP-6s run all cryptography locally; XP-3 / XP-6 use an optional cloud crypto offload for pairing
  • Same network as the RTI processor
  • Internet access for initial pairing (and for the Web Object UI when enabled)

How It Works

The driver talks directly to the Apple TV using the Companion Protocol. You pair once with a PIN shown on the TV; after that, all remote control is local. A 120-minute trial is built in, so you can prove it on your own hardware before buying.

Support & Developer Service

This driver is built and maintained by a working integrator, not a faceless vendor. We strive to offer the best possible developer service — if you run into any problem, get in touch and we'll work with you directly to sort it out, whether it's a setup question, a site-specific quirk, or a feature request. Every driver gets ongoing updates and real-world testing on live jobs.

Apple TV Control Driver v1.31

Smart Home Programming

Overview

This driver controls Apple TV (tvOS 15+) using the Companion Protocol over TCP/IP. It supports navigation, media control, volume, power, app launching, text input, a browse menu system with real app icons, and a full browser-based Web Object control UI.

When enabled, the optional Full Crypto Offload setting routes the heavy SRP / Ed25519 / Curve25519 cryptography to a cloud server so the driver can pair successfully on older RTI processors –including the XP-3 and XP-6 which cannot complete the local crypto in time before the Apple TV's pairing session times out. On XP-8v and XP-6s a single instance can run all cryptography locally with this setting off. If you are controlling more than one Apple TV from one processor, turn Full Crypto Offload ON on every instance –with two or more instances the processor is busier and local crypto can be too slow to finish pairing inside the Apple TV's ~30-second PIN window. See "Setting Up Multiple Apple TVs on One Processor" below.

Upgrading from v1.08

If you're upgrading from v1.08, your driver will keep behaving exactly as it does today –both new optional features (Cloud Crypto Offload and Web Object Enabled) default to OFF. The only things you'll get automatically are bug fixes (screensaver sends HID 11 now, debug-off is silent, etc.). Your existing pairing credentials and licence key carry over.

To unlock the new pairing flow on XP-6 / XP-3, flip Full Crypto Offload to True under the Pairing category. To enable the browser remote, flip Web Object Enabled to True under the Polling category.

What's New in v1.31

- Faster reconnect after standby –when the Apple TV has been asleep and dropped off the network, the driver now searches for it about twice as fast, so it finds and reconnects sooner with less "Finding Apple TV..." waiting. It also backs off more gently while an Apple TV stays asleep, keeping the processor lighter.

- Reliable wake from standby (wired Apple TV 4K) –added guidance for the wired Apple TV 4K models (such as the A2843) that power their Ethernet port down when they sleep. See Slow or unreliable wake from standby under Troubleshooting –adding the Apple TV to the Apple Home app keeps it reachable in standby so it wakes instantly and reliably.

What's New in v1.30

- Lighter, smoother operation –especially on older processors –the driver now does less background work and handles the Apple TV's data more efficiently, so it runs lighter and keeps the processor more responsive. The difference is most noticeable on older hardware such as the XP-3 and XP-6.

- More reliable reconnection –if the Apple TV drops off the network or loses power (for example when it sleeps), the driver recovers and reconnects more cleanly on its own, and Power On will reconnect and wake the Apple TV even if the connection had dropped.

What's New in v1.26

- Name each Apple TV in the Web Object –a new Device Name setting (Connection category) lets you give each Apple TV a friendly name (e.g. Lounge Apple TV, Bedroom). It is shown as the title at the top of the Web Object page, so when you run more than one on a processor you can tell them apart at a glance. Leave it as "Apple TV" if you only have one.

- Web Object scales to the window –the Web Object UI now grows to fill larger panel widgets instead of staying small, so it looks right whatever size the widget is.

- Cancel button while pairing –the browse-menu pairing screens ("Connecting..." and "Waiting for PIN") now have a Cancel option. If the Apple TV is off or unreachable you can back out instead of being stuck on that screen, and Cancel also stops the pairing attempt cleanly. Tip: the most common reason a PIN never appears is that the Apple TV's IP has changed –give each Apple TV a fixed (reserved) IP in your router so the driver always finds it.

What's New in v1.25

- Web Object for multiple Apple TVs on one processor –if you load this driver more than once on the same processor (one per Apple TV), each one can now have its own Web Object page. The first / only Apple TV is unchanged –leave Web Object Instance ID blank and its URL stays the same as before, so existing systems keep working. For each additional Apple TV, set a unique Web Object Instance ID (2, 3, ...) under the Polling category; its Web Object URL becomes the MAC with no colons and -ID on the end, e.g. ...?mac=0015260AF1AC-2. The exact URL for each instance is shown in the new Web Object URL system variable –bind it to a label or just read it to copy the link.

What's New in v1.22

- App list keeps working on the latest tvOS –some Apple TV models on recent tvOS stopped reporting their installed apps to the driver, which left the app list empty. The driver now detects this and automatically shows a built-in list of popular apps it can launch, so the browse menu and Web Object app grid keep working. When the Apple TV does report its real installed apps, that live list is used instead.

- Choose which apps appear –a new Show Apps in List section in Driver Properties has a tick box for every app, all on by default. Untick any you don't want and it is hidden from both the browse menu and the Web Object app grid. This applies whether the list comes from the Apple TV or the built-in fallback.

Note: an app will only launch if it is already installed on that Apple TV. The built-in fallback list shows popular apps the driver knows how to launch, but it cannot tell which are actually installed –selecting an app that is not installed will do nothing. Untick any apps you don't have installed (in the Show Apps in List section) so the list only shows apps that will launch on this Apple TV.

What's New in v1.21

- Multiple Apple TVs on one processor –you can now load this driver more than once on the same RTI processor, one copy per Apple TV, all covered by the one licence key for that processor. Each copy stores its pairing credentials and remembered port separately (keyed by the Apple TV's IP address), so the copies never interfere with each other and every Apple TV keeps its pairing across a reboot. Existing single-Apple-TV installs upgrade with no change –your current pairing and licence carry straight over.

- Per-instance debug port –when the Debug Port is left unset, each copy of the driver automatically picks its own telnet diagnostic port (derived from the Apple TV's IP) so multiple copies on one processor don't clash. Set Debug Port explicitly to override.

What's New in v1.20

- Indian streaming app launch shortcuts (added by customer request) –dedicated one-tap launch functions for JioHotstar, ZEE5, Sun NXT, Simply South and Tentkotta, under a new "India Apps" category in the function list. Each app's real icon is now bundled in the driver, so it shows in the browse menu / Web Object and as the now-playing icon instead of the generic default. The Apple TV (tvOS) bundle IDs were confirmed by launch-testing on real hardware –note tvOS bundle IDs differ from the iOS App Store versions (e.g. ZEE5 on tvOS is com.graymatrix.did.tv, not the iOS com.zeeTV.DIDS4), which is why the correct IDs had to be verified on-device.

What's New in v1.19

- Automatic port recovery (self-healing connection) –the Apple TV occasionally changes the internal port it listens on for control (this happens on an Apple TV reboot or a tvOS update). Previously that would silently drop the connection until the port was changed by hand. The driver now handles it completely on its own: it tries the last working port first (so a normal reconnect is instant), and if the Apple TV has moved to a new port it automatically probes and finds it, reconnects, and remembers the new port for next time. Validated end-to-end –on a real Apple TV reboot that moved the port, the driver re-found it and reconnected with no intervention.

- New "Auto-Discover Port" setting (Connection category) controls this and is ON by default. Leave it on. The Companion Port field is now just the port the driver tries first; turn Auto-Discover off only if you want to lock the driver to one fixed port.

- Connection diagnostics –a new ports command in the telnet diagnostic console shows the current/last-known port and what the driver is probing, to help support.

What's New in v1.14

- Pairing diagnostics–when a pairing attempt is refused by the Apple TV, the driver now records the exact reject reason in the diagnostic log instead of failing silently, so support can pinpoint the cause quickly. No change to normal operation.

What's New in v1.13

- Idle-connection fix–the reconnect watchdog no longer mistakes a healthy but idle Apple TV (nothing playing) for a dropped link. It now sends a keepalive the Apple TV answers, so the connection stays steady instead of cycling. Genuine dropped links are still detected and reconnected.

What's New in v1.12

- Automatic reconnect –the driver now detects a dropped or stalled connection on its own and reconnects, so the remote keeps working without needing to restart the Apple TV.

- Reconnect command added –put it on a button, or run it when the Apple TV powers on, to re-establish the link instantly.

- Remote diagnostics logging (optional, off by default) with Remote Logging On / Off commands, so support can review live driver activity when troubleshooting a site.

What's New in v1.11

- Launch Paramount+ (AU/International) shortcut added (com.cbs.canada.app) for Australian and other non-US App Stores. The existing shortcut was renamed to Launch Paramount+ (US) for clarity.

- Documented a known Apple-side regression on Apple TV HD (A1625) running tvOS 26.5 where the Companion API silently drops app-list / attention-state / volume responses. See Known Issues below.

What's New in v1.10

- Pairing works on every XP processor via opt-in cloud crypto offload –flip the Full Crypto Offload config setting to enable. Confirmed working on XP-8v, XP-6s, and XP-6. XP-3 and XP-8s are still to be confirmed (TBC).

- Browser-based Web Object UI with apps, now-playing, remote controls, on-screen keyboard, system + pairing tabs, live status, theme picker, and licence/trial display

- Driver to server WebSocket bridge replaces 1-second HTTP polling –dramatically less processor stress and sub-100ms command latency

- Soft keyboard tab with text input field auto-launches when a text field is focused on the Apple TV; whole-string batch send (one round-trip, not one per character)

- App Switcher via double-tap Home; close cards with Up pressed twice (documented below)

- Screensaver button now uses HID 11 (dedicated screensaver) instead of HID 12 (sleep) –fixes the long-standing "screensaver = sleep" bug

- DebugLevel = Off is now actually quiet –every non-error log line is gated by the DebugLevel config setting. ERRORs, warnings, trial state, and licence state always print so installers can still diagnose problems

- Display Options in the Web UI Settings let users toggle which tabs are visible per browser (saved to localStorage), independent of the IDesign defaults

- Live pairing-progress banner on the Pair tab showing what's happening at every step of pair-setup and pair-verify

Requirements

1. Apple TV HD (4th gen, A1625) or Apple TV 4K (any generation, A1842/A1962/A2169/A2737/A3253) running tvOS 15 or later

2. Apple TV must be on the same network as the RTI processor

3. Internet access on the RTI processor's network is only required if you enable the Full Crypto Offload setting (needed for pairing on XP-3 / XP-6 and recommended for reconnects on those older processors). On XP-8v and XP-6s the default settings perform all cryptography locally and no internet is needed. The Web Object UI also requires internet when enabled, since it routes through shpdrivers.services.

Processor Compatibility (v1.10):

- XP-8vworking

- XP-6sworking

- XP-6working with Full Crypto Offload enabled (pair-setup ~20s, well inside Apple TV's 30s session timeout)

- XP-3 –to be confirmed (TBC)

- XP-8s –to be confirmed (TBC)

Setup Instructions

Step 1: Find the Apple TV IP address

- On Apple TV: Settings > Network > Wi-Fi > select your network > note the IP address

- Or check your router's DHCP client list for the Apple TV

- We recommend setting a static IP or DHCP reservation

Step 2: Configure the driver

- Enter the Apple TV IP address in the "Apple TV IP Address" setting

- Companion port is 49153 by default (change only if needed)

Step 3: Pair the driver with your Apple TV

- First, check the Apple TV's AirPlay access setting. On the Apple TV go to Settings > AirPlay and HomeKit > Allow Access and make sure it is set to Anyone on the Same Network (or Everyone) –not Only People Sharing This Home. If it is restricted to the home, the Apple TV will refuse pairing and never display a PIN. You may leave "Require Password" on.

- The driver will automatically attempt to connect on startup

- Easiest: open this Apple TV's Web Object page in a browser (see "Web Object UI" below for the URL), go to the Pair tab, and tap Start Pairing. Alternatively use the browse-menu Pairing screen on an RTI panel.

- A 4-digit PIN will appear on the Apple TV screen within a few seconds

- Type the PIN into the four boxes (Web Object) or with the digit buttons, then tap Submit PIN

- The status moves through Computing proof –Verifying M6 –Paired –Connected

- Pairing credentials are stored permanently (keyed to this Apple TV's IP) –this only needs to be done once and survives reboots

Step 4: Verify the connection

- After successful pairing, the driver auto-connects on startup

- Check the "Connection Status" variable –it should show "Connected"

- Try sending a navigation command (DPad Up/Down/Left/Right, Select)

Setting Up Multiple Apple TVs on One Processor

You can control several Apple TVs from one RTI processor by loading this driver once per Apple TV. All instances are covered by the one licence key for that processor –there is no per-device fee.

1. Add the driver once for each Apple TV. Each appears as its own instance in Integration Designer.

2. In each instance set the Apple TV IP Address to that Apple TV's address. Each instance stores its own pairing, keyed by IP, so the instances never interfere and each keeps its pairing across a reboot.

3. Turn Full Crypto Offload ON (Pairing category) on every instance. With two or more instances the processor is busier and local crypto can be too slow to finish pairing inside the Apple TV's ~30-second PIN window. Offload makes pairing fast and reliable. (Requires internet on the processor.)

4. Set the Web Object Instance ID (Polling category) so each Apple TV gets its own Web Object page:

- First / main Apple TV: leave it BLANK. Its Web Object URL stays ...?mac=<MAC>, so any links you set up before keep working unchanged.

- Each additional Apple TV: set 2, then 3, 4, ... Its URL becomes ...?mac=<MAC>-2, ...-3, and so on (the MAC with the colons removed and the ID on the end).

The exact URL for each instance is shown in that instance's Web Object URL system variable –read it (or bind it to a label) to copy the correct link. Do not use "0" or "1" for the main one –leave it blank.

5. If you use the telnet debug console, give each instance a different Debug Port (e.g. 12505, 12506) so they don't clash. For normal running leave Debug Level Off.

6. Pair each Apple TV from its own Web Object page (Pair tab), one at a time. Each PIN appears on its own Apple TV.

Important –processor load: for normal running leave Debug Level Off on every instance, and only enable Remote Logging when asked to for support. Verbose logging across many drivers at once adds significant load and can overrun a busy processor.

Features

Navigation & Media Control

- D-Pad navigation (Up, Down, Left, Right, Select)

- Menu / Back, Home

- Play, Pause, Play/Pause, Next, Previous, Fast Forward, Rewind

- Volume Up, Volume Down, Mute

- Channel Up/Down, Page Up/Down, Guide

App Launching

- Browse and launch installed apps from the Apps menu

- Show Apps in List (Driver Properties) has a tick box for every known app –untick any you don't want shown in the browse menu and Web Object app grid. On recent tvOS, some Apple TVs no longer report their installed apps; the driver then shows a built-in list of popular apps it can launch, so the app grid keeps working. An app only launches if it is actually installed on that Apple TV –untick the ones you don't have so the list only shows apps that will open.

- 50+ pre-configured app launch shortcuts for use in macros (Netflix, Disney+, Prime Video, YouTube, Stan, Binge, Kayo, ABC iView, SBS, 7plus, 9Now, 10 Play, plus Indian apps JioHotstar, ZEE5, Sun NXT, Simply South, Tentkotta, and more)

- Launch any app by bundle ID using the "Launch App" function

- Current app indicator (✓ shown in the apps list

- Real app icons from the Apple App Store displayed in browse menus

Text Input / Keyboard

- "Send Text" function sends text to the Apple TV when a text field is focused (e.g., search)

- "Keyboard Active" variable indicates when the Apple TV has a text input field focused

- Use Show/Hide Keyboard functions to control keyboard panel visibility on the RTI interface

Feedback Variables

- Volume –Current volume level (0-100%)

- Current App –Bundle ID of the currently running app

- Current App Name –Friendly name of the current app

- Current App Icon –App icon image for display on RTI interfaces

- Screen State –Awake, Asleep, or Screensaver

- Keyboard Active –True when Apple TV has a text input field focused

- Connected –Connection state (boolean)

- Paired –Pairing state (boolean)

Power Control

- Sleep, Wake, and Screensaver commands

Browse Menu

The browse menu provides access to:

- Apps –View and launch installed apps with real icons

- Controls –Play/Pause, Volume, Home, Menu

- System –Sleep, Wake, Screensaver, Refresh Apps, Device Info

- Pairing –Start pairing, enter PIN, clear pairing

Each menu section can be enabled or disabled in the driver configuration.

App Launch Shortcuts

The following app launch shortcuts are available as macro commands in Integration Designer:

- Netflix, Disney+, Prime Video, YouTube, Apple TV+, Apple Music, Spotify, Plex

- Stan, Binge, Kayo, ABC iView, SBS, 7plus, 9Now, 10 Play

- Paramount+, HBO Max, Hulu, Peacock, Tubi, BritBox, hayu, Foxtel, FreeView

- Twitch, DAZN, Crunchyroll, ESPN, Pluto TV, discovery+, STARZ, Fubo

- YouTube Kids, YouTube Music, YouTube TV, Infuse, VLC, Jellyfin

- Apple Fitness+, Apple Podcasts, Sling TV, Amazon Music, TIDAL

- MUBI, CNN, CuriosityStream, Peloton

- India: JioHotstar, ZEE5, Sun NXT, Simply South, Tentkotta (added by customer request; real app icons bundled)

Web Object UI

A browser-based control UI is available at:

https://shpdrivers.services/atvdev/?mac=<PROCESSOR-MAC>

For a single Apple TV (or the first one on a processor with several), that is the URL –unchanged from earlier versions, so existing links keep working. For additional Apple TVs on the same processor, each has its own page at ...?mac=<MAC>-2, ...-3, etc. (see "Setting Up Multiple Apple TVs on One Processor"). The exact URL for each instance is published in its Web Object URL system variable –always copy it from there rather than building it by hand.

Example –if the processor's MAC is 0015260F13F6, the first / only Apple TV's page is:

https://shpdrivers.services/atvdev/?mac=0015260F13F6

and a second Apple TV on the same processor is:

https://shpdrivers.services/atvdev/?mac=0015260F13F6-2

The part after the dash is the Web Object Instance ID –it can be a number (2, 3, ...) or a short name, e.g. ...?mac=0015260F13F6-Lounge.

The Web Object is designed to be embedded in any RTI panel template that supports a Web Object widget, or opened in any browser (iPad / iPhone / Android / desktop). If you change pages or the URL, do a hard refresh so the browser loads the current page.

Tabs:

- Controls –D-Pad, Menu/Home/App Switcher, Play/Pause, Volume, Siri

- Apps –All installed apps with real icons; tap to launch. Current app is highlighted.

- Keyboard –Large text input + Send button. Auto-jumps here when the Apple TV reports a text field is focused. (On iOS Safari, the device's soft keyboard requires one tap on the input field –this is an Apple restriction that no website can bypass.)

- System –Sleep, Wake, Screensaver, Refresh Apps

- Pair –Live progress banner, step-by-step instructions, PIN entry. The banner shows exactly what the driver is doing at every stage (Connecting / Pairing / Computing proof / Signing M5 / Verifying M6 / Paired).

Settings (gear icon, top-right):

- Licence –Shows Licensed / Trial / Trial expired plus remaining trial minutes

- MAC –The processor's MAC address (this is the licence key target)

- Display Options –Per-browser toggles for which tabs are visible. Saved to localStorage so each user can customise their own view without changing the driver-wide defaults set in IDesign.

- Theme –6 preset themes + a custom colour picker

The Web Object can be disabled entirely from the driver config ("Web Object Enabled" setting) for installations that want to use only the native browse menu.

App Switcher (Double-Tap Home)

The driver supports double-tapping the Home button to open the App Switcher overlay on tvOS, matching the Siri Remote behaviour.

- Open App Switcher: Send the "Home Double Tap" function (or tap the dedicated button in the Web Object UI).

- Navigate between apps: Use Left / Right.

- Close the highlighted app: Press Up twice. The first Up press selects the close gesture on the highlighted card; the second Up confirms the close. This matches Apple's Siri Remote swipe-up behaviour.

- Exit App Switcher: Press Menu or Home once to return to the prior screen.

Debug Console

Connect via telnet to the debug port (default 12505) for testing:

telnet <processor-ip> 12505

Available commands:

- help –List all commands

- status –Show connection state and device info

- connect / disconnect –Manual connection control

- pair –Start pairing process

- pin XXXX –Submit 4-digit PIN

- button <1-19> –Send HID button code

- app <bundle.id> –Launch app by bundle ID

- apps –List installed apps

- crypto <test> –Run crypto verification test

Troubleshooting

- No PIN appears on the Apple TV when you start pairingCheck this first. The most common cause is the Apple TV's AirPlay access policy blocking an outside controller. On the Apple TV go to Settings > AirPlay and HomeKit > Allow Access and change it from Only People Sharing This Home to Anyone on the Same Network (you may leave "Require Password" on), then start pairing again –the PIN should appear within a few seconds. When this setting is the blocker the Apple TV refuses the request before any PIN is generated, so clearing the Remote App entries or power-cycling the Apple TV will not help –only changing this setting will.

- Pairing never connects (using Full Crypto Offload), and your network blocks our server –if pairing stays stuck and never shows a PIN while Full Crypto Offload is on, your network may be unable to resolve our pairing server by name. The tell-tale sign in RTI TraceView is the line ResolveName - failed for host: shpdrivers.services repeating over and over. Some networks (corporate, guest, or filtered/custom DNS) will not resolve outside hostnames. Fix: in the driver config set the SRP Server setting (Pairing category) to the IP address 209.38.27.58 instead of shpdrivers.services, and if you use Remote Logging set Log Server Host to the same IP. Then start pairing again –the secure connection still works against the IP. (If you would rather not change the driver, fixing your processor's DNS so it can resolve shpdrivers.services also works.)

- "Not Paired" status –Navigate to the Pairing menu, tap Start Pairing, and enter the PIN shown on the Apple TV.

- Pairing fails –Ensure the Apple TV is awake and on the home screen, and that AirPlay "Allow Access" is set to Anyone on the Same Network (see above). Try again with the correct PIN. The PIN changes each time.

- Connection drops –The driver auto-reconnects on its own and keeps retrying while the Apple TV is paired. If the Apple TV is asleep, send Power On –the driver reconnects and then wakes it. If wake from standby is slow or unreliable, see the next note.

- Slow or unreliable wake from standby (wired / Ethernet Apple TV 4K) –Some Apple TV 4K models (for example the A2843 Wi-Fi + Ethernet model) power their Ethernet port down when they sleep, which drops the Apple TV off the network entirely in standby. When that happens the driver can show Finding Apple TV... for a while, and a Power On sent during that window may not land –the Apple TV simply is not reachable until its network link comes back. The reliable fix is to add the Apple TV to the Apple Home app: on an iPhone or iPad open the Home app and add the Apple TV using any Apple account. Once it is in the Home app, tvOS keeps the Apple TV's network alive in standby, so it stays reachable and wakes instantly and reliably every time. (If you prefer not to use the Home app, setting Settings > General > Sleep After > Never on the Apple TV keeps it fully awake as a blunter alternative.) This is Apple's standby behaviour, not a driver limitation.

- Commands not working –Verify the connection status is "Connected". Some commands only work when awake.

- Apps list empty –Wait a few seconds after connecting. Use Refresh App List to manually update. See the Known Issues section below if the list stays empty on an Apple TV HD (A1625) running tvOS 26.5.

- Volume not updating –Volume feedback requires a volume-capable app to be running. The driver auto-detects when volume control is available.

- Paramount+ launch shortcut opens nothing on an AU Apple TV –The default Launch Paramount+ (US) shortcut targets the US bundle ID (com.cbsvideo.app), which is not installed on AU / international App Stores. Use Launch Paramount+ (AU/International) instead, which targets com.cbs.canada.app (Paramount uses the Canada bundle ID across several international markets including Australia).

Known Issues

- Apple TV HD (model A1625) on tvOS 26.5 –A current Apple-side regression on this specific model + tvOS combination silently drops FetchAttentionState, FetchLaunchableApplicationsEvent, and GetVolume Companion API requests. The encrypted session itself is healthy and all button presses (Home / Menu / D-Pad / Wake / Sleep / pairing) work, but the apps tab, current-app feedback, and volume polling stay empty until Apple ships a tvOS patch. Newer Apple TV 4K models (A1842 / A1962 / A2169 / A2737) on the same tvOS 26.5 are unaffected. Workarounds: (1) wait for Apple's next tvOS release, or (2) test on an Apple TV 4K if available. The driver functions as a remote control on the affected combination.

Protocol Notes

The driver uses the Apple TV Companion Protocol which provides:

- Volume level feedback (polled when available)

- Power/screen state (push events)

- Current app detection (push events)

- Text input/keyboard focus detection (push events)

- App launching and installed app list

Note: Now playing metadata (track title, artist, album, duration) is not available through the Companion Protocol. That data requires the separate MRP (Media Remote Protocol) which uses protobuf encoding.

Licensing

This driver is sold through the Smart Home Programming Driver Store.

- Driver Store: https://shpdrivers.services/store/

- Your Account: https://shpdrivers.services/store/account.html

Free Trial:

The driver operates in a 120-minute trial mode without a licence key. The trial provides full functionality and resets each time the RTI processor is rebooted.

To Purchase:

1. Create an account at https://shpdrivers.services/store/

2. Add this driver to your cart

3. Enter your RTI processor MAC address during checkout

4. Complete payment and receive your licence key by email

5. Enter the licence key in the driver configuration

Support

For bug reports, technical support, or feature requests, please use the ticket system in your account at the Driver Store.

- Store: https://shpdrivers.services/store/

- Email: david@smarthomeprogramming.com.au

Version History

- v1.11 –Added Launch Paramount+ (AU/International) shortcut (com.cbs.canada.app) for Australian and other non-US App Store regions; existing shortcut renamed to Launch Paramount+ (US). Documented known Apple-side regression on Apple TV HD (A1625) + tvOS 26.5 where the Companion API silently drops app-list / attention-state / volume responses (driver works as a remote, metadata feedback dark until Apple ships a patch).

- v1.10 –Cloud crypto offload (opt-in, enables pairing on XP-3 / XP-6); browser-based Web Object UI (opt-in, controls + apps + keyboard + system + pairing + theme picker); persistent driver-server WebSocket; live pairing-progress banner; transport controls (Play / Pause / Skip 10s); Screensaver button now sends HID 11 (was Sleep / HID 12); DebugLevel=Off now actually silences operational logging; App Switcher fix; live trial-timer refresh; Settings modal with per-browser display-option toggles. All new features default OFF –existing v1.08 installs behave identically until the integrator opts in.

- v1.08 –Standardised licensing and support sections, encrypted packaging

- v1.06 –48 app launch shortcuts (20 new), SRP server pairing, default port 49153, auto-navigate home after pairing, internet requirement documented, licensing/support info

- v1.04 –Added 28 app launch shortcuts for macros, volume feedback, keyboard active variable, text input support, hayu/Foxtel/ESPN/discovery+/STARZ/Fubo icons, removed Siri, app clears on Home press

- v1.03 –Real iTunes app icons for 35+ apps, current app icon image variable, tick beside current app, pairing UX improvements

- v1.02 –Browse menus, app launching, screen state feedback, debug console

- v1.01 –SRP pairing via HTTP proxy, connection management

- v1.00 –Initial release with full crypto stack and companion protocol

Terms of Service

All drivers are provided "as is" without warranty of any kind. You use this software entirely at your own risk. A free trial is included so you can verify compatibility with your system before purchasing – do not purchase a licence if you have not tested the driver on your hardware. For full terms including warranty disclaimer, limitation of liability, and refund policy, visit:

https://smarthomeprogramming.com.au/store/terms.html

Copyright 2026 Smart Home Programming. All rights reserved.

Please log in to leave a comment.
Loading comments...