Getting started
Add what your TV service sent you, then tell Theia how many streams your plan allows.
What you need
One of these from your TV service:
- a playlist link (M3U)
- an Xtream Codes login: a server address, a username and a password
- a playlist file (
.m3uor.m3u8) saved on your PC
Or an HDHomeRun antenna tuner on your home network. See Antenna tuners.
Theia comes with no channels. To look around first, click Try the demo. It adds thirty made-up channels with a guide, and it doesn’t count toward the free version’s two TV services.
Installing on Windows
Theia isn’t code-signed yet, so your browser and Windows may warn you when you install it. That’s expected, not a sign anything is wrong. Click Keep in your browser (Edge sometimes asks Keep anyway too), then on the blue Windows screen, More info and Run anyway. The download page has each screen pictured, plus a checksum if you’d rather check the file first.
Or install from the Microsoft Store: no warnings, and it updates itself.
Installing on Fire TV or Google TV
The TV version is a beta. It installs with the free Downloader app, and the TV page has the full steps.
- Install Downloader from your TV’s app store, and let it install apps in your TV’s settings.
- Open Downloader and type the code from the TV page, or the link
theiaplayer.com/tv.apk, then choose Go.
- When the download finishes, choose Install, then Open.
First-run setup
Theia opens it by itself until you have a TV service. Every step can be skipped, and Run setup in Settings > Your TV services starts it again.
Account first, and optional. On Windows, Mac and Android TV, setup opens on Create an account or sign in. An account is free. If you’d rather not, choose Skip for now: Theia works the same without one, and you can make one later in Settings > Account and Premium. To make one, enter your email, then type the 6-digit code we email you (or tap the link in the email), and pick a sync password if you want one. Your Theia account has every step. If you already have an account with TV services saved on it, they come over first and you can skip the TV service step. iPhone and iPad have it from version 1.9.14. Google Play gets it with its next update.
- TV service. Paste the link or server address your TV service sent. Theia says what it found under the box. If it doesn’t recognize what you pasted, the account form opens and shows how the paste starts, so a stray label or extra text in front of a link is easy to spot. If you were given a server, username and password, click Enter server, user and password by hand. For a file on your PC, click Browse, and Theia checks it straight away. Otherwise click Check link (or Check account). Already have a backup? Restore from a backup takes you straight to Restore from a file in Settings > Advanced tools; this isn’t on a TV yet. On a TV, press OK on the box to type with the remote, or type with the Google TV or Fire TV app on your phone.
- Verify. Theia reads the playlist and shows what it found, or signs in and shows the account’s status. Nothing is saved yet. Name the TV service under Call it, pick a color and an icon, and click Add TV service. Each part then loads in turn, and Start watching appears once the channels are in. Set up the guide goes on to the next step.
- Guide. Your TV service’s guide is used if it has one. A separate guide link goes here, as in The guide below.
- What shows. Check the channel categories you want in lists and the guide. Every category starts checked except categories named for another country or language. Unchecked categories are hidden until you want them, though games on their channels still show in Sports. When your TV service has adult categories, an Adult content row sits at the top, with a switch for Live TV, Movies and Series. A new install starts with all three off. See Adult content. New on Windows, Mac and Android TV from theiaplayer.com, on the Microsoft Store, and on iPhone and iPad in App Store version 1.9.14. Google Play gets it with its next update.
- Privacy. Choose whether to send anonymous usage statistics, once a day with no ID, then click Continue. From 0.9.4 the switch starts on, unless you’re in the EU, EEA, Switzerland or the UK, where it starts off and nothing is sent until you turn it on. Turn it off here or any time in Settings > Connection and data.
- Watch. Click Start watching.
Under the box, Use my phone lets you type the link on your phone, and Sign in brings the TV services from your Theia account.
On a TV with no TV services yet, setup opens on two cards. Create an account or sign in shows a code to scan with your phone, so you never type your email with the remote. Skip for now lets you add your TV service with your phone or the remote, and make an account later in Settings. Under them are Add a TV service by remote, Try the demo and Add an antenna tuner.
A link with get.php or player_api.php and a username and password in it is read as an Xtream login, so the guide, movies and series come with it.
For a TV server you run at home, paste its M3U playlist link, and its guide link in the Guide step. A server address on its own opens the account form, which is for Xtream logins. A home server that works like an HDHomeRun can also be added with Add an antenna tuner.
If the check fails
Nothing is saved, and the card offers what to do next, such as Retry or Paste a different link.
| What you see | Try |
|---|---|
| Couldn’t connect, or No answer in time | Check the address and your internet. If both are fine, ask your TV service. |
| Sign-in refused | Check the username and password. |
| Account not active, or Subscription has ended | Only your TV service can fix this. |
| A web page came back, or Not a playlist | The address didn’t give a playlist. Check that you copied the whole link. |
| The server said no | Your TV service may block your network, or your internet provider may block the server. When it looks like your internet provider, the card offers Set up your VPN. |
Finding a setting
Help pages name settings the way Windows, Mac and Android TV show them. Settings there is split into pages: Your TV services, Channels and guide, Watching, Sports, Look and size, Account and Premium, Connection and data, Help and about and, once you turn on Show advanced settings, Advanced tools. Premium has its own page, opened from the plan card at the top of Account and Premium. Rows marked advanced, such as Buffer duration, only show once that switch is on, and Settings search finds them either way.
On iPhone and iPad, Settings is one list of pages with different names: Account and Sync at the top, then Playback (Watching on the other devices), Guide, Channels, Sports, Appearance, Home & startup, Network, Privacy, Watch history, Storage, Advanced, Keyboard & input, Help and About.
Adding another TV service
Click Add TV service in Settings > Your TV services. Before your first TV service, it also shows in the side menu: Add service on a PC, Add TV service on a TV. On a PC, it sits right under the main items, after Recordings and above Settings, under a thin line. On a TV, it sits at the foot of the menu. The menu has no Guide item: the guide is inside Live TV. It runs setup again from the TV service step. On a PC, opening a playlist file with Theia from File Explorer checks it straight away.
With a TV service already added, Cancel shows above the steps. Esc, or Back on a TV, does the same. Nothing typed or checked is kept.
Live TV and its guide open on your own TV service rather than the demo, and after that on whichever list you last picked.
The free version holds 2 TV services, and an antenna tuner counts as one. With Premium there’s no limit. See pricing.
Changing a TV service
Each TV service has a card in Settings > Your TV services:
- Name and color renames it and sets its color and icon. The color marks its channels and search results.
- Choose categories opens the What shows step again, to pick which of its categories show.
- Edit sign-in, on an Xtream login, changes the username and password. Check and save checks them before saving.
- TV service settings opens the rest, such as Refresh interval, Streams allowed and User agent.
- Refresh now fetches the TV service again straight away.
TV service settings also lists what you entered for that TV service under Sign-in details, such as its server, username and password, or its playlist and guide links, each hidden until you click Reveal. Copy puts one on the clipboard; on a TV, Show code shows it as a QR code to scan with your phone instead. These stay on this device, the same as your saved sign-ins (see Your data).
User agent is the name Theia sends with every request to that TV service. Leave it empty to use Default user agent in Settings > Advanced tools. Set one only if your TV service asks for it.
The guide (XMLTV)
Xtream logins bring their guide automatically, and so do playlists that name one. If your TV service gave you a separate guide link:
- In setup, choose Use a guide link in the Guide step. After setup, go to Settings > Your TV services and click Set up the guide on the TV service’s card.
- Paste the address. Plain and gzipped XMLTV both work.
- Click Load guide.
A guide link you add is used for the channels it covers, and the TV service’s guide fills in the rest. Guides refresh every 8 hours, and the TV service’s card lets you pick from 2 to 24 hours.
Once the guide loads, Theia matches it to your channels and shows how many found a match. Review matches lists every channel with the guide it was matched to. Pick one for a channel that has none, or fix a wrong one. A match you set or lock there is kept through every refresh.
If programs all start early or late, change the TV service’s Guide time offset. It’s in the Guide step and in Settings > Channels and guide. To move just one channel, use Guide time in a program’s details. On a TV in Full screen or Grid only, hold OK on a program and choose Guide time.
For an Xtream login, Theia also checks the guide against your TV service’s own listings. When it looks off, a line such as “Your guide looks 2 hours off.” shows with Fix it and Ignore: in the Guide step, under Guide time offset in Settings > Channels and guide, and in a program’s details. Fix it sets the offset for you. To undo it, set Guide time offset back where it was. If your TV service puts its guide right later, Theia offers to undo the fix the same way. Ignore leaves the guide as it is, and that fix isn’t offered again.
Streams allowed
Your plan lets you watch a set number of streams at once. Previews, multiview tiles and recordings all count, and Theia warns you before going past that number.
In Settings > Your TV services, click TV service settings on the TV service and set Streams allowed:
- Automatic uses the number the TV service reports. Xtream logins and antenna tuners report one.
- 1 to 10, or Unlimited, if you know your plan.
When the limit is unknown, Theia asks “How many streams can this TV service play at once?” the first time something would open a second stream. Choose Not sure and it warns you each time.
Signed in to a Theia account? Streams allowed, its warning and the live stream format reach your other devices with the TV service, once they run Theia 0.9.8 or newer.
What the first load does
After Add TV service, Theia shows each part as it loads, with a count or a progress bar:
- Channels (and Movies and Series for an Xtream login)
- Guide
- Matching to the guide
- Search
- Sports schedules, when the public schedule is on in Settings > Sports
A checkmark marks each part that’s done, and the one after is marked Next. A big list can take a few minutes.
If the TV service takes a while to answer Channels, it says Getting the channel list. Above it, Theia ticks off how long it has waited, such as Waiting for your TV service… 1:05. Once anything arrives, that line shows how much instead, such as 4.2 MB received. Past a minute with nothing back, it suggests trying a closer VPN server, if you use one. Cancel there removes the TV service you just added and takes you back to the TV service step.
Once the channels are in, Start watching appears. You can leave then. The rest keeps loading, and a chip in the title bar says how many things are still loading, such as 2 things loading. Select it to see the list. On a TV, a small pill shows instead, and What’s loading is in Options. If a part didn’t load, the note says so and offers Try again. The same list, and what each note means, is in What’s loading.
If a part doesn’t load, it says why, with Retry. Channels still work without the guide.
After that, the TV service is fetched again every 12 hours. Refresh interval on the TV service’s page changes it, from every 30 minutes to weekly, or Off. Open Sports, or pull down to refresh on iPhone, and Theia also brings playlists older than 30 minutes up to date in the background. A quiet Updating channels line shows at the bottom, and nothing waits on it. On the TV service’s page, Refresh fetches the whole TV service again, then its guides. Refresh guide only loads only the guides and matches them, which is lighter. While either runs, the page shows each step as it happens. If a TV service can’t update, its page says why.
Free and Premium
Watching, the guide, search and favorites are free, with up to 2 TV services and no ads. Premium adds multiview, your own channel order, categories and guide options, more themes and accent colors, unlimited TV services, sync across your devices and recording.
Premium is $1.99 a month, $19.99 a year or $34.99 once. See pricing. It turns on with the key we email you.
In the Microsoft Store version of Theia, you can also click Buy Premium in Settings > Premium. That purchase comes back by itself on a reinstall or on another PC with the same Microsoft account, and Restore purchase asks the Store again. It doesn’t carry over to a TV.
Paste your key in Settings > Premium and click Activate. On a TV, type it with the remote, or with the Google TV or Fire TV app on your phone. Plans, the free trial and canceling are in Premium, plans and the free trial.
Your TV service password is encrypted for your Windows account and stays on your PC. On a TV, it’s encrypted with the TV’s own key store and stays on the TV. More in Your data.