Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dp247/freeview-epg
Open source XMLTV data for UK free-to-air TV channels and radio stations
https://github.com/dp247/freeview-epg
epg epgdata freeview iptv tv uk xmltv xmltv-epg-data
Last synced: 23 days ago
JSON representation
Open source XMLTV data for UK free-to-air TV channels and radio stations
- Host: GitHub
- URL: https://github.com/dp247/freeview-epg
- Owner: dp247
- License: gpl-3.0
- Created: 2023-04-16T17:32:50.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-10-29T08:15:56.000Z (about 2 months ago)
- Last Synced: 2024-10-29T09:33:16.753Z (about 2 months ago)
- Topics: epg, epgdata, freeview, iptv, tv, uk, xmltv, xmltv-epg-data
- Language: Python
- Homepage:
- Size: 994 MB
- Stars: 61
- Watchers: 4
- Forks: 12
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
 
Freeview-EPG is a project designed to provide XMLTV data for UK free-to-air TV channels and radio stations for personal use.
## 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](https://github.com/dp247/Freeview-EPG/wiki/FAQ) to make sure your question hasn't already been answered.
- Please report issues [here](https://github.com/dp247/Freeview-EPG/issues/new?assignees=&labels=bug&template=issue-report.md&title=%5BIssue%5D), including as much detail as possible about the problem.
- You can request channels [here](https://github.com/dp247/Freeview-EPG/issues/new?assignees=&labels=channel&template=channel-request.md&title=%5BChannel+request%5D). 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](https://github.com/dp247/Freeview-EPG/issues/new) 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
- This project was heavily influenced by iptv-org's [EPG](https://github.com/iptv-org/epg) project
- [ExperiencersInternational](https://github.com/ExperiencersInternational) for all the testing and contributions
- The [tv-logos](https://github.com/tv-logo/tv-logos) and [mediaportal-uk-logos](https://github.com/Jasmeet181/mediaportal-uk-logos) projects, for making channel icon finding so simple
- This project would not be possible without the support of [Jetbrains' OSS licenses](https://www.jetbrains.com/community/opensource/)
## License
[GNU General Public License v3.0](https://github.com/dp247/Freeview-EPG/blob/master/LICENSE)
```text
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](#contributing)), but I'll only add channels that are **free-to-air**.
- If you're looking for a longer EPG, the [custom](https://github.com/dp247/Freeview-EPG/tree/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](https://github.com/dp247/YouTubeToM3U8) - converts and maintains YouTube live streams in a single M3U8 playlist
- [iptv-cutter](https://github.com/dp247/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.