Support

Help with the most common questions. If yours is not here, write to [email protected] and say which device and version you use.

New to IPTV?

Short articles in plain words explain what you need, what M3U, Xtream and HDHomeRun mean, and how catch-up works.

• IPTV explained

Something not working?

Tell us what happened with the Report a problem form. In the app, use Settings, Help & feedback, Report a problem, which can also send the app's log. You can still write to [email protected].

Join the community

Ask questions, share tips and be the first to hear about new versions on Theamo's Discord server. For a problem with the app, Report a problem is still the quickest way: it sends us everything we need.

Adding a source

1. Open Settings, then Channels & sources, then Add a source.
2. Choose the type: Xtream for a provider login, Playlist for an M3U address, or HDHomeRun for an antenna tuner.
3. Fill in the details and tap Test connection. The app tells you how many channels it found.
4. Tap Save. Channels and the guide load in the background.

Catch-up is not showing

• Catch-up needs no setup. Theamo reads it from your playlist or provider. Open the channel's program list once so the app can check the server.
• Only past programs within your provider's archive window have a rewind button.
• If the guide times look wrong, change Settings, Guide, Shift the times, then reload.
• If a channel still will not play, edit the source and set Catch-up to Xtream timeshift or Flussonic archive. As a last resort, paste a link pattern in Settings, Advanced.
• Choose the HLS (m3u8) catch-up format unless your provider only offers MPEG-TS.

Finding the channel you watched last

The channel you played most recently, live or from catch-up, is marked LAST WATCHED in the Guide and in Live. Those lists open on it, and jump back to it after you close the player. On Apple TV, press down from the top menu and focus lands on it (in the Guide, on the program that is on now); when you come back from the player, focus returns there too. It is saved on your device.

Using the channel drawer

• Swipe in from the left edge while you watch (on Apple TV press the Menu button or swipe left) to open the drawer.
• It opens on the channel you are watching, marked WATCHING. Choose a channel to see its programs, catch-up and reminders.
• Go back (the arrow on iPhone, the Menu button on Apple TV) and the list is still on that channel. Move up or down from there. Press Menu once more on Apple TV, or swipe it away on iPhone, to close the drawer.

Changing the language

Theamo is available in English and Polish. Open Settings, Language & accessibility, Language and choose English, Polski, or Same as device, which follows your iPhone or Apple TV. The change applies at once. The website has the same two languages: use the EN / PL switch at the top.

Guides, refresh and icons

• A playlist can name its own guide. To use a different one, edit the source and fill in its guide address. To use one guide for everything, set an extra guide in Settings, Guide and choose how it is used: together with each source's guide, only for sources without one, or instead of them.
• Channels are matched to the guide by their id first, then by name. A channel with no match shows no programs; a guide with more channels than you use is fine.
• Settings, Channels & sources sets how often playlists refresh and Settings, Guide how often the guide does, or only when you ask. "Reload channels and guide now" always downloads everything.
• Channel icons can come from the playlist, from the guide, or whichever has one. The change shows straight away.

Theamo Pro and subscriptions

• Buy or compare plans: Settings, Theamo Pro, Upgrade to Pro. Individual and Family are subscriptions; Lifetime and Family Lifetime are single purchases.
• Restore on a new device: Settings, Theamo Pro, Restore purchases, signed in with the Apple ID you bought with.
• Cancel or change plan: on iPhone, Settings, your name, Subscriptions. On Apple TV, Settings, Users and Accounts, your account, Subscriptions. Pro stays until the end of the period you paid for.
• Family plan: subscribe to Family, then make sure Family Sharing is set up and purchase sharing is on for your Apple Family. Relatives then get Pro on their own Apple IDs.
• Refunds: Apple handles them at reportaproblem.apple.com.

Plex

• Link Plex in Settings, Channels & sources, Plex. You get a code to enter at plex.tv/link.
• Pick a profile once. Theamo remembers it. Change it in the same place, and turn on "Ask who's watching at launch" if you prefer to choose each time.
• Watched marks, resume points and the watchlist sync with Plex. You can switch syncing off in the same screen.

Reminders

• On iPhone, allow notifications when asked. If you declined, turn them on in the iPhone's Settings app.
• Apple TV cannot show notifications while the app is closed, so reminders there work only while Theamo is open.

Sending a log

If something does not work and the tips above do not help, a log shows what happened. It is off until you turn it on, and it stays on your device until you choose to share it.

1. Open Settings, Advanced, Troubleshooting and turn on Capture debug log.
2. Repeat the problem (play the channel, refresh the guide, and so on).
3. iPhone: tap Share log and send the file by email or message to [email protected]. Apple TV: tap Send log over Wi-Fi, open the address shown on a phone or computer on the same Wi-Fi, and send the file you download.
4. Turn the log off again when you are done. Clear log deletes it.

Passwords, tokens and account names in links are removed before anything is saved, and by default server addresses are replaced with "server-1", "server-2". You can read the log with View log before you send it.

Streams that will not play

Some providers and HDHomeRun tuners send raw MPEG-TS streams, or use audio Apple's player cannot play. Theamo switches to its own Aether player for those on its own. With Pro you can also choose the player in Settings, Advanced, or from the player's menu while watching, which is worth trying if a channel has picture but no sound. The player's Info button shows what is playing and which player is doing it.