Current version: 2.1.12

About

This takes ESPN/ESPN+, FOX Sports, Paramount+, MSG+, and MLB.tv 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 or Channels.

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 MLB.tv apps currently provide.
• The Mouse might not like it and it could be taken down at any minute. Enjoy it while it lasts. ¯\(ツ)/¯

If you're using the USE_LINEAR option, have your client pull the XMLTV file every 4 hours so it can stay current if channels change.

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.

Environement Variables

Environment Variable	Description	Required?	Default
START_CHANNEL	What the first channel number should be.	No	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 >= 150 if you are using ESPN+.	No	150
PROXY_SEGMENTS	Proxy keyed *.ts files.	No	False
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	-
PORT	Port the API will be served on. You can set this if it conflicts with another service in your environment.	No	8000

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 don't want to use ESPN+	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
ESPNEWS	ESPNews: Set if your TV provider supports it	False
ESPN_PPV	PPV: Set if you have purchased PPV events	False

FOX Sports

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

Environment Variable	Description	Required?	Default
FOXSPORTS	Set if your TV provider supports it	No	False
FOXSPORTS_ALLOW_REPLAYS	If you would like to schedule events that aren't live	No	False
MAX_RESOLUTION	Max resolution to use. Valid options are UHD/HDR, UHD/SDR, and 720p (Some events don't offer 4K and will attempt to play the highest framerate available for selected resolution).	No	UHD/SDR
FOX_ONLY_4K	Only grab 4K events	No	False

Paramount+

Use if you would like to login with Paramount+

Environment Variable	Description	Required?	Default
PARAMOUNTPLUS	Set if you would like CBS Sports events	False	False

MLB.tv

Use if you would like to login with your MLB.tv account

Environment Variable	Description	Default
MLBTV	Set if you would like to use MLB.tv	False
MLBTV_USER	MLB.tv Username	False
MLBTV_PASS	MLB.tv Password	False
MLBTV_ONLY_FREE	Only schedule free games	False

MSG+

Use if you would like to login with your MSG+ account

Environment Variable	Description	Default
MSGPLUS	Set if you would like to use MSG+	False
MSGPLUS_USER	MSG+ Username	False
MSGPLUS_PASS	MSG+ Password	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.