Skip to content

Open source XMLTV data for UK free-to-air TV channels and radio stations

License

Notifications You must be signed in to change notification settings

dp247/Freeview-EPG

Repository files navigation

logo GitHub Workflow Status GitHub issues

Buy Me a Coffee at ko-fi.com

Freeview-EPG is a project designed to provide XMLTV data for UK free-to-air TV channels and radio stations for personal use.

image

About

This project exists because of a gap in the market - up until recently, it was very hard to get hold of a free, reliably updated and region-supported XMLTV file. You could either get a TV tuner and grab the data, or pay for it from a service. I didn't like either of those options - looking at what's on TV should be easy and free, so now it is.

Features

  • 48 hours of data, built every 8 hours. If your TV/IPTV client supports auto-refresh, this is very much a set-and-forget solution.
  • Supports regional channels, not just London-based/national ones.
  • Includes data for both TV and radio stations.
  • Data is reliably sourced from UK TV providers, rather than third parties.
  • Builds to an XMLTV file, complete with channel logos, programme images and season/episode numbering (where supported).

Usage

Grab the XMLTV file from this link and paste it into your favorite IPTV client:

https://raw.githubusercontent.com/dp247/Freeview-EPG/master/epg.xml

Contributing

Guidelines

  • Please check the FAQ to make sure your question hasn't already been answered.
  • Please report issues here, including as much detail as possible about the problem.
  • You can request channels here. Please bear in mind that a request is not a guarantee.
  • If you'd like to suggest a change or feature, feel free to either open a blank fork and PR back in. Big changes should be discussed in a blank issue first.

To-do

  • Improve code, maybe through splitting files and OOP
  • Speed up EPG processing, probably using async code
  • Finish adding regional stations
  • Implement a configuration file for easier forking (allow for more days, specify image type)

Special thanks

License

GNU General Public License v3.0

TLDR from TLDRLegal:
You may copy, distribute and modify the software as long as you track changes/dates in source files. Any modifications to or software including (via compiler) GPL-licensed code must also be made available under the GPL along with build & install instructions.

Disclaimers

  • You're welcome to request channel additions (see Contributing), but I'll only add channels that are free-to-air.
  • If you're looking for a longer EPG, the custom branch allows for this. However, the logic of the branch is also out-of-date and I have no immediate plans to continue development on it.
  • The software and data are provided as-is. While I intend for it to be as reliable as possible, certain aspects are out of my control.

Related projects

  • Streams to M3U8 - converts and maintains YouTube live streams in a single M3U8 playlist
  • iptv-cutter - deduplicator and generator of M3Us for popular IPTV services

Legal

  • This project extracts publicly available data from public-facing websites without the use of private APIs.
  • This project is not owned by, related to or affiliated with BBC, ITV plc, Channel Four Television Corporation, Sky Group, Everyone TV or DTV Services Ltd.