---
id: directv
version: "0.4.0"
license: MIT license
license_treatment: permissive
maintenance: abandoned
---

# directv — Asynchronous Python client for DirecTV (SHEF).

License: permissive · Maintenance: abandoned · Downloads: 74.4K/mo

## What it is and what it does

This package provides an async Python client for DirecTV receivers using the SHEF protocol. It lets you connect to a DirecTV receiver on your network and send commands to monitor its state and control playback, channels, and associated client devices. The client is built on aiohttp for async HTTP communication and yarl for URL handling, making it suitable for integration into async applications like home automation systems.

The package is straightforward to use—you instantiate a DIRECTV object with a receiver IP address and use async context managers to interact with it. However, it has been abandoned since 2023-03-07 with no active maintenance, so it may not work with newer receiver firmware or Python versions beyond those listed in its classifiers.

Use it for:

- Integrate DirecTV receiver control into a home automation system that needs async operations
- Monitor and report the status of DirecTV receivers across a household network
- Build a custom remote control application that sends commands to DirecTV receivers via SHEF
- Automate channel changes or recording management on DirecTV receivers programmatically

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Asynchronous Python client for controlling and monitoring DirecTV receivers via the SHEF protocol over a network connection.

Yes, if you need to control a DirecTV receiver and are willing to accept the maintenance risk. The package is simple, has low install friction, and carries no known vulnerabilities. However, verify first that the SHEF protocol implementation works with your receiver's firmware version, and be aware that no updates are forthcoming if compatibility issues arise.

## Install

pip install directv
uv add directv
poetry add directv

## Installing directv

Before you install: Low install friction with only 2 runtime dependencies. However, the package is abandoned—last commit was 2023-03-07 and no releases since 2020-09-12. Maintenance has ceased, so bug fixes and compatibility updates are unlikely.

License in practice: MIT license is permissive, allowing commercial and private use with minimal restrictions. You may use, modify, and distribute this package freely as long as you include the license notice.

Quickstart:

pip install directv

import asyncio
from directv import DIRECTV

async def main():
    async with DIRECTV("192.168.1.100") as dtv:
        print(dtv)

asyncio.run(main())

Verify before relying:

- Whether the SHEF protocol implementation remains compatible with current DirecTV receiver firmware versions
- Whether this package has been tested against Python versions beyond 3.8
- Whether aiohttp and yarl dependencies work with modern Python environments

## Package facts

- License: MIT license (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 74.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

directv receiver control, directv async client, shef protocol python, directv remote api, directv monitoring, directv network control, directv client library, home-automation, async-client, abandoned

[View on SkillFed](https://skillfed.io/packages/directv) · [View on PyPI](https://pypi.org/project/directv/)