How to Restore Missing EPG (TV Guide) on Xtream Codes (2026 Guide)

1. Understanding EPG (XMLTV) Electronic Program Guides

An Electronic Program Guide (EPG) is an interactive grid overlay that displays current and upcoming broadcast titles, episode descriptions, channel logos, and catch-up TV schedules.

When connecting via our Xtream IPTV server credentials, player apps automatically fetch XMLTV data from our dedicated EPG server endpoint (`/xmltv.php`). Part of our Xtream IPTV Troubleshooting Hub, this tutorial fixes all guide display failures.

📺 How EPG Data Synchronization Works:

XMLTV File Fetch: Player app contacts http://server.net:8080/xmltv.php every 24 hours.
Channel ID Matching: The player matches channel names (e.g. US | HBO HD) to XMLTV stream IDs.
Local SQLite Storage: The player parses the XML data into a fast local database cache on your device.

2. The 5 Main Causes of EPG Failures

Cause 1: Corrupted Local EPG Database Cache

Over time, incomplete downloads or app updates corrupt the player's internal SQLite database file, preventing new EPG listings from displaying.

Cause 2: Timezone Offset Shift (Broadcast Clock Mismatch)

The channel schedule is downloaded in UTC time, but your device is set to EST/PST, causing shows to display 3 to 5 hours early or late in the grid.

Cause 3: Unassigned Channel EPG Source

Custom channel group names or edited playlist titles fail to automatically pair with default XMLTV channel IDs.

Cause 4: ISP DNS Blocking of xmltv.php Endpoint

Internet Service Providers occasionally block large XML file downloads from IPTV domain hostnames.

TiviMate Master Protocol

3. TiviMate EPG Purge & Time Shift Protocol

Follow these exact steps to restore missing EPG listings in TiviMate IPTV Companion:

Purge Corrupted EPG Cache: Open TiviMate Settings → EPG → EPG Sources → Clear EPG. Click OK to confirm.
Trigger Manual EPG Update: Click Update EPG. Watch the progress bar download XMLTV data from your active playlist source.
Fix Timezone Time Shift Offset: If program times are offset by hours, go to Settings → EPG → EPG Sources → [Your Xtream Playlist] → Time Shift. Adjust value to +2.00, -3.00, etc., until show times match your local clock.
Assign EPG Source Manually to Blank Channels: Long press on any channel showing "No Information" → Select Assign EPG → Type channel name (e.g., ESPN HD) → Select matching EPG ID.

IPTV Smarters Pro Fix

4. IPTV Smarters Pro EPG Reload Guide

Open IPTV Smarters Pro on Firestick, Smart TV, or iOS.
Click the Settings Gear Icon at top right.
Select "Install EPG" / "EPG Timeline".
Click Clear EPG Data.
Click Refresh EPG Data & VOD to force download the full TV guide XML file.

Smart TV Fix

5. Smart TV (Smart One & IBO Player) EPG Fix

On Samsung Tizen OS and LG webOS apps like Smart One IPTV & IBO Player:

Press Reload / Refresh on the main TV app dashboard.
If guide remains blank, visit the app upload portal (e.g. smartone-iptv.com or iboplayer.com) on your phone.
Re-save your Xtream Codes API credentials and click Generate EPG.

6. Custom XMLTV EPG URL Endpoints for Legacy Players

If you use custom player software (such as VLC, Kodi, or Perfect Player) that requires a manual XMLTV link:

Xtream Codes XMLTV Endpoint Syntax:

http://xtream-server.net:8080/xmltv.php?username=YOUR_USER&password=YOUR_PASS

7. Frequently Asked Questions

Why is my IPTV TV Guide (EPG) completely blank?

A blank EPG guide occurs when your local XMLTV database cache becomes corrupted, your player app fails to complete the initial data sync, or your device DNS blocks the server's xmltv.php endpoint.

How do I fix EPG show times being off by several hours?

EPG timezone offset is fixed using the 'EPG Time Shift' setting inside TiviMate or IPTV Smarters. Change the offset value (+1, +2, -3 hours) until program start times align with your local TV clock.

What is the official XMLTV EPG URL format for Xtream Codes?

The standard XMLTV EPG URL endpoint for Xtream Codes API is: http://xtream-server.net:8080/xmltv.php?username=YOUR_USER&password=YOUR_PASS

How to Restore Missing EPG (TV Guide) (2026)