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.
Screenshot to addVLC in the Mac Applications folder -
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.
Screenshot to addVLC File menu with Open Network highlighted on a Mac -
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.
Screenshot to addSmarters Xtream Codes screen on a Mac -
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.
Screenshot to addMac menu bar with the player quit
Log in to your subscription
VLC takes the M3U or a single stream URL. Smarters takes Xtream Codes. Paste from the welcome message. The Mac paste shortcut is Command-V.
Xtream Codes API (preferred)
Any name you will recognise.
Paste the username from the welcome message.
Paste the password. It is case sensitive.
Replace this with the server URL from your email or WhatsApp.
M3U URL
Use this if the app has no Xtream Codes button. Replace USER and PASS.
Only needed when the app asks for a separate programme guide.
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.