Technical Guide Learn how to configure M3U links and EPG program guides on your favorite media players.
Get Started

IPTV M3U Playlists and EPG Guides Setup

Master the technical setup of M3U playlist files and Electronic Program Guides (EPG). Learn how to load channels, structure program lists, and avoid syncing issues.

Understanding the Basics of IPTV M3U Playlist Files

When you subscribe to a digital television network like **qwevotv**, your access credentials are mapped into specific data formats. The most common format is the **M3U playlist link**. An M3U (MP3 URL) file is a plain text file containing a structured index of streaming paths. Each line in the file defines the channel name, group category, channel logo URL, and the direct server stream address.

Because these files are text-based, they are highly compatible and can be parsed by almost every media player application, including VLC, Kodi, smart televisions, and mobile applications. When you enter your M3U playlist link into your chosen app, it contacts our servers, parses the text file, and displays the structured list of categories and feeds on your screen.

How an M3U Playlist is Structured

A standard IPTV M3U file utilizes standard metadata tags: 

#EXTM3U
#EXTINF:-1 tvg-id="US_ESPN" tvg-name="ESPN HD" tvg-logo="https://qwevo-tv.site/logos/espn.png" group-title="US Sports",ESPN HD
http://qwevo-tv.site:80/live/username/password/10245.ts
The #EXTM3U header declares the file format. The #EXTINF tag holds metadata such as the channel guide ID (tvg-id), channel name (tvg-name), logo URL (tvg-logo), and the category group (group-title). The bottom line contains the actual server streaming portal path with your unique username and password keys.

What is an Electronic Program Guide (EPG)?

Streaming a channel list is only half the battle; knowing what is currently broadcasting is equally important. An **Electronic Program Guide (EPG)** is an XML-based metadata schedule (often labeled as an XMLTV guide) that maps show schedules, description text, cast lists, and episode numbers to specific channel feeds.

When you load an EPG link in your player, the application matches the tvg-id from your M3U playlist with the program schedule in the XMLTV file. This populates your screen with an interactive grid showing:

  • Current and upcoming shows.
  • Detailed movie descriptions and genre tags.
  • Start and end times of sports matches.
  • Visual progress bars indicating show duration.

Connecting via Xtream Codes API (Recommended Format)

While M3U playlist files are highly compatible, they do not update channels or guide schedules automatically. If a channel frequency changes or our VOD directory updates, you must reload the playlist manually.
To avoid this, we highly recommend connecting via the **Xtream Codes API**. The API splits your subscription login details into three simple lines:

  1. Server URL / Host: http://qwevo-tv.site:80 (or the specific portal URL in your email).
  2. Username: Your unique username key.
  3. Password: Your unique password key.
When you log in using the API, your player app establishes a secure connection with our database, updating channel categories, movie poster graphics, and EPG schedules automatically in the background every 24 hours.

How to Map EPG Links Manually (If Using M3U)

If you choose to use raw M3U files on legacy systems (like MAG boxes or VLC), you must configure your EPG source manually:

  1. Navigate to the settings menu of your player application.
  2. Locate the section labeled **EPG Sources**, **TV Guide sources**, or **XMLTV sources**.
  3. Paste the EPG URL address received in your qwevotv welcome email (typically ending in xml.gz or /xmltv.php).
  4. Save settings and force a manual data refresh. The app will parse the XML file and populate your channel guide grids.

Troubleshooting Common Playlist & EPG Sync Issues

If you encounter issues during setup, they can usually be resolved with these technical fixes:

  • Channels Loading But No EPG Guide: Ensure the channel guide ID (tvg-id) inside your player settings matches the guide source. In some lightweight apps, you must click "Force EPG Refresh" to trigger the database sync.
  • Playlist Fails to Load / Connection Error: Check for typos in your M3U URL. M3U links are case-sensitive and must not contain spaces. If the URL is correct but still fails, your ISP may be blocking DNS resolution. Switch your device DNS settings to Google Public DNS (8.8.8.8) or Cloudflare DNS (1.1.1.1) to restore access.
  • EPG Guide Data is Offset (Incorrect Time): If your program guide shows schedules that are off by several hours, go to your player's EPG settings and adjust the **Time Offset** parameter (e.g. +1h or -2h) to match your local timezone.

View Subscription Plans