Apple TV guide
iPlayTV setup on Apple TV
To set up iPlayTV, install the player from the App Store on your Apple TV, add a new playlist, choose Xtream Codes and enter the server URL, username and password from your welcome email. Save it and give the first load a few minutes. Prefer a single link? Add your M3U URL as a remote playlist instead.
- About 5 minutes
- tvOS 18.6+
- Xtream Codes · M3U · file
Before you start
What you need
- An Apple TV running tvOS 18.6 or later
- The iPlayTV app from the App Store ($5.99, sold by Andre Silva)
- Your playlist details from our welcome email (free trial or paid plan)
- An iPhone or iPad nearby to type with (optional, but much faster)
Tip: type with your iPhone
When a text field is selected on Apple TV, a keyboard notification usually appears on an iPhone signed into the same Apple Account, or open the Apple TV Remote from Control Center. Paste the server URL, username and password from the email instead of typing them letter by letter with the Siri Remote.
Method 1 · recommended
Add your playlist with Xtream Codes
- 1
Install iPlayTV on your Apple TV
Open the App Store on the Apple TV and search for "iPlayTV – IPTV/M3U Player" by Andre Silva. The listing requires tvOS 18.6 or later and is a paid download ($5.99 at the time of writing).
- 2
Open the add-playlist screen
Launch iPlayTV. On first launch it asks for a playlist; otherwise open the app's settings and choose to add a new playlist.
- 3
Choose Xtream Codes
Pick the Xtream Codes playlist type. It needs three fields instead of one long link and normally brings the TV guide with it.
- 4
Enter your details
Give the playlist a name, then enter the server URL, username and password from your welcome email exactly as written, including http:// and the port. Use your iPhone as a keyboard (see the tip below).
- 5
Save and wait for the first load
Save the playlist and leave the app open. The first sync downloads the channel groups, movies and series and can take a few minutes.
- 6
Tidy it up
Add favorites and reorder them, and check the guide. The listing also mentions EPG time shift and matching the TV's frame rate if you need them.
Method 2
Add your playlist with an M3U URL
Use this when you'd rather paste one link, or to compare with Xtream Codes while troubleshooting.
- 1
Add a remote playlist
In iPlayTV, add a new playlist and choose the remote URL (M3U) option.
- 2
Paste the M3U URL
Paste the full M3U URL from your email. A single missing character breaks it, so paste rather than type.
- 3
Add the EPG URL
If the guide stays empty, add the EPG URL from your email in the playlist's EPG field. The app's listing says it reads EPG URLs with gzip/tar content.
If something's off
Common iPlayTV playlist problems
- iPlayTV playlist not loadingWhen a playlist won't load in iPlayTV, the cause is usually a mistyped or clipped M3U URL, an expired trial, or a very large playlist timing out. Delete the playlist and add it again using Xtream Codes (server URL, username and password) instead of the M3U link, make sure iPlayTV is up to date, restart the Apple TV, and give the first load a few minutes.Fix it
- Invalid username, password or serverInvalid-credential errors almost always come from a typo, a missing http:// or port in the server address, or a trial that has ended. Paste each value from your welcome email rather than typing it, keep the exact upper and lower case, and confirm your trial or plan is still active.Fix it
- Buffering and freezingMost buffering starts inside the home: weak Wi-Fi at the TV, a busy connection, or a distant VPN server. Test speed on the streaming device itself, switch to Ethernet or 5 GHz Wi-Fi, restart the device and router, and pause big downloads. If one channel buffers while others play smoothly, report that channel to support.Fix it
- TV guide (EPG) missing or wrong timesA blank guide usually means the EPG hasn't been added or hasn't finished downloading. With Xtream Codes the guide normally comes with the login; with an M3U playlist, add the EPG URL from your email separately. If listings are off by whole hours, check the Apple TV's time zone, then use iPlayTV's EPG time-shift setting.Fix it
- Connection errors and 'max connections'Each plan allows 1 to 5 devices to stream at the same moment. A 'max connections' message means more screens are playing than your plan allows, or a device didn't close its stream. A 'server unreachable' or network error usually points to your internet connection, DNS or VPN. Close other streams, wait two minutes, restart your router and try again.Fix it
Setup FAQ
iPlayTV setup questions
How do I add a playlist to iPlayTV?
Open iPlayTV on Apple TV, add a new playlist, choose Xtream Codes, enter the server URL, username and password from your provider, then save and wait for the channels to load. You can also add an M3U URL as a remote playlist.
Does iPlayTV come with channels?
No. The App Store listing states that users supply their own playlist and that the developer doesn't provide or control content. The channels come from your playlist subscription.
Which Apple TV models work with iPlayTV?
The App Store listing requires tvOS 18.6 or later and is Apple TV only. Any Apple TV that runs that tvOS version can install it; check Settings › General › About for your version.
Is iPlayTV free?
No. The Apple TV app is listed at $5.99 on the US App Store. Our playlist subscription is a separate purchase.
Can I add more than one playlist?
Yes. The listing describes multi-playlist support and search across all playlists.
Who do I contact if the app itself crashes?
The app's developer, through its App Store page. We support the playlist: logins, channels and loading errors. iplaytv.site sells IPTV playlist subscriptions. It does not make, sell or support the iPlayTV player app and is not affiliated with or endorsed by the app's developer, by Apple, or by any other website that uses the iPlayTV name. Apple TV is a trademark of Apple Inc.
Need a playlist to add? Start a free trial.
Request a 24-hour trial playlist, add it to your player and judge it on your own TV and network. No card needed. Plans start at $13.