How to Use an M3U Playlist with TiviBridge

Step-by-step setup

1. Request your M3U link

   Message TiviBridge on WhatsApp and ask for your M3U playlist link. Tell us which app and device you are using, so we can send the most suitable version. The link is personal, because it contains your username and password. Keep it out of forums, group chats and public cloud folders.

   Get your TiviBridge login

2. Understand the parts of the link

   A typical link looks like http://server.example:8080/get.php?username=YOURNAME&password=YOURPASS&type=m3u_plus&output=ts. The first part is your server and port. Then come your login details. The type setting m3u_plus adds logos and group names, and output chooses the stream format. Do not edit these parts unless we ask you to.

3. Pick TS or HLS output

   Most modern apps work best with output=ts, which sends a continuous MPEG transport stream. Some smart TV apps and older devices prefer HLS, shown as output=m3u8 or output=hls in the link. If channels open to a black screen, ask us for the HLS version instead of guessing the change yourself.

4. Add the link in your player

   In TiViMate choose Add playlist > M3U playlist and enter the URL. In IPTV Smarters Pro choose Load Your Playlist or File/URL, then M3U URL. In VLC on a computer, open Media > Open Network Stream and paste the link. In Smart IPTV, upload it on siptv.app with the TV's MAC address.

5. Add the programme guide URL

   An M3U file lists channels but usually no programme data. Ask us for your XMLTV EPG link, which often ends in xmltv.php followed by your login. In TiViMate add it under Settings > EPG > EPG sources. In Smarters it is loaded automatically once you log in. VLC does not show a guide.

6. Check the guide against CET

   Open a channel you know well, such as ZDF, ORF 1, TVP1 or NPO 1, and compare the guide with what is on screen. If the times are an hour out, set the device time zone to your own city instead of a fixed offset. Then use the app's EPG time shift only if a gap remains.

7. Set an automatic update interval

   Use the link itself, not a downloaded copy of the file. A link lets the app fetch the current line-up each time. In TiViMate set the playlist update interval under Settings > Playlists. In other apps, turn on refresh at start-up. A daily update keeps the channel list and logos current.

What is an M3U playlist?

Open an M3U file in a text editor and it looks roughly like this, shown here with made-up addresses:

#EXTM3U
#EXTINF:-1 tvg-id="ZDF.de" tvg-logo="http://server.example/logos/zdf.png" group-title="Germany",ZDF HD
http://server.example:8080/live/YOURNAME/YOURPASS/1001.ts

The first line marks the file as an extended M3U. Each channel then takes two lines: an info line with its tags, and the stream address. The tvg-id tag links the channel to the right entry in the programme guide, and group-title decides which folder it appears in, such as Germany, Polska or Belgium.

M3U vs M3U8

M3U and M3U8 are the same playlist format. The 8 means the file is saved in UTF-8, so accented and special letters display correctly. That matters in Europe, where channel names include characters like ö, ł, é and ë. The same extension is also used for HLS streaming, which can cause confusion.

In practice you do not need to choose. TiviBridge sends the version that suits your app. For a full explanation of how the login and playlist relate, see our Xtream Codes guide.

Adding the XMLTV programme guide

The programme guide comes as a separate XMLTV file. Your app matches each channel's tvg-id in the M3U to an entry in that file and shows what is on now and next. Without it, you see channel names but no programme titles.

• TiViMate: Settings > EPG > EPG sources, then add the XMLTV link. See our TiViMate setup guide.
• Smart IPTV: the guide is matched from the playlist on siptv.app. See our Smart IPTV guide.
• IPTV Smarters Pro: with an M3U login, add the EPG link in the profile settings, or switch to an Xtream Codes login for automatic loading.
• VLC: no guide support. Use it for testing only. The player is free from VideoLAN.

Guide times are usually stored in UTC and converted by your device. Setting the device to your own city keeps the guide aligned with CET in winter and CEST in summer.

Why free M3U lists fail

Free M3U lists shared on websites, forums and code repositories look tempting, but they rarely last. Most stop working within days, the rest buffer badly at busy times, and many carry legal and security risks. We do not publish, link or recommend any of them.

• They die quickly. Streams are shared without permission, so they are taken down or blocked, often in the middle of a match.
• They are overloaded. Thousands of people pull the same stream, which no server can deliver smoothly.
• They can be unsafe. The pages hosting them often push adverts, fake players or malware.
• They carry legal risk. The EU Court of Justice held in the Filmspeler case (C-527/15) that streaming from a source you know is unlicensed is not covered by the temporary-copy exception. Read more in our article on IPTV legality in Europe. This is general information, not legal advice.

A paid service with a personal link avoids these problems. Try TiviBridge with a 24-hour free trial, then pick a plan on our euro pricing page.

Common errors and fixes

The playlist is empty or will not load

The link is incomplete, often cut off when copied from a message. Check that it includes your username, password, type and output settings. Paste it into a browser on a computer: if a file starts downloading, the link works and the problem is in the app. If not, ask us to check your account.

Logos and group names are missing

The link probably uses type=m3u rather than type=m3u_plus. The plain version lists only stream addresses and basic names. Ask us for the m3u_plus version of your link, then replace the old one in your app and refresh the playlist.

The link works in VLC but not on the TV

VLC plays almost any format, while TV apps are pickier. Ask for the HLS version of the link for your TV app. Also check that the app is not limited to a maximum number of channels, which some free TV apps apply to large playlists.

Channels stop working after a day or two

You probably loaded a downloaded file instead of the live link. Stream addresses and tokens can change, and a saved file does not update itself. Remove the old playlist and add the link again, so the app always pulls the current version from our server.

Error 401, 403 or access denied

The server rejected your login or your connection limit is full. Close the app on other devices and try again. If your plan has ended, the same error appears. Check the expiry in your activation message, then renew or contact us on WhatsApp.

Other apps that work with TiviBridge

Written by TiviBridge Editorial Team · Last updated September 5, 2026