Description

This gem allows one to control a DirecTV Set Top Box (STB or receiver). This works with the current implication of the "External Device" control system. DirecTV could change or even disable this method at any time without notice.

Requirements

net/http
json
External Device set to Allow on DTV Box (Menu -> Settings -> Whole-Home -> External Device - All set to 'Allow')

Install

Use rubygems to install the dtvcontroller gem:

$ gem install dtvcontroller

Example Usage

Initialize:

irb(main):001:0> require "dtvcontroller"
=> true
irb(main):002:0> set_top_box = Dtvcontroller::SetTopBox.new("192.168.1.100")
=> #<Dtvcontroller::SetTopBox:0x000000028ab450 @ip="192.168.1.100", @base_url="http://192.168.1.100:8080">

Get details on what's on with `#currently_playing`:

irb(main):003:0> set_top_box.currently_playing
=> "529: SEDGHD - The Lost World: Jurassic Park"

The output follows the format:

<Channel>:<Network> - <Program>: <Program Title if Available>

A TV show looks like this (note the episode title):

irb(main):004:0> set_top_box.currently_playing
=> "298: CNHD - Family Guy: Peters Tale"

Change the channel with `#tune_to_channel`:

irb(main):005:0> set_top_box.tune_to_channel(7)
=> "OK."

Channel Options:

Must be between 1-9999.

Simulate the remote with `#send_key`:

irb(main):006:0> set_top_box.send_key(:chanup)
=> "OK."

Remote Key Options:

:power
:poweron
:poweroff
:format
:pause
:rew
:replay
:stop
:advance
:ffwd
:record
:play
:guide
:active
:list
:exit
:back
:menu
:info
:up
:down
:left
:right
:select
:red
:green
:yellow
:blue
:chanup
:chandown
:prev
:0-9
:dash
:enter

Get details about the unit with `#system_info`:

irb(main):007:0> set_top_box.system_info(:access_card_id)
=> "0123-4567-8901"

System Info Options:

:access_card_id
:receiver_id
:stb_software_version
:version

dtvcontroller

Development