Setting Up EPG in MAT Player on MiBox: Full Guide

If you’re running MAT Player on a Xiaomi MiBox and your Electronic Programme Guide is empty, showing the wrong programmes, or simply missing channels — you’re not alone. EPG configuration is one of the most commonly misunderstood aspects of IPTV setup, and MiBox adds a few platform-specific quirks that can make it trickier than usual.

This guide explains exactly what EPG is, where to find reliable EPG sources, how to configure them in MAT Player step by step, covers MiBox-specific remote control and display settings, and provides a thorough troubleshooting section for when things don’t work as expected.

What Is EPG and Why Does It Matter?

EPG stands for Electronic Programme Guide. It’s the TV schedule data that appears when you press the guide button — the grid or list showing what’s currently on, what’s coming up, and what aired earlier.

Without EPG, your IPTV experience degrades significantly:

You can’t see what’s currently playing on each channel without switching to it
You have no way to know what’s coming up later
Reminder and scheduling features don’t work
Channel browsing becomes a slow, guesswork process

With a well-configured EPG, MAT Player on MiBox becomes as functional as a traditional cable or satellite receiver. You get a full programme grid, “now and next” information visible while watching, and the ability to plan your viewing in advance.

EPG data is delivered as an XMLTV file — a standardised XML format that lists channels and their scheduled programmes with start and end times, descriptions, categories, and ratings. Your IPTV app downloads this file, parses it, and displays the data alongside your channel list.

Finding Reliable EPG XML Sources

The quality of your EPG depends entirely on the source. There are three types of sources to consider:

1. Provider-Supplied EPG

The best EPG source for your channel list is the one your IPTV provider maintains themselves. It’s matched directly to their channel IDs, updated alongside the channel list, and requires no manual ID mapping.

How to get it: Contact your provider and ask for their XMLTV EPG URL. A good provider will give you a URL in this format:

http://yourprovider.com:PORT/xmltv.php?username=USER&password=PASS

Or alternatively:

http://yourprovider.com:PORT/epg.xml

Some providers include the EPG URL in their welcome email alongside the M3U and portal details. If you haven’t used it yet, check there first.

2. Public EPG Sources

For providers that don’t offer their own EPG, or to supplement missing channels, public XMLTV sources are available:

IPTV-org EPG: https://iptv-org.github.io/epg/guides/ — maintained EPG for specific countries and regions. Browse by country folder and use the epg.xml or epg.xml.gz file.
epgshare01.online: A popular third-party EPG aggregator with guides for many European channels. Files are often gzipped (.xml.gz) — MAT Player handles both formats.
rytec.channels.xml: A long-running community EPG project with extensive European channel coverage.

3. Self-Hosted EPG with WebGrab+Plus

For advanced users, WebGrab+Plus is an open-source EPG grabber that collects schedule data directly from broadcaster websites and outputs XMLTV files. Running it on a NAS, Raspberry Pi, or home server gives you the most accurate and up-to-date EPG data, but it requires technical setup beyond the scope of this guide.

Configuring EPG URL in MAT Player

Step 1: Open MAT Player Settings

Launch MAT Player on your MiBox.
Navigate to the Settings gear icon — on MiBox, this is usually accessible from the main menu or by pressing the Menu button on the remote.
Look for the EPG / Programme Guide section.

Step 2: Add Your EPG Source

Select EPG Sources or XMLTV URL (the exact label varies by MAT Player version).
Choose Add Source or Add EPG URL.
Enter your EPG URL. If using an Xtream Codes subscription with provider EPG, the format is typically:
```
http://yourprovider.com:PORT/xmltv.php?username=USERNAME&password=PASSWORD
```
Give the source a name (e.g., “Main Provider EPG”).

Step 3: Configure Time Offset

This is a frequently missed step that causes EPG times to appear wrong. The XMLTV file uses UTC time internally, and MAT Player must apply a timezone offset to display correct local times.

United Kingdom (GMT/BST): Offset 0 in winter, +1 in summer (BST)
Central Europe (CET/CEST): Offset +1 in winter, +2 in summer
US Eastern (EST/EDT): Offset -5 in winter, -4 in summer
US Pacific (PST/PDT): Offset -8 in winter, -7 in summer

Set this in Settings > EPG > Time Offset. If your EPG shows programmes 1 hour early or late, the offset is wrong by exactly one — adjust accordingly.

Step 4: Trigger Initial EPG Download

After saving the URL, look for a Refresh EPG, Update Now, or Download EPG button.
Tap it and wait. The first download can take 30–120 seconds depending on the file size and your connection speed.
A progress indicator or completion notification should appear when done.

Step 5: Verify EPG is Working

Navigate to any channel in MAT Player’s channel list.
If EPG is working, you’ll see programme information listed alongside the channel — current programme title and time, plus upcoming programmes.
Open the full Programme Guide (usually accessible via a dedicated button on the remote or from the channel menu) — you should see a populated schedule grid.

MiBox-Specific Tips

Remote Control Shortcuts in MAT Player

The Xiaomi MiBox remote has a specific button layout that maps to MAT Player functions in ways that aren’t always obvious:

D-pad up/down: Navigate channels in the list
D-pad left/right: In the EPG guide, move backwards/forwards in time
OK / Select button: Open the selected channel or confirm an action
Back button: Exit the current view or overlay
Home button: Exit MAT Player to the MiBox home screen (without closing the app)
Voice search button (on newer MiBox remotes): Not used by MAT Player natively
Play/Pause button: Pause the current stream (if pausing is supported by the channel)

EPG navigation shortcut: While watching a channel, press D-pad up to open a mini-EPG overlay showing the current and next programme. Press OK to open the full guide.

Display Settings for MiBox

MiBox outputs video via HDMI. For the best MAT Player experience:

Resolution matching:

Go to MiBox Settings > Display > Resolution and set it to match your TV’s native resolution (1080p for most TVs, 4K/2160p for UHD TVs).
Avoid setting it to “Auto” if you notice MAT Player’s UI flickering when switching between SD and HD channels — fixed resolution prevents mode-switching delays.

HDR settings: If you have a 4K HDR TV and are watching HDR IPTV streams, enable HDR Output in MiBox display settings. Note that MAT Player needs to support HDR pass-through for this to be effective — check your version’s release notes.

Overscan / screen fit: Some TV/MiBox combinations result in the MAT Player interface being partially cut off (overscan). Fix this by:

Adjusting the Screen Size setting in MiBox display settings (usually a percentage-based zoom control).
Or adjusting Overscan or Aspect Ratio in your TV’s picture settings.

Storage and Performance on MiBox

MiBox has limited RAM (2 GB on MiBox 4 and MiBox S models). To ensure MAT Player runs smoothly:

Clear unused apps from memory before launching MAT Player: press the Back button multiple times to reach the home screen, then long-press Home to open the recent apps list and close everything.
Avoid running multiple streaming apps simultaneously.
Enable Developer Options > Limit Background Processes if MiBox is running slowly — this restricts how many background apps can run concurrently.

Troubleshooting Missing or Wrong EPG Data

Problem: EPG is completely empty

Possible causes and fixes:

EPG URL is incorrect — paste the URL into a browser on your phone or computer. You should see an XML file (or a file download). If you get an error page, the URL is wrong.
Time offset not set — if your EPG source requires a specific time offset and it’s set to 0, programmes from a previous or future date range may not match the current time window. Adjust the offset.
EPG hasn’t downloaded yet — tap Refresh EPG manually and wait for completion.
File format unsupported — some EPG sources use .gz (gzip compressed) files. Confirm MAT Player in your version handles compressed XMLTV. If not, look for an uncompressed .xml version of the same source.

Problem: Wrong programmes showing on channels

This is the most common EPG issue and indicates a channel ID mismatch. The channel ID in your M3U playlist doesn’t match the channel ID in the XMLTV file.

How to fix:

Go to Settings > EPG > Channel Mapping.
Find the mismatched channel and tap Remap.
Search for the correct channel name in the EPG source list.
Select the correct match and save.

For systematic mismatches across many channels, check whether your IPTV provider offers an EPG URL specifically paired to their M3U — this eliminates the ID mismatch problem entirely.

Problem: EPG shows correct programmes but times are wrong

Your time offset is incorrect. Calculate the correct UTC offset for your timezone:

Find your current local time.
Find the current UTC time (available at time.is/UTC).
The difference is your offset. Enter it in Settings > EPG > Time Offset.

Also check whether the EPG source itself embeds timezone information. Some XMLTV files use timestamps with explicit timezone codes — in this case, you should set the offset to 0 in MAT Player and let the file’s own timezone data handle the conversion.

Problem: EPG stops updating after a few days

Your auto-refresh schedule may not be properly configured, or the EPG source URL may have changed.

Fix:

Verify the EPG URL is still live (paste it in a browser).
Go to Settings > EPG > Auto Refresh and confirm a schedule is active.
Check whether your MiBox enters a deep sleep mode that prevents background tasks. Go to MiBox Settings > Device Preferences > Sleep and set it to Always On or increase the sleep delay.

Setting Up an Automated EPG Refresh Schedule

Manual EPG refreshes work, but the best experience comes from automatic updates that run in the background without requiring any user action.

Configuring Auto-Refresh in MAT Player

Go to Settings > EPG > Update Schedule (or Auto Update).
Enable automatic updates.
Set the refresh interval. Recommended settings:
- For sports-heavy viewing (schedule changes frequently): Every 6 hours
- For general viewing: Every 12 hours
- For light use: Every 24 hours
Set the update time to off-peak hours — 3:00 AM or 4:00 AM is ideal, as your MiBox and network are idle, ensuring the download completes without affecting streaming performance.

Keeping MiBox Awake for Scheduled Tasks

By default, MiBox may enter a power-saving state that interrupts background processes:

Go to MiBox Settings > Device Preferences > Sleep.
Set screen sleep separately from system sleep — the screen can turn off, but the system should remain active.
Alternatively, use MAT Player’s Keep Awake setting (if available) which prevents the device from sleeping while the app is in the background.

With a properly scheduled auto-refresh, your EPG will always be current without any manual intervention.

Conclusion

A properly configured EPG transforms MAT Player on MiBox from a basic channel switcher into a full-featured TV guide experience. The key steps are: get your EPG URL from your provider first (it’s almost always better-matched than a public source), set the correct timezone offset, trigger an initial manual download, and then configure an overnight auto-refresh schedule.

The most common issues — empty EPG and mismatched programmes — both have straightforward solutions once you understand the channel ID mapping system. Spend 10 minutes on initial configuration and you’ll have a reliable, accurate programme guide that updates itself automatically going forward.