148 lines
9.4 KiB
Markdown
148 lines
9.4 KiB
Markdown
# epg-info-docker
|
|
|
|
This repo builds and Docker image of [iptv-org/epg](https://github.com/iptv-org/epg).
|
|
The purpose is to make the deployment easier and more suitable for different environments.
|
|
|
|
The original repository of this image is hosted on https://git.claeyscloud.com/david/epg-info-docker.<br>
|
|
A public mirror is available at https://github.com/davidclaeysquinones/epg-info-docker.
|
|
|
|
## Dependencies
|
|
[Node](https://nodejs.org/en)<br>
|
|
[pm2](https://www.npmjs.com/package/pm2)<br>
|
|
[serve](https://www.npmjs.com/package/serve)<br>
|
|
|
|
The image is based on `node:21-alpine` in order to be more lightweight.
|
|
The `pm2` and `serve` packages are used in order to run the application in the container.
|
|
## Docker image
|
|
|
|
### Paths
|
|
|
|
#### Channels file
|
|
An example `channels.xml` is included by default in the image.<br>
|
|
```xml
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
<channels>
|
|
<channel site="movistarplus.es" lang="es" xmltv_id="24Horas.es" site_id="24H">24 Horas</channel>
|
|
...
|
|
</channels>
|
|
```
|
|
However if you want to configure your own channels you need to provide your own configuration file.<br>
|
|
You can do this by creating a mapping in the `/config` folder.
|
|
|
|
#### Custom fixes
|
|
|
|
Through the `ENABLE_FIXES` variable custom provider fixes can be applied to the container.
|
|
By default some fixes are available. These fixes have been validated before being added to this repo.
|
|
However this option is disabled by default since you might only want to run the unmodified source.
|
|
If you have suggestions or a problem with them please submit an issue.
|
|
|
|
This the list of the provided custom fixes :
|
|
|
|
| Provider | Author(s) | Status |
|
|
|------------------|------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
| movistarplus.es | [davidclaeysquinones](https://github.com/davidclaeysquinones) | [PR](https://github.com/iptv-org/epg/pull/2440) pending approval |
|
|
| orangetv.es | [fraudiay79](https://github.com/fraudiay79) and [davidclaeysquinones](https://github.com/davidclaeysquinones) | PR not submitted |
|
|
| pickx.be | [davidclaeysquinones](https://github.com/davidclaeysquinones) and [BellezaEmporium](https://github.com/BellezaEmporium) | [PR](https://github.com/iptv-org/epg/pull/2480) merged since commit [296d616](https://github.com/iptv-org/epg/commit/296d6162ecbeb1b3c3e392845187d30624d50aa2) |
|
|
| telenet.tv | [davidclaeysquinones](https://github.com/davidclaeysquinones) | [PR](https://github.com/iptv-org/epg/pull/2429) merged since commit [fd382db](https://github.com/iptv-org/epg/commit/fd382db08da7a96150928b8dcfef115e29e661d3) |
|
|
| web.magentatv.de | [klausellus-wallace](https://github.com/klausellus-wallace) | [PR](https://github.com/iptv-org/epg/pull/2458) merged since commit [61afe09](https://github.com/iptv-org/epg/commit/61afe090b6e7892cc5426457d960e9452222f885) |
|
|
|
|
If for some reason you want to include your own provider fixes this is possible by creation a mapping in the `/fixes` folder.<br>
|
|
The expected structure is */fixes/`provider_name`/`provider_name`.config.js*.<br>
|
|
It is recommended that you take existing provider code as a base for your customisations.
|
|
|
|
### Environment Variables
|
|
|
|
| Variable | Description | Default |
|
|
|-------------------------------|----------------------------------------------------------------------------|----------------------------------|
|
|
| CRON_SCHEDULE | CRON expression describing the recurrence for epg retrieval. | `0 0,12 * * *` |
|
|
| DAYS | Describes the desired amount of days in the future for for epg retrieval. | 14 |
|
|
| MAX_CONNECTIONS | The maximum amount of parallel connections that can be established | 10 |
|
|
| ENABLE_FIXES | Some fixes to providers take a long time to be merged into the main branch.<br>When this option is enabled some of these fixes will also be included.<br>The source code for these fixes can be seen under the `fixes` folder.<br> Recreate the container when changing this variable in order for it to take effect | false |
|
|
| API_URL | The endpoint where channel information will be grabbed | `https://iptv-org.github.io/api` |
|
|
|
|
### Compose file
|
|
|
|
```sh
|
|
version: '3.3'
|
|
services:
|
|
epg:
|
|
image: git.claeyscloud.com/david/epg-info:latest
|
|
#image: ghcr.io/davidclaeysquinones/epg-info:latest
|
|
#image: davidquinonescl/epg-info:latest
|
|
volumes:
|
|
# add a mapping in order to add the channels file
|
|
- /docker/epg:/config
|
|
ports:
|
|
- 6080:3000
|
|
environment:
|
|
# specify the time zone for the server
|
|
- TZ=Etc/UTC
|
|
# uncomment the underlying line if you want to enable custom fixes
|
|
#- ENABLE_FIXES=true
|
|
restart: unless-stopped
|
|
```
|
|
|
|
### Versions
|
|
|
|
This image is bound to the content of the [iptv-org/epg](https://github.com/iptv-org/epg) repository. In the underlying list you can see to which commit each version of the docker image is bound.
|
|
|
|
Normally when a change is made in the source repository the documentation is updated and a new tag is created in this repository. This is completely normal since the source repository is only cloned during the build process of the docker image.
|
|
|
|
Sometimes a new version of this image will be bound to the same source commit. This will happen when improvements are made to the image.
|
|
|
|
- 1.0.0
|
|
[08-01-2024](https://github.com/iptv-org/epg/commit/793c74ca397504fc2afc8fbfa998e0b8e4ca45d9)
|
|
- 1.0.1
|
|
[08-14-2024](https://github.com/iptv-org/epg/commit/270e85cfae6f0f691c2e6ab7ce511d60fd687565)
|
|
- 1.0.2
|
|
[09-07-2024](https://github.com/iptv-org/epg/commit/4e3b06a86e225cdd1b9362a683e6770fb68ff28f)
|
|
- 1.0.3
|
|
[09-14-2024](https://github.com/iptv-org/epg/commit/c69f3c93b1123ddf0fecc62c7067fced59ae4e99)
|
|
- 1.0.4
|
|
[09-30-2024](https://github.com/iptv-org/epg/commit/d90c7a54b941238cb92391b33d80a75e746d3002)
|
|
- 1.0.5
|
|
[10-02-2024](https://github.com/iptv-org/epg/commit/713dbf60a1cb9623ffcab6ab370ee9a78b32102b)
|
|
- 1.0.6
|
|
[10-02-2024](https://github.com/iptv-org/epg/commit/713dbf60a1cb9623ffcab6ab370ee9a78b32102b)<br>Adds possibility to enable custom fixes
|
|
- 1.0.7
|
|
[10-02-2024](https://github.com/iptv-org/epg/commit/713dbf60a1cb9623ffcab6ab370ee9a78b32102b)<br>Adds improvement to the docker image size
|
|
- 1.0.8
|
|
[10-10-2024](https://github.com/iptv-org/epg/commit/2241bc261fd37b8b16e036a0b61167030a5ce2e6)
|
|
- 1.0.9
|
|
[10-12-2024](https://github.com/iptv-org/epg/commit/fd382db08da7a96150928b8dcfef115e29e661d3)
|
|
- 1.0.10
|
|
[10-14-2024 12:50](https://github.com/iptv-org/epg/commit/a3e7661f95103cbee4bcb78bd483396680e9abfc)
|
|
- 1.0.11
|
|
[10-14-2024 17:34](https://github.com/iptv-org/epg/commit/7610f7b9f5cc1ccab8d17f3408a95d31b36ace7c)
|
|
- 1.0.12
|
|
[10-14-2024](https://github.com/iptv-org/epg/commit/7610f7b9f5cc1ccab8d17f3408a95d31b36ace7c)<br>Fix Pickx.be url
|
|
- 1.0.13
|
|
[10-14-2024](https://github.com/iptv-org/epg/commit/7610f7b9f5cc1ccab8d17f3408a95d31b36ace7c)<br>Add custom fix for web.magentatv.de
|
|
- 1.0.14
|
|
[10-14-2024](https://github.com/iptv-org/epg/commit/7610f7b9f5cc1ccab8d17f3408a95d31b36ace7c)<br>Change fix for movistarplus.es in order to work with new API
|
|
- 1.0.15
|
|
[11-26-2024](https://github.com/iptv-org/epg/commit/d15911006e163262c0c7f267deae28160c0d7a8f)<br>Add option to customize channel endpoint
|
|
- 1.0.16
|
|
[11-26-2024](https://github.com/iptv-org/epg/commit/d15911006e163262c0c7f267deae28160c0d7a8f)<br>Fix icons for movistarplus.es
|
|
- 1.0.17
|
|
[11-26-2024](https://github.com/iptv-org/epg/commit/d15911006e163262c0c7f267deae28160c0d7a8f)<br>Update fix for pickx.be
|
|
- 1.0.18
|
|
[11-27-2024 01:51](https://github.com/iptv-org/epg/commit/78dad4cfb4fc16f078c3b44b5534779c7c645b6b)
|
|
- 1.0.19
|
|
[11-27-2024 15:43](https://github.com/iptv-org/epg/commit/e5f0850b3b2e35ed394f00ac68b699eaabc4f0e4)
|
|
- 1.0.20
|
|
[11-28-2024](https://github.com/iptv-org/epg/commit/da18b70ddb1c3950e5a315411fd9aeaf60b6092c)
|
|
- 1.0.21
|
|
[11-28-2024](https://github.com/iptv-org/epg/commit/da18b70ddb1c3950e5a315411fd9aeaf60b6092c)<br>Add orangetv.es
|
|
- 1.0.22
|
|
[11-30-2024](https://github.com/iptv-org/epg/commit/1883338c0aee9909ac4567312b25701d10a765f2)
|
|
- 1.0.23
|
|
[12-02-2024](https://github.com/iptv-org/epg/commit/296d6162ecbeb1b3c3e392845187d30624d50aa2)
|
|
- 1.0.24
|
|
[12-02-2024](https://github.com/iptv-org/epg/commit/296d6162ecbeb1b3c3e392845187d30624d50aa2)<br>Fix for movistarplus.es channel grabber
|
|
- 1.0.25
|
|
[12-04-2024](https://github.com/iptv-org/epg/commit/864e0ac2c4761d926b203a85a382a4bdc87fbc17)
|
|
- 1.0.26
|
|
[12-05-2024](https://github.com/iptv-org/epg/commit/581441834af6f089c3930ad2d7ff1de2c701a6d9)
|
|
- 1.0.27
|
|
[12-07-2024](https://github.com/iptv-org/epg/commit/ce4f3e69358385d1fb8e79df8129c63d6314a802) |