If you want a full channel list and a programme guide, use the official Smarters app for Mac, or an iPhone player on the same Apple ID. Do not install a modified Mac app.
In short
- Install VLC from the official VideoLAN site.
- Choose File → Open Network and paste the M3U URL.
- Use Smarters when you want the guide rather than a single test.
What you need
- A Mac on a current macOS version.
- VLC from VideoLAN, or Smarters from the official Mac download.
- The M3U link or the Xtream login.
Recommended app
Use VLC. VLC is the direct test on a Mac. Smarters is the alternative when you want the channel list to stay on screen. Other players that also work: IPTV Smarters Pro .
Step by step
-
Install VLC
Download VLC from the official VideoLAN website and drag it to Applications. Open it once. If macOS blocks it, open System Settings → Privacy & Security and allow VLC.
-
Open the network stream
In VLC choose File → Open Network. Paste the M3U URL and click Open. If you only have Xtream details, use Smarters instead of trying to build a URL by hand.
-
Use Smarters for the guide
Install the official Smarters Mac app if you want live categories, films and the EPG. Choose Xtream Codes and enter the username, password and server URL.
-
Quit the app when you stop watching
Closing the window is not always enough. Quit VLC or Smarters from the menu bar so the connection is released for a television in another room.
If something goes wrong
Swipe sideways to see every column.
| Problem | Cause | Fix |
|---|---|---|
| Buffering | The Wi-Fi drops, or the stream is 4K on a line that cannot hold it. | Prefer Ethernet or 5 GHz. A Mac on a busy 2.4 GHz network pauses in the evening. Test one HD channel before you open 4K. |
| Black screen | The player opened the stream but the video decoder failed. | Open Network must contain the full URL, including http and the port if one was sent. A black window usually means the URL was cut off. |
| Login failed | A username, password or URL was typed with a space or a missing character. | In Smarters, paste each field separately. Command-V into the wrong box is easy when the password is hidden. |
| EPG not loading | The guide URL is empty, or the device clock is wrong. | VLC will not show the IPTV guide. Switch to Smarters and paste the XMLTV URL if the guide is a separate field. |
| App not installing | Unknown sources are off, or the store cannot see the app. | Only allow the app in Privacy & Security if you downloaded it from the publisher. A blocked app from another site should stay blocked. |
| Guide times are an hour out | The EPG offset does not match UK time, or daylight saving has changed. | Set the Mac timezone to London and turn Set date and time automatically on. The guide follows that clock. |
Mac questions
Why is the menu different from Windows?
VLC on a Mac uses File → Open Network. Windows uses Media → Open Network Stream. The URL you paste is the same.
Can I use IINA or another Mac player?
You can open a single stream URL in most Mac players. For the channel list and the guide, use an official IPTV player such as Smarters.
Does a Mac count as a device connection?
Yes, while it is playing. Quit the app to free the connection.
Will this work on Apple silicon?
Yes. Download the current VLC build from VideoLAN. It runs on Apple silicon and on Intel Macs.