DirecTV SHEF (Set-top Box HTTP Command Interface) is a built-in protocol that allows you to control DirecTV HD receivers and Genie DVRs over a local network using simple HTTP requests. By utilizing HTTP GET requests via port 8080, it completely replaces the need for unreliable IR blasters in smart home systems. Phase 1: Network & Receiver Configuration
Before sending commands, you must configure the DirecTV box to prevent communication drops and give it permission to accept external commands.
Assign a Static IP: Go to Menu > Settings > Internet Setup > Advanced Setup. Assign a permanent static IP address to your receiver or create a DHCP reservation inside your home router.
Enable External Access: Navigate to Menu > Settings > Whole Home > External Device. Set both External Access and Current Program to Allow.
Identify Client MACs (For Genie Minis): If controlling a Genie client, navigate to Settings > System Info on that client. Note its MAC Address without colons (e.g., 00112233AABB). Phase 2: Command Syntax & Integration
Commands are issued via standard HTTP GET URLs. Open a web browser or configure your smart home platform to call the following endpoints: 1. Emulating Remote Control Presses
To emulate pushing a physical button, target the remote/processKey endpoint.
Syntax: http://[Receiver_IP]:8080/remote/processKey?key=[Key_Name] Example (Power On): http://192.168.1
Common Key Constants: poweron, poweroff, format, rew, pause, play, stop, ffwd, guide, menu, info, exit, up, down, left, right, select, chanup, chandown, prev, or single digits 0–9. 2. Direct Channel Tuning
Instead of firing multiple button presses, you can pass a direct channel number.
Syntax: http://[Receiver_IP]:8080/tv/tune?major=[Channel_Number] Example (Tune to Channel 202): http://192.168.1 3. Requesting System Status (Feedback)
You can poll the unit to pull live metadata into your automation system dashboard. Here’s how to use IP Control on your DIRECTV receiver
Leave a Reply