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/eplustvIf 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/eplustvOnce it runs for the first time, check the Docker logs to see what the next steps for authentication are.