Watch IPTV playlists in VLC

What this is about

IPTV here means streaming live TV over the internet using playlist files (often M3U), not installing a separate “IPTV app” from an unknown source. VLC Media Player can play these streams if you give it a playlist URL or file.

This guide uses the community project iptv-org/iptv on GitHub, which maintains a large collection of links to publicly available streams (no video files are hosted in the repo itself—see their README and Legal section).

What you need

• VLC Media Player (VideoLAN) installed on Windows, macOS, or Linux.
• A stable internet connection (live streams use bandwidth continuously).
• The main playlist URL from the project is:

https://iptv-org.github.io/iptv/index.m3u

Other curated playlists are listed in their PLAYLISTS.md file if you want smaller lists (by country, category, etc.).

Step 1 — Open the playlist in VLC (URL)

1. Start VLC.
2. Go to Media → Open Network Stream… (on macOS: File → Open Network…).
3. Paste the playlist URL, for example:
   • https://iptv-org.github.io/iptv/index.m3u
4. Click Play.

VLC should load the playlist and start playing the first entry, or show the playlist panel so you can pick a channel.

Step 2 — Browse channels

• Open the playlist view: View → Playlist (or Ctrl+L / ⌘+L on Mac).
• Expand the list and double-click a channel to switch streams.

If nothing plays, try another entry—public streams often change or go offline; that is normal for this kind of list.

Step 3 — Optional: save the playlist locally

1. In a browser, open the same .m3u URL and save the file (e.g. iptv.m3u), or use VLC: Media → Open Network Stream, play once, then use Media → Save Playlist to File if your VLC version offers it after loading the network playlist.
2. In VLC: Media → Open File… and choose the .m3u file.

Useful if you want to edit the file in a text editor to keep only certain channels.

Tips

• Large playlists can be slow to load; prefer a smaller playlist from PLAYLISTS.md for quicker browsing.
• EPG (program guide) is a separate topic; the iptv-org README points to their epg utilities—VLC’s support for EPG with IPTV varies; many people use dedicated IPTV apps for full EPG.
• Keep VLC updated for better codec and HTTPS support.

Legal and responsibility

The iptv-org repository explains that it does not host video files—only links—and includes a Legal notice about copyright and how to report problematic links. You are responsible for complying with the laws in your country and the terms of your internet provider. This article is for technical education (using VLC with public playlist URLs), not for circumventing paywalls or licensing.

References

• iptv-org/iptv — GitHub repository
• Main M3U playlist — https://iptv-org.github.io/iptv/index.m3u
• More playlists — PLAYLISTS.md