Master DirecTV receivers (ie: those that have tuners) will be automatically discovered if you enable the discovery component and the receiver is powered-on. Slave/RVU client/Genie boxes will also be discovered, but only if they are also online at the time of discovery.

To ensure that your DirecTV boxes are always found and configured, they should be added into your configuration.yaml.

# Example configuration.yaml entry
  - platform: directv

Configuration Variables


(string)(Optional)The IP address or the hostname of the device. Use only if you don’t want to scan for devices.


(integer)(Optional)The port your receiver is using.

Default value: 8080


(string)(Optional)Use to give a specific name to the device.

Default value: DirecTV Receiver


(string)(Optional)Use to specify a particular receiver in a Genie setup.

To find valid device IDs, open http://<IP Address of Genie Server>:8080/info/getLocations in a web browser. For each Genie slave, you will find a variable clientAddr in the response, and this should be used for device in configuration.yaml

For example, a response such as:

  "locations": [
      "clientAddr": "0",
      "locationName": "MASTER GENIE SERVER",
      "tunerBond": true
      "clientAddr": "5009591D6969",
      "locationName": "SOME SLAVE GENIE"
  "status": {
    "code": 200,
    "commandResult": 0,
    "msg": "OK.",
    "query": "/info/getLocations"

Could be formatted into configuration.yaml like so:

  - platform: directv
    port: 8080
    name: Main DirecTV Box
    device: 0
  - platform: directv
    port: 8080
    name: Bedroom DirecTV
    device: 5009591D6969

It is important to notice that the host and port variables for slave/Genie receivers are the same as the master receiver.


Media control services

Available services: turn_on, turn_off, media_play, media_pause, media_stop, media_next_track, media_previous_track, play_media

Service media_player.play_media

Service data attribute Optional Description
entity_id yes Target a specific media player. Defaults to all.
media_content_id no The channel number to change to.
media_content_type no A media type. Has to be channel.