EXTINF Tag Explained — Every M3U Attribute Reference
Understanding what EXTINF means is crucial for working with M3U playlists. #EXTINF is the most important tag in an M3U file. The EXTINF tag appears before every stream URL and tells the player the duration, display name, logo, category, and EPG identifier for that entry. This EXTINF guide breaks down every attribute with practical examples.
Full EXTINF Syntax
A complete #EXTINF line for an IPTV channel shows the full EXTINF format structure like this:
#EXTINF:-1 tvg-id="bbc.one" tvg-name="BBC One" tvg-logo="https://example.com/bbc1.png" group-title="UK",BBC One HD
http://provider.example.com/live/user/pass/101.tsEvery EXTINF Attribute Explained
Let’s break down each EXTINF attribute in detail:
Duration in EXTINF (-1 or seconds)
The first value after #EXTINF:, before any EXTINF attributes. For VOD content (music, films) this is the duration in seconds. For live streams, use -1 in the EXTINF tag to indicate an unknown or infinite duration.
| Value | Meaning | When to use |
|---|---|---|
-1 | Unknown / live | IPTV channels, live radio, live streams |
233 | 3 minutes 53 seconds | MP3 files, podcasts, VOD with known length |
0 | Technically invalid but widely tolerated | Avoid |
tvg-id
The channel identifier used to match this entry to an EPG (Electronic Program Guide) data source. The value must match exactly what your EPG provider uses for that channel.
tvg-id="bbc.one.uk"If tvg-id doesn’t match the EPG source, the player won’t show programme information for that channel. See the EPG guide for how matching works.
tvg-name
The channel name as used internally by the IPTV app. Some apps use this for EPG matching as a fallback when tvg-id is missing. It should match the channel name in your EPG source.
tvg-name="BBC One"tvg-logo
A URL to the channel logo image. The IPTV player downloads and displays this image in the channel list. Supported formats are typically PNG or JPG.
tvg-logo="https://example.com/logos/bbc1.png"If the logo URL is broken or the server is slow, the player will show a placeholder icon. This does not affect stream playback.
group-title
Groups channels into categories in the IPTV player’s UI. Players like TiviMate and IPTV Smarters create folder-style categories from this value.
group-title="News"Common values: News, Sports, Movies, Entertainment, Kids, UK, US, etc. Channels with the same group-title value are grouped together.
Display name (after the comma)
The text after the final comma in the #EXTINFline is the display name shown in the player’s channel list. This is what the user sees — make it clean and readable.
#EXTINF:-1 ...,BBC One HDCommon EXTINF Mistakes to Avoid
Here are the most common EXTINF syntax errors and how to fix them:
| Mistake | Effect | Fix |
|---|---|---|
Blank line between #EXTINF and URL | Player skips the entry entirely | Remove blank lines — URL must immediately follow EXTINF |
| Missing comma before display name | Player shows nothing or the whole attribute string as the name | Ensure a comma separates the last attribute from the display name |
tvg-id doesn’t match EPG source | No programme guide data | Check exact spelling against your EPG provider’s channel list |
Broken tvg-logo URL | No logo displayed | Test the URL directly in a browser; replace with a working URL |
| Wrong duration value | Progress bar shows incorrect time | Use -1 for live streams; use actual seconds for VOD |
Complete EXTINF Examples
Here are real-world EXTINF examples showing the tag in action:
#EXTM3U
#EXTINF:-1 tvg-id="bbc.one.uk" tvg-name="BBC One" tvg-logo="https://logos.example.com/bbc1.png" group-title="UK",BBC One HD
http://provider.example.com/live/user/pass/101.ts
#EXTINF:-1 tvg-id="sky.sports.main" tvg-name="Sky Sports Main Event" tvg-logo="https://logos.example.com/skysports.png" group-title="Sports",Sky Sports Main
http://provider.example.com/live/user/pass/201.ts
#EXTINF:5400 tvg-id="" tvg-name="" tvg-logo="" group-title="Movies",The Dark Knight (2008)
http://provider.example.com/vod/user/pass/darkknight.mp4Validate your EXTINF tags automatically
The M3U Validator checks every EXTINF line for syntax errors, missing commas, malformed EXTINF attributes, and validates the complete EXTINF tag structure.
FAQ
What does #EXTINF mean?
#EXTINF stands for Extended Information. It is the metadata tag that appears before each media URL in an extended M3U playlist.
What does -1 mean in #EXTINF?
-1 is used as the duration for live streams or media with unknown length. The player won't show a progress bar or expect a defined end time.
What is tvg-id?
tvg-id identifies a channel for EPG matching. It must match the channel ID in your EPG source exactly for programme guide data to appear.
What is group-title?
group-title categorises the channel into a folder in the IPTV player UI. Channels with the same group-title are grouped together.