Apple TV API SDK Two-Way Driver for Home Automation

Apple TV Integration (Beta)

Login or Register to see price!


The Apple TV Driver is under development and will be available as soon as it is ready.  Join the Dash OS Community Chatroom for early Beta Access.  This driver will support two-way control & feedback from your Apple TV Devices.  See now playing metadata, navigate and control, browse through iTunes Radio, and more!  Stay tuned!  You are welcome to pre-order the module in the meantime.  This will give you the license that can be activated onto your Dash OS Systems so that you are prepared for release.  At this time, there is no estimated time for release


Sold by: Dash OS
SKU: atv. Category: .

Product Description

ATV 4

This module does not support the ATV 4 at this time, however support should be coming soon!

Beta Test

The Beta Test is currently in progress.  You can join the beta by joining our Beta Test & Support Community Chatroom located here: https://www.hipchat.com/invite/270001/627217626fffc2ffd5f948da8f74c43f – this module is not ready for end-users homes at this time.

Apple TV Integration

The long awaited Apple TV Dash App is here!  Gain full IP Control & Metadata with all generations of Apple TV, no need for any kind of jailbreak or changes to the Apple TV, just pair the Dash App and you’re good to go!  Our team has spent countless hours combing through the data received by Apple to ensure the strongest possible integration.  Enable Automation never thought possible, provide renewed life into your Apple TV’s when powered by URC’s Total Control Home Automation Platform!

IP Control

Free up the IR port on your URC Controller with IP Control of your Apple TV.  You will have a range of commands available including:

  • Top Menu (Home)
  • Menu
  • Context Menu (Options)
  • Select
  • Up, Down, Left, Right
  • Skip Back, Skip Forward
  • Rewind / Fast Forward Start
  • Rewind / Fast Forward Stop
  • Scan Forward (Customizable Seconds per Press)
  • Scan Rewind (Customizable Seconds per Press)
  • Seek To (Customizable Seconds into Media per Press)
  • Shuffle
  • Repeat
  • Play
  • Pause
  • Play / Pause
  • Stop
TCL Commands

With TCL Commands, you can get further control of your Apple TV as well as query to get the current status.  Queries can be saved into either Integer or String Variables to empower deeper integration within your system.

  • Get Play Status – Responds to return the play status of your Apple TV (Playing, Pause, Off).
  • Get Media Type – Responds with the current media type is that is being played (Music, Video iTunes Radio, Airplay).
  • Get Station Name – Returns the name of the station playing, if any.
  • Parse Now Playing Title – Run a test against the currently playing media title.  You can create queries such as “If Includes” and “If Equals.”  For example, “Does the Title Include Harry Potter?” – and it will return 1 or 0 for yes/no.
  • Parse Now Playing Genre – Similar to above but for the Genre.
  • Parse Now Playing Album – Similar to above but for Album.
  • Parse Now Playing Artist – Similar to above but for Artist.
  • Parse Now Playing Chapter – Similar to above but for the chapter.
  • Get Time Data – Query the Now Playing Duration, Elapsed, Time Remaining, % Time Remaining, % Time Elapsed.
  • Send Keyboard String – Allows you to enter any value that will be typed into an active keyboard.
  • Fast Forward / Rewind – Fast Forward or Rewind for the given amount of time.
  • Shuffle Status – The Current Shuffle Status
  • Repeat Status – The Current Repeat Status
Device Events
  • On Status – Automatically Trigger Macros when your Apple TV’s various statuses occur.  This includes On Play, On Stop, On Pause, On Fast Forward, On Rewind, On Fast Forward (Speed 1, Speed 2, Speed 3), On Rewind (Speed 1, Speed 2, Speed3), On % Complete, On % Remaining, On New Now Playing
  • Airplay Audio Event – When the user <starts / stops> airplay media to the Apple TV.  This event allows you to run checks against Song Title, Artist, and Album so that the event will only occur if the media contains the given values (if desired).
  • Metadata Event – When the Now Playing Media matches your parameters.  Use Title, Genre, Artist, Album, Explicitness, etc.
  • Media Progress Event – When Media <xx%> <elapsed / remaining>

A Special Thanks

Dash has worked closely with MyDevice, an Australian Company whom pioneered the research into the Apple TV Protocol and enabled Dash to bring you this amazing Dash App.  They have created a similar option for RTI and have many other great options you can find on their website.

Click an image to expand the gallery!

Dash App Overview

Below you will find various information about the Dash App.  This includes the download link and where you will find it within your URC Programming Software.

Download Link:
Accelerator Location:
My > IP Database > AUX > Dash Apps > Apple TV
Driver File Name:
Dash – Apple TV.csd

Download & Import the Dash App

In order for the Dash App to become recognized by the URC Programming Software we will need to import the provided TCM File into the Software.  Once this has been done properly the Dash App should show up in the “Add Other Devices” programming step in the “Accelerator Location” provided on the overview tab.

Step 1

In your Programming Software locate the “Import TCM Files” button in the File tab of the top menu toolbar.  Click it to open the Windows File Browsing window.  Browse to the TCM file you wish to import and select it.

Step 2

Based on the Dash App / Module you are importing, a dialog similar to the above will appear.  This window indicates what interfaces are supported by the TCM File you selected.  System Plugins may only show “Driver” and “Base Station Files” when no User Interface is provided by the module.

Step 3

Confirm that the Dash App was successfully imported.  You can do this by navigating to the driver where the Dash App is installed (see Overview Tab) and making sure a checkbox is provided for “8. Select 2-Way Modules for Network Remotes / Keypads”

Dash App "Network Setup"

You should set the IP Address of the Apple TV you are using.  You should either do DHCP Reservation or set a Static IP on your Apple TV so that the module can communicate with it properly.

Port Assignment

Each Instance of the Apple TV Module should use a different port.  Do not use lower ports, it is recommended you increment the port used by 1 each unique instance you add.

Dash App Parameters

Correctly configuring the Dash App Parameters is critical for your Dash App to work properly. This is generally completed in the “3rd Party 2-Way Settings” step of your URC Programming.

This Dash App does not require any Parameters to be setup.

Pairing With Apple TV

Before the module will work you will need to pair with your Apple TV.  Once you have paired with your Apple TV you should not need to do it again unless the pair is at some point removed.  Note that if you do remove the Pair you will need to restart your Apple TV before it will accept a re-pair.

Pairing is quick and is only required one time per Apple TV.  Simply download the Dash App to your system and open it to bring up the pairing instructions for that User Interface.

You can refer to the video below for an example of pairing from URC Mobile – iPhone.

Pairing Multiple Instances

A single license can cover as many Apple TVs as you would like to add to a system. Be sure that all instances are setup with the correct IP address for each Apple TV. Also confirm that you have increased the port number by one for each instance.

You will only be able to pair one instance at a time. Work from the top of your tree down. Between each newly paired instance, you will need to reset the MRX to reactivate the Bonjour Discovery for the next instance. You can watch that this is happening properly from within Cloud Logging.