DirecTV Stream Tuner - Docker Image with 23,000+ Movies & Live TV

Playground Custom Channels
#1

I've been working on a Docker-based solution that turns DirecTV Stream into an IPTV-compatible system with M3U playlists. Wanted to share it with the
community!

What It Does

This Docker container runs a headless Chrome browser that connects to DirecTV Stream and exposes it as standard M3U playlists that work with TvMate,
VLC, Channels DVR, and other IPTV apps.

Features

:tv: DirecTV Live TV

  • 348 channels with automatic channel switching
  • EPG (Electronic Program Guide) - 830+ channels with full program data
  • Auto-refresh EPG every 4 hours
  • HLS streaming with native pause/rewind support
  • noVNC web viewer to see/control the browser

:clapper: CinemaOS Movies (23,000+ Movies!)

  • 23,148 unique movies with full metadata (posters, ratings, genres, overviews)
  • Automatic updates - scans for new movies every 6 hours
  • Direct API integration - no browser needed for movie streams
  • VOD with full pause/rewind/forward support

:movie_camera: Additional VOD Providers

  • Cineby movies
  • 1Movies

Quick Start

Docker Hub:
docker pull sunnyside1/directvtuner:latest

Run it:

docker run -d \
  --name dvr-tuner \
  -p 7070:7070 \
  -p 6080:6080 \
  -p 9222:9222 \
  -v ./chrome-profile:/data/chrome-profile \
  sunnyside1/directvtuner:latest

First-time setup:

  1. Go to http://YOUR_IP:6080 (noVNC)
  2. Log into DirecTV Stream with YOUR credentials
  3. Session is saved for future use

M3U Playlist URLs

Content URL
DirecTV Live TV http://YOUR_IP:7070/tve/directv/playlist.m3u
DirecTV EPG http://YOUR_IP:7070/tve/directv/epg.xml
CinemaOS Movies (23K+) http://YOUR_IP:7070/cinemaos/playlist.m3u
Cineby Movies http://YOUR_IP:7070/cineby-playlist.m3u

Key Endpoints

/health - Health check
/tuners - Tuner status
/cinemaos/stats - Movie database stats
/cinemaos/auto-refresh/status - Check auto-update status
/tve/directv/epg/status - EPG refresh status

Network Options

Works with:

  • Bridge networking (standard Docker)
  • Host networking
  • Macvlan (container gets its own IP - great for Unraid)

Requirements

  • Docker
  • DirecTV Stream subscription (you log in with YOUR account)
  • The image does NOT include any credentials

Links

Architecture

┌─────────────────────────────────────────────────┐
│ Docker Container │
├─────────────────────────────────────────────────┤
│ Chrome (Headless) + FFmpeg + Node.js │
│ │ │
│ ┌─────────────────────────────────────────┐ │
│ │ Stream Proxy (port 7070) │ │
│ │ • DirecTV Live Streams │ │
│ │ • EPG (auto-refresh 4 hrs) │ │
│ │ • CinemaOS Movies (auto-refresh 6 hrs) │ │
│ │ • VOD Providers │ │
│ └─────────────────────────────────────────┘ │
└─────────────────────────────────────────────────┘
│
M3U/HLS Output
│
┌─────────┴─────────┐
│ │
VLC TvMate/Channels

Auto-Refresh Schedule

Service Interval
DirecTV EPG Every 4 hours
CinemaOS Movies Every 6 hours

Both run automatically in the background - no manual intervention needed!

Let me know if you have any questions or run into issues. Happy to help!

1 Like
#2

Hello, is this for linux docker only or will it run in docker for windows as well?

#3

If I was a DirecTV Stream subscriber, I would try it.
But I wanted to say this is a very interesting project.
Thank you for sharing.

Have you considered an option to select which services the user wants to use? For example if somebody just wants the DirecTV Stream and not the other one.

Just one thought I had. :wink:

2 Likes
#4

Looks very compelling, thanks for sharing, but when I tried installing on my M1 Mac Mini, I got this error:

The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8) and no specific platform was requested```
#5

I was able to install it as a Windows docker container and I can get the epg fine. But trying to play a channel does nothing, chrome doesn't open and the Channels log doesn't show it at all.

#6

An AMD64 image is not going to install on an ARM64 Mac.

#7

I just fired it up on my Synology and streams play through the VNC. I'm about to try the Channels playlist

#8

Yeah, I got them in VLC too. But not starting a chrome instance.

#9

Yes, that's understood. This is a request then, if it's possible, for an image that would install, for those of us running our servers on ARM64 machines.

#10

hi there,
Are the directv channels hard coded inito the app or does it adjust according to the subscription you have?
Looks like a nice new system is quite hellpful in getting the docker running nice and stable.
I made the error of unning it on my Synology and it clearly doesn't have enough resources.
I like the docker and i think it is great.
If you use it with channels, the stations will need to be mapped or you will need to grab EPG from the container.
I personally would suggest running it through Play list manager.
Great job so far. love the setup. i will probably put it on a more powerful system and see how it plays. Looks like the free channels aren't included but that would be a lot of work.

thanks

1 Like
#12

Should work for Windows Docker

#13

Good idea I'll add that option

2 Likes
#14

I'll fix it

#15

I'll take a look

#16

I'm going to make one for fubo right now. I have fubo as my main, and I'm using their m3u. I was able to pull it and proxy it over with Docker, but I'm missing channels, so I will do the same setup as I did for direct tv stay tune. Let me know what sub you have and will try to do a setup for that too. My inspiration came from an HDMI tuner from another post and though there has to be a better way

1 Like
#17

I'll take a look it does take a bit do you see the channel switching over in VNC

#18

Will do

#19

Thanks what free channels, its hardcoded I can see if there is a api for direct tv thag grabs yours sub and see what you have and map according to that I know Fubo TV has one.

1 Like
#20

Thank you all for the comments please provide feedback and I'll do my best to accommodate.

#21

No, it doesn't switch in VNC. Thanks for app!