gnarr/epg repository overview

This image is automatically built by a github action that follows all changes to iptv-org/epg⁠.

⁠EPG

Tools for downloading the EPG (Electronic Program Guide) for thousands of TV channels from hundreds of sources.

⁠Table of contents

• 🐋 Docker⁠
• 📺 Playlists⁠
• 🗄 Database⁠
• 👨‍💻 API⁠
• 📚 Resources⁠
• 💬 Discussions⁠
• 🛠 Contribution⁠
• 📄 License⁠

⁠Docker

⁠Create and run container

docker run -p 3000:3000 -v /path/to/channels.xml:/epg/channels.xml gnarr/epg

By default, the guide will be downloaded every day at 00:00 UTC and saved to the /epg/public/guide.xml file inside the container.

From the outside, it will be available at this link:

http://localhost:3000/guide.xml

or

http://<your_local_ip_address>:3000/guide.xml

⁠Environment Variables

To fine-tune the execution, you can pass environment variables to the container as follows:

docker run \
-p 5000:3000 \
-v /path/to/channels.xml:/epg/channels.xml \
-e CRON_SCHEDULE="0 0,12 * * *" \
-e MAX_CONNECTIONS=10 \
-e GZIP=true \
-e CURL=true \
-e PROXY="socks5://127.0.0.1:1234" \
-e DAYS=14 \
-e TIMEOUT=5 \
-e DELAY=2 \
gnarr/epg

⁠Database

All channel data is taken from the iptv-org/database⁠ repository. If you find any errors please open a new issue⁠ there.

⁠API

The API documentation can be found in the iptv-org/api⁠ repository.

⁠Resources

Links to other useful IPTV-related resources can be found in the iptv-org/awesome-iptv⁠ repository.

⁠Discussions

If you have a question or an idea, you can post it in the Discussions⁠ tab.

⁠Contribution

Please make sure to read the Contributing Guide⁠ before sending issue⁠ or a pull request⁠.

And thank you to everyone who has already contributed!

⁠Backers

⁠Contributors

⁠License