How to Set Up IPTV on Apple TV Using the iPlayTV App (2026 Guide)

iPlayTV is a paid, one-time-purchase IPTV player built exclusively for Apple TV (tvOS). To set it up: install iPlayTV from the Apple TV App Store, open it and tap Add Playlist, choose Xtream Server or M3U URL, enter the server address, username, and password from your provider, then tap Save — your live channels, EPG, and VOD library load within seconds.

Unlike free universal players, iPlayTV is a $5.99 one-time purchase on the Apple TV App Store with no subscription fee, and it requires tvOS 18.6 or later. This guide covers both setup methods field-by-field, how to read your credentials out of an M3U URL, every iPlayTV feature that matters, a comparison against the built-in Apple TV app, and fixes for the errors people actually run into. If you don’t yet have channels to load, start a free RevoIPTV trial — your Xtream Codes login and M3U URL arrive by email within minutes.

What Is iPlayTV and Why Use It on Apple TV

iPlayTV is a dedicated IPTV player built specifically for tvOS rather than a ported mobile app. It supports Xtream Codes API logins, plain M3U/M3U8 and XSPF playlists (including gzip- or tar-compressed EPG files), and offers a native, remote-friendly interface with full Electronic Programme Guide (EPG) support. It runs on Apple TV 3rd generation and newer, though current versions require tvOS 18.6+ — check your Apple TV software update status before installing if you’re on an older tvOS build. Because it uses both a VLC-based decoder and Apple’s native player, it can handle stream formats that some other players reject outright, which is why it consistently ranks among the top IPTV apps for Apple TV.

Before You Start: What You Need

• An Apple TV running tvOS 18.6 or later (check under Settings > General > About).
• An active IPTV subscription with either an Xtream Codes login (server URL, username, password) or an M3U URL.
• A stable internet connection — 15–25 Mbps minimum for reliable HD playback, more for multiple simultaneous streams.
• $5.99 for the one-time iPlayTV purchase (no recurring app fee).

If you need a subscription first, compare RevoIPTV plans or grab a free trial to test channels before buying.

Method 1 — Set Up iPlayTV with Xtream Codes (Recommended)

Xtream Codes is the preferred method because one login unlocks live channels, VOD, and catch-up TV together, plus automatic playlist refreshes. Your RevoIPTV welcome email contains the server URL, username, and password you need.

1. Open iPlayTV on your Apple TV. On first launch the home screen shows an Add Playlist button.
2. Tap “Add Playlist.” A menu appears listing the available playlist types.
3. Select “Xtream Server” to open the credentials screen.
4. Fill in the four fields:
   • Playlist name: any label, e.g. RevoIPTV — shown on your home screen.
   • Server URL: the address from your provider, e.g. http://yourserver.com:8080. Include the port number exactly as given.
   • Username: from your provider’s welcome email.
   • Password: from your provider’s welcome email.
5. Tap “Save.” iPlayTV authenticates with the server and downloads your full channel list, EPG data, and VOD categories.
6. Select your playlist from the home screen. Channels are grouped by category — tap a group, then tap a channel to start streaming.

Where to find your credentials: they’re in your RevoIPTV welcome email, and they’re also embedded in your M3U URL — look for username= and password= in the string; the server address is everything before /get.php. See the RevoIPTV tutorials hub for a visual walkthrough.

Method 2 — Set Up iPlayTV with an M3U URL

If your provider only supplies a plain M3U link rather than Xtream Codes credentials, use this method.

1. Tap “Add Playlist” from the iPlayTV home screen.
2. Select “M3U URL” from the playlist type menu.
3. Enter a Playlist name and paste your M3U URL into the URL field.
4. Add an EPG URL if your provider supplies a separate programme guide link — this enables the on-screen TV guide.
5. Tap “Save.” iPlayTV fetches the playlist and populates your channel list.

M3U setup gives you live channels only. For VOD and series libraries, use Xtream Codes where your provider supports it.

Navigating iPlayTV on Apple TV

Once a playlist loads, the interface is built around the Siri Remote:

• Channel groups: the left sidebar lists your playlist categories; use the trackpad to scroll.
• Channel list: selecting a group populates the channel list on the right; swipe right to move focus into it.
• Favourites: press and hold select on a highlighted channel to add it to favourites for quick access.
• Search: the search icon finds channels by name across all loaded playlists.
• EPG / TV Guide: with an EPG URL configured, press the menu button during playback to see what’s on now and next, including time-shift on supported channels.
• Audio and subtitles: press select during playback and swipe up to change audio language or subtitle track, including OpenSubtitles downloads.

Key Features of iPlayTV

• Xtream Codes API support — live, VOD, and catch-up from a single login.
• M3U, M3U8, and XSPF playlist support, including compressed EPG URLs.
• Full EPG with current/upcoming programme data and time-shift on Xtream providers.
• Multi-playlist management — add several providers and switch from the home screen.
• Channel search across all loaded playlists simultaneously.
• Favourites with reordering for your most-watched channels.
• Channel preview thumbnails (optional, enabled in settings).
• Automatic channel logo detection when your playlist lacks logo URLs.
• Dual player backend — VLC for maximum codec compatibility, Apple’s native player for hardware-accelerated smooth playback.
• AirPlay 2 support to mirror or route streams to other AirPlay 2 compatible devices.
• OpenSubtitles integration and multiple audio track switching.

Troubleshooting iPlayTV on Apple TV

• “Cannot connect to server” error: re-check the Server URL, username, and password for typos, and confirm the port number is included (e.g. :8080). Verify your subscription is active at RevoIPTV FAQs.
• Channels load but video won’t play: switch the player backend in iPlayTV’s settings from VLC to Apple player (or vice versa) — some streams need a specific decoder.
• EPG not showing programme data: add a valid EPG URL in the playlist settings; some providers send this separately from the M3U or Xtream login.
• Buffering or freezing: connect Apple TV to your router via Ethernet where possible and confirm at least 15–25 Mbps for HD streams (more for 4K or multiple devices).
• App storage filling up quickly: iPlayTV caches thumbnails and EPG data aggressively on some tvOS versions; clearing and reloading a playlist periodically resets the cache.
• AirPlay drops after Apple TV wakes from sleep: this is known iPlayTV behaviour — simply reselect your AirPlay device after the TV wakes.
• Need more app options? Compare every compatible player on the IPTV applications page.

iPlayTV remains one of the most capable dedicated IPTV players for Apple TV, pairing a clean tvOS interface with full Xtream Codes and M3U support, EPG, and AirPlay 2. Pair it with a free RevoIPTV trial to test your full channel lineup before committing, then view all RevoIPTV subscription options when you’re ready to subscribe. Running a reseller business? See the IPTV reseller packages for bulk credentials your customers can drop straight into iPlayTV.

FAQ

Is iPlayTV free? No. iPlayTV is a one-time $5.99 purchase on the Apple TV App Store with no recurring fee. You then use it with any IPTV subscription that provides an M3U URL or Xtream Codes credentials — the app itself includes no channels.

Does iPlayTV work on iPhone or iPad? No. iPlayTV is built exclusively for tvOS (Apple TV) and requires tvOS 18.6 or later. For iPhone or iPad, use a separate IPTV player such as GSE Smart IPTV or Flex IPTV from the App Store.

What’s the difference between M3U URL and Xtream Server in iPlayTV? An M3U URL points to a plain-text playlist file with your channel list only. Xtream Server uses a server URL, username, and password to connect directly to your provider’s platform, adding VOD, catch-up TV, and automatic updates alongside live channels — it’s the more feature-rich option when your provider supports it.

How do I find my Xtream Codes username and password? They’re in your IPTV provider’s welcome email. They’re also embedded in your M3U URL: the username appears after username= and the password after password= in the URL string, with the server address before /get.php.

Why is the EPG (TV guide) not showing in iPlayTV? The EPG needs a separate programme guide URL added under the playlist’s EPG URL field. Your provider should supply this alongside your M3U or Xtream login — contact their support if it wasn’t included in your welcome email.

Why does iPlayTV fill up my Apple TV’s storage? The app caches channel thumbnails and EPG data, which can grow large on lower-storage Apple TV models over weeks of use. Reloading or removing and re-adding a playlist periodically clears the cache.