lostfilm / EPlusTV

Virtual linear channels for ESPN+

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Current version: 2.0.2

About

This takes ESPN/ESPN+, FOX Sports, and NBC Sports programming and transforms it into a "live TV" experience with virtual linear channels. It will discover what is on, and generate a schedule of channels that will give you M3U and XMLTV files that you can import into something like Jellyfin, Channels, or xTeVe.

Notes

  • This was not made for pirating streams. This is made for using your own credentials and have a different presentation than the ESPN, FOX Sports, and NBC Sports apps currently provide.
  • The Mouse might not like it and it could be taken down at any minute. Enjoy it while it lasts. ¯\(ツ)

Using

The server exposes 2 main endpoints:

Endpoint Description
/channels.m3u The channel list you'll import into your client
/xmltv.xml The schedule that you'll import into your client

Running

The recommended way of running is to pull the image from Docker Hub.

Docker Setup

Environement Variables

Environment Variable Description Required?
START_CHANNEL What the first channel number should be. No. If not set, the start channel will default to 1.
NUM_OF_CHANNELS How many channels to create? This is dependent on the networks you are using. A good number to start with is > 100 if you are using ESPN+. No. If not set, it will default to 150.
PUID Current user ID. Use if you have permission issues. Needs to be combined with PGID. No
PGID Current group ID. Use if you have permission issues. Needs to be combined with PUID. No
MAX_RESOLUTION Max resolution to use. Valid options are UHD/HDR, UHD/SDR, 1080p, 720p, and 540p (Some providers don't offer 4K or 1080p and will attempt to play the highest framerate available for selected resolution). If not set, UHD/SDR is the default.

Available channel options

ESPN

Use if you would like to login with a TV provider or ESPN+ and access various ESPN events

Environment Variable Description Default
ESPNPLUS Set to false if you only want events that come from your TV provider True
ESPN ESPN: Set if your TV provider supports it False
ESPN2 ESPN2: Set if your TV provider supports it False
ESPN3 ESPN2: Set if your TV provider supports it False
ESPNU ESPNU: Set if your TV provider supports it False
SEC SEC Network: Set if your TV provider supports it False
SECPLUS SEC Network+: Set if your TV provider supports it False
ACCN ACCN: Set if your TV provider supports it False
ACCNX ACCNX: Set if your TV provider supports it False
LONGHORN Longhorn Network: Set if your TV provider supports it False
FOX Sports

Use if you would like to login with a TV provider and access various FOX Sports events

Environment Variable Description Default
FOXSPORTS Set if your TV provider supports it False
FOXSPORTS_ALLOW_REPLAYS If you would like to schedule events that aren't live False
NBC Sports

Use if you would like to login with a TV provider and access various NBC Sports events

Environment Variable Description Default
NBCSPORTS Set if your TV provider supports it False

Volumes

Volume Name Description Required?
/app/config Used to store DB and application state. Yes

Docker Run

By default, the easiest way to get running is:

docker run -p 8000:8000 -v config_dir:/app/config m0ngr31/eplustv

If you run into permissions issues:

docker run -p 8000:8000 -v config_dir:/app/config -e PUID=$(id -u $USER) -e PGID=$(id -g $USER) m0ngr31/eplustv

Once it runs for the first time, check the Docker logs to see what the next steps for authentication are.

About

Virtual linear channels for ESPN+


Languages

Language:TypeScript 99.4%Language:Dockerfile 0.3%Language:Shell 0.3%