GridTV

GridTV

Real-time IPTV TV program guide, supports Tunarr and any XMLTV/M3U sources, provides EPG Timeline grid and built-in HLS player.

38GitHub
Description

##Functional characteristics - ˇ **EPG Timeline Grid ** -Horizontal electronic program guide view with real-time "current" indicator - ** Mobile adaptation ** -list view of mobile optimization - 丨ˇ ** Built-in HLS player ** -Click on the channel to play in the picture-in-picture window, HTTP→HTTPS transparent proxy - ** Multiple EPG sources ** -Configure multiple EPG/M3U sources and switch in the top bar - ** Personal EPG** -Allow visitors to use their own EPG/M3U URL - ˇ** Category filtering ** -Filter by movies, sports, news, children, etc. - ** Channel search ** -Search by channel name or program title/introduction (anti-shake processing) - * * Favorite channels ** -Top display favorite channels (localStorage persistence) - ** Theme system ** - 4 sets of built-in themes, supporting custom CSS themes - ** Multi-language ** -Automatic detection of browser language, support EN/FR/ES - ** Program reminder ** -Browser notification reminds you of upcoming programs - ˇ* * Configuration can be re-edited ** -protected by admin key, no need to modify configuration by SSH - ** Manage Health Page ** -Diagnostic Configuration, XMLTV/M3U Connectivity, Metadata Coverage - ˇ ** 24h print and export ** -Generate daily program listings in PDF/PNG format - ** Automatic refresh ** -Automatically refreshes EPG data every 30 minutes ###Initial Configuration Wizard When accessing for the first time, GridTV detects a missing configuration file and automatically jumps to the Setup page: | **Group name** |The name displayed in the upper left corner of the top bar (such as 'Home Theater')| | **EPG sources** |Add XMLTV source URL (required) and M3U playlist URL (optional)| | **Personal EPG** |Are visitors allowed to use their own EPG/M3U URL| An **Admin Key** will be automatically generated after submission. Please be sure to save this key! This key is required for subsequent configuration modifications. >Admin Key will be automatically saved in the browser localStorage, and no need to be entered repeatedly in the same browser. If you need to modify the source in the future, you can add "/setup.php" after the address to reconfigure and save. ###Relationship between EPG and M3U GridTV requires two data sources to work together: | data source| format| role| Required| |--------|------|------|----------| | **EPG (XMLTV)** | `.xml` / `.xml.gz` |Provide ** Program Guide **(channel name, program title, broadcast time, introduction)| Required| | ** M3U playlist **| `.m3u` / `.m3u8` |Provide ** video stream address **(the live stream URL corresponding to each channel)| Optional️ (if none is available, it cannot be played)| Note: Available test addresses Name: China Channel, EPG URL: `https://epg.pw/xmltv/epg_CN.xml`, M3U URL: `https://iptv-org.github.io/iptv/countries/cn.m3u` ** Working principle **: - The EPG determines what channels and programs ** are displayed in the Timeline grid ** → If there is no EPG, the grid is empty - When M3U decides to click on a channel, ** what video stream to play ** → Without M3U, you can only watch the program list and not play it - The two are associated through ** channel name matching **: the channel name in EPG needs to be consistent with the channel name in M3U to match correctly

Screenshots
Screenshot 1
Screenshot 2
Screenshot 3
App Information
Version
1.7.0
Package Size
114.04 KB
Image Size
172.58 MB
Updated
April 3, 2026
Source Code
Johnnybegood90
Platform Support
PC
Keywords
IPTVEPGTV GuideXMLTVM3UHLS Player