IPTV on Apple TV: how to set up and use an IPTV player

What you need for IPTV on Apple TV

• An Apple TV, signed in to the App Store with your Apple Account.
• A network connection: Wi-Fi on every model, or Ethernet on models that have a port.
• A player built for Apple TV, installed from the App Store on the Apple TV itself.
• Details from your provider: either a login or a playlist address.

Apple TV runs Apple’s tvOS software, which is why you’ll see apps described as “for tvOS”. For how providers and players fit together in general, read the IPTV basics.

Apple TV apps vs iPhone and iPad apps

A player on your iPhone or iPad doesn’t automatically exist on Apple TV. Apple TV apps are built separately by the developer and go through App Store review as their own version. Some developers link the two so that buying on one device covers the other (Apple calls this a universal purchase), but many IPTV players are published for iPhone and iPad only.

So check the App Store on the Apple TV, not on your phone. And if a developer has made both, don’t assume they behave the same: the Apple TV version is designed around the remote and the big screen, and may have different options.

Find an IPTV player for Apple TV

For an IPTV app for Apple TV, the essentials are: it’s listed in the App Store on the Apple TV, the developer is identifiable, it supports the access format your service provides, it’s comfortable with the remote and readable at a distance, it has a programme guide if you want one, and it’s still updated. The full set of criteria, for every platform, is in our cross-platform player guide; this page doesn’t name or rank players.

Install the player from the App Store

1. 1

   Open the App Store on Apple TV

   From the Home Screen, open the App Store and search or browse for the player.

2. 2

   Check the listing

   Look at the developer’s name and the description, including which login formats the player supports.

3. 3

   Select Get or Buy

   If you see Install instead, you’ve already got it on your account and can download it again at no extra cost.

The Apple TV notes in our installation centre list what to have ready before you open the player.

Enter your IPTV access details

The details come from your IPTV service only: not from Apple TV, tvOS, the App Store or the player. The player will ask for one of two kinds:

• Xtream Codes-style login: a server address, a username and a password, entered in separate fields.
• M3U playlist: a single link to your channel list, which can be long. Some players also ask for a guide link.

Typing on the Apple TV on-screen keyboard with a remote is slow, and one wrong character stops the service loading. Apple TV has a useful shortcut: when a text field appears, an iPhone or iPad signed in to the same Apple Account (with Wi-Fi and Bluetooth on) shows a notification, and you can type the details on its keyboard instead. That makes a long playlist link much easier to get right. Neither format is better in every case; the one to use is the one your service supplied and your player supports.

Using IPTV with the Apple TV remote

Apple TV remotes differ by generation. Newer Siri Remotes have a clickpad and a Back button; the earliest Siri Remote has a touch surface and a Menu button instead. All have a TV button, and pressing it twice opens the app switcher. You move by swiping on the clickpad or touch surface (the clickpad also lets you press its edges), and click to select.

Swiping makes long lists fast to scroll, but it also makes it easy to overshoot. When you try a player, check that:

• the selected item is always clearly highlighted;
• you can move between categories and channels without overshooting;
• the programme guide can be moved through channels and time comfortably;
• Back (or Menu) steps out of playback and menus as you’d expect;
• search is easy to reach, and works with the iPhone keyboard.

Programme guide and channel navigation

Keep three things apart: the player, the channel data from your service, and the programme guide, which is listings information loaded separately. Pictures can play normally while the listings row stays blank. If that happens, allow time for the first download, look in the player’s settings for a guide-address field, and ask your provider whether listings are included.

Wi-Fi vs Ethernet on Apple TV

Not every Apple TV has an Ethernet port. The current Apple TV 4K comes in a Wi-Fi-only model and a Wi-Fi + Ethernet model, so check which you have before buying a cable. Where there is a socket and cabling is practical, plugging in takes the wireless link out of the equation. On Wi-Fi, the distance and walls between Apple TV and the router matter, as does other heavy use on your network; a mesh point near the TV can help. You can review the connection in the network section of Settings. Consistency counts for more than the top speed your broadband provider advertises; our broadband FAQ explains more.

Troubleshooting IPTV on Apple TV

Use the rows below to pick a first place to look (hardware, app, login, home network or provider) before trying anything drastic. They tell you where to start; they don’t diagnose.

If IPTV buffers on Apple TV

1. Switch to another channel.
2. Note whether the problem follows one channel, the whole IPTV app, or every video app on the box.
3. Check the Apple TV’s network connection in Settings.
4. Compare another device on the same network.
5. Force quit the player: press the TV button twice, highlight the player and swipe up, then reopen it.
6. Restart the Apple TV: Settings, System, Restart.
7. Plug in a network cable if your model has the socket.
8. Play the same service on a different compatible device.

If every video app stutters, look at the network or the Apple TV. If only the IPTV player does, the app or its settings are the likelier cause; if the provider’s streams stutter on every device, contact the provider. The installation centre also covers a frozen picture.

Player opens, but no channels appear

Re-enter the details before anything else: a wrong character, a server address or playlist link that’s been cut short, or the login option chosen for a playlist (or the reverse) are the usual culprits. Access that has expired, or a brief network drop, can look identical.

Force quit, restart, offload or delete

Apple TV doesn’t offer the “clear cache” and “clear data” controls you may have seen on Android TV. Instead, Apple’s own options, from lightest to heaviest, are:

1. Force quit: press the TV button twice, highlight the player and swipe up, then open it again from the Home Screen. Apple suggests this when an app isn’t working right.
2. Restart: Settings, System, Restart; or hold Back and TV together until the status light blinks rapidly; or unplug the Apple TV for five seconds.
3. Offload: on the Home Screen, press and hold the clickpad or touch surface on the player, choose Delete App, then Offload. The app is removed but its data is kept, so reinstalling should bring your settings back.
4. Delete: the same route, choosing Delete. This removes the app and its data, so you’ll need to enter your access details again after reinstalling from the App Store.

They can’t correct a mistyped login, a weak connection or a fault at the provider’s end, so check those before reaching for Delete.

If a player isn’t available on Apple TV

Not finding a player on Apple TV doesn’t mean your Apple TV is faulty or incompatible with your provider. Most often the developer simply hasn’t made an Apple TV version. The fix is a player that is listed in the App Store on the Apple TV and accepts the access format your service supplies. There’s no legitimate way to install an iPhone-only app on Apple TV, and nothing you need from outside the App Store.

Security and trusted sources

Install players only from the App Store on your Apple TV and check who publishes them. Ignore offers of app files or modified players from other websites, and be wary of devices or services sold as “fully loaded”. Your access details should be typed only into the player (or the iPhone keyboard prompt it triggers), never into a website, and never shared publicly.

Test your real set-up, then choose a plan

The result depends on your Apple TV, the tvOS player you chose, the remote you use, your home network and the IPTV service working together, so test that exact Apple TV IPTV set-up where and when you watch. Streamlixa emails your login as either Xtream Codes details or an M3U link to suit your app, so pick a tvOS player that accepts one of them. Our installation centre has an Apple TV section. To try everything on your own Apple TV first, request an IPTV trial; afterwards, the plans differ by the number of screens that can play simultaneously.