Skip to main content

Setup guide

How to Set Up IPTV on Apple TV

Using an App Store player on tvOS, what Apple allows, and the AirPlay alternative if you would rather not buy one.

Apple TV runs tvOS, and tvOS installs apps from the App Store only. There is no ordinary way to install software from elsewhere, and anything presented as a workaround involves developer tooling that is not appropriate for a normal household setup.

In practice this is less limiting than it sounds. The tvOS App Store carries IPTV players that accept both standard credential formats, and the Apple TV hardware is good at smooth playback. What you lose is choice; what you gain is a device that tends to work the same way next year as it does today.

Some tvOS players are a paid purchase

A one-off App Store payment to the app developer is separate from your FreeGoTV subscription. We do not receive any part of it and cannot refund it. Check the price in the App Store listing before you install.

Before you start

  • An Apple TV signed in to an Apple Account with the App Store available.
  • Your credentials from us.
  • Your iPhone or iPad nearby — iOS will offer to let you type into the Apple TV, which is far quicker than the remote.

Installing a player

  1. Open the App Store on the Apple TV and search for an IPTV player.
  2. Check the listing accepts either a server address with username and password, or a playlist link, then install it.
  3. Open the player and choose to add a playlist or a new user.
  4. Enter your details. When the on-screen keyboard appears, a notification on your iPhone or iPad lets you type on the phone instead.
  5. Add the programme guide address if the player has a field for it.
  6. Let everything load, then open a channel to confirm playback.

Watching from an iPhone or iPad instead

If you would rather not buy a tvOS player, a player on your iPhone or iPad can send video to the Apple TV over AirPlay. Quality then depends on your local network as well as your internet connection, and it uses the same connection from your plan as any other device.

Credentials

What we send you, and what each part is for

Login details for a player

Three separate fields: a server address, a username and a password. Most television players ask for these on their first screen. This is the format we send unless you ask otherwise.

Server: http://example-server:8080 — Username: your-username — Password: your-password

A single playlist link

One long web address ending in .m3u or containing get.php. Players that ask for a "playlist URL" or "M3U URL" want this. It carries your username and password inside it, so treat it like a password.

http://example-server:8080/get.php?username=…&password=…&type=m3u_plus

A programme guide link

A separate address, usually ending in .xml or .xml.gz, that fills in what is on now and next. Some players fetch it automatically; others have a field labelled EPG or XMLTV where you paste it.

http://example-server:8080/xmltv.php?username=…&password=…

Treat these like a password

A playlist link contains your username and password in plain text. Do not post it in a forum, a review, a public comment or a screenshot. If you need help, send it to us privately — and never send us a password for any other service.

Troubleshooting

If something is not right

I cannot find the player I use on my other devices

Not every player has a tvOS version, and the App Store will not show one that does not exist. Choose from what is listed, or use AirPlay from an iPhone or iPad.

The app rejects my server address

Check you included the full address including http:// and the port number after the colon. Autocorrect on the iOS keyboard also likes to capitalise the first letter — it should be lower case.

AirPlay keeps dropping

AirPlay is sensitive to Wi-Fi congestion. Putting the Apple TV on Ethernet usually fixes it, even though the phone stays wireless.

Still stuck? Tell us the device, the player you installed and what you see on screen. That is usually enough for us to answer in one reply.

Get setup help

Ready to explore FreeGoTV?

Browse the available subscription options, or contact our team for help choosing a plan and setting up your device.

Chat on WhatsApp (opens WhatsApp in a new tab)