Your Theia account

What it does

• Your license comes to every device you sign in, straight away.
• Your sources (playlist links, Xtream logins and guide links) follow too, locked so only your devices can open them. We can’t read them.
• A sync password, if you set one, brings them to a new device even when your other devices are off.
• With Premium, favorites, watch history and settings match on every device, TVs included. See Syncing through your account.

A playlist file on a computer, and VPN or proxy sign-ins, stay on that device.

Theia works fully without an account. Nothing changes until you sign in.

Signing in

Signing in has no password. Your device shows a code, and you approve it with your email. The optional sync password is a separate thing, and it only brings your sources.

On a TV: choose Sign in in first-run setup or in Settings > Account. Scan the QR code with your phone, or on any browser go to theiaplayer.com/link and type the short code the TV shows. Sign in with your email if the page asks, check the name and place it shows, and tap Sign in this TV.

On a PC or Mac: open Settings > Account, choose Sign in, then Open in browser and approve it there. In first-run setup, Sign in to bring your providers is under the box where you paste a link.

Bring over my sources

Before the code, every device shows one switch: Bring over my sources. It starts on.

• On: your license comes over, and so do the sources saved on your account. They start loading the moment you’re in.
• Off: only your license comes over. Your sources stay on your account, and you can get them any time with Get your sources in Settings > Account.

It is a choice for this one sign-in. Nothing else changes either way, and you can sign in again whenever you like.

Right after you sign in

You see “You’re signed in” for a moment, then you land on Home. You don’t go through an Add a source page first.

With the switch on, a Setting up card sits over Home and shows how far along it is: Unlock your sources, Sources, Channels and Today’s guide. It closes by itself once your channels and today’s guide are in. Movies and series keep loading after that. Hide puts it away, and a line at the top of Home keeps saying how far along things are. Choose the line to bring the card back. If a source on your account was already on this device, the card says so and doesn’t add it twice.

With the switch off, Home says “You’re signed in” and offers Get your sources. If your account has no sources yet, Home says so and you can add one that follows your account.

Get your sources later

In Settings > Account, Get your sources shows how many sources are waiting on your account, such as “2 sources waiting”, or “None waiting”. Choose it and they come to this device.

Your sync password, on your phone

If your account has a sync password, the Unlock your sources step asks for it. On a PC or Mac you type it there. On a TV, the card says Finish on your phone: scan the code and type the sync password on your phone, so you don’t type it with the remote. The TV shows Waiting for your phone until you’re done.

From a computer that’s already signed in: on the computer, open Settings > Account > Add a device, type the code the TV shows, choose Look up, check the name and place, then choose Approve.

The sign-in email has a link and a 6-digit code. Open the link, or type the code on the page that asked for it. Both work once, for 15 minutes. When it’s to approve a device, the email says so without naming the device: “It’s to approve a device waiting to sign in. Once approved, your devices send it your sources.” The page you open after signing in shows the device’s name and place.

Only approve a device you can see. A device you approve gets your license and your sources.

A device with sources of its own asks first. The first time it signs in to your account, it asks “Add this TV’s sources to j•••@example.com?” with your address. Add puts them in your account for your other devices. Not now keeps them on that device only, and it stays signed in. You can add them later in Settings > Account.

Your license

Signed in, a device gets its license from your account, and Settings > Premium says Premium from your account. Paste a key on a signed-in device and Theia offers Add to your account, so the key follows you too. Your keys are also on your account page, ready to copy. If your account has a license that this device isn’t using, the account page says On your account, not on this PC (or Mac, iPhone or TV). It only says there’s no license on your account when the last check found none. A monthly or yearly plan’s key follows your account too: when the plan renews, a signed-in device on Theia 0.9.2 or later picks up the new key by itself. On an older version, paste the new key in Settings > Premium.

How your sources get to a new device

With a sync password, a new device asks for it once and your sources arrive in seconds, even with your other devices off.

If you signed in with Bring over my sources on, they arrive on their own while the Setting up card shows the progress. If you turned it off, choose Get your sources in Settings > Account when you want them. Either way there’s no typing.

A device that’s signed in and still waiting always shows what to do next:

• Type your sync password, if your account has one. On a TV it says Finish on my phone.
• Open Theia on one of your devices, if there’s no sync password. Your sources then arrive by themselves, and the device suggests setting a sync password so the next one doesn’t have to wait.
• Your account has no sources yet, if there’s nothing to wait for. Add a source adds one that follows your account.
• Add a source by hand instead is always there too.

Without a sync password, your devices send them to each other. After you approve a TV, the next time Theia is open on one of your other signed-in devices, it sends the TV your sources, locked so only that TV can open them. You don’t press anything, and that device tells you: “Sent your sources to Living room TV.”

Sources from your account that a device doesn’t have yet show up in Settings > Sync. It says “1 source to add” instead of “Up to date” and offers Add it (Add them for more) and Not on this PC (Not on this iPhone, Not on this TV). Add it shows how far it is, such as Setting up 1 of 2. If a source can’t be added, the row says why and offers Try again. Theia’s free sample doesn’t count as one of your sources. Until they arrive, the TV says “Your sources arrive when Theia is open on” and names the devices that can send them. Right after you sign in, Home and Favorites say Bringing your favorites over (or Bringing your sources over) until the first sync is done. Open Theia on one, or carry on with Type it here or Use my phone in the meantime. Approved with Add a device on a computer that has your key, the sources come with the approval.

Key codes

Compare the key code when a new device signs in. It’s how you know your sources went only to your device.

The new device shows “Key code 482 913. The device that sent your sources shows this code too. If it shows another code, or none, remove this device from your account.” The device that sent them shows the same code a moment later, in its notice or on the Add a device screen: “Sent your sources to Living room TV. Check that it shows key code 482 913.” Each device has its own code, so compare the two that were part of this sign-in, not any others.

Sync password

Optional. It brings your sources to a new device even when every other device of yours is off.

Set it. The first time a device has your sources and your account has no sync password, Theia offers three random words. Choose Use this, Choose my own or Not now. Save it in your password manager. Later, Settings > Account has a Sync password row to set or change it. Use at least 8 characters, and not your email address or a very common password.

Typing it. A password made of Theia’s three suggested words works with spaces, dashes or nothing between the words, in any capitals. You can also choose your own password instead of the suggested words (at least 8 characters, not your email address, not a very common password). A password you chose yourself is used exactly as you type it, and one you set before 0.8.2 still opens.

On a TV you never type a password with the remote. Set it from your phone.

Use it. A new PC, Mac or iPhone asks for it once. When another device of yours is open, nothing is asked: it sends your sources itself.

A TV. Sign in on your phone as before. The page has a Sync password box, and your phone fills it from your password manager. Leave it empty to approve the TV as before. A TV that’s signed in and waiting shows Needs your sync password and Type it on my phone.

Wrong password. Theia says how many tries are left. Tries are limited per device, and after 20 wrong tries in a day it locks for 24 hours and we email you.

Change or remove it. On any device that has your sources, in Settings > Account. You don’t need the old one. We email you when it’s set, changed or removed.

Forgot it? Open Theia on a device that has your sources and set a new one. No such device? Start fresh and add your sources again.

What we can see. We never receive your sync password. We store a copy of your key that only the password opens, and we can’t open it. A password anyone could guess is weak: that’s why Theia suggests three random words. Details are in the privacy policy.

Notices on your devices

• Sent your sources to Living room TV (near Denver, Colorado). Shown on the device that sent them, with the key code to check once the TV has them.
• Bedroom TV was added to your account near Denver, Colorado. Shown on your other signed-in devices.
• Living room TV’s key code didn’t check out, or hasn’t come through, or Living room TV has a new key. Something doesn’t add up, so if you don’t know that device, remove it. A device of yours that was reset gets a new key: remove it, then sign it in again.

Each has Remove it, for a device you don’t know, and OK. Several devices of one kind share a notice that counts them, with Review to see each one. Notices wait until nothing is playing.

If a device isn’t yours

Every new device sends you an email with its name, model and approximate place. If it wasn’t you, open the Wasn’t you? link in that email and choose This wasn’t me. It removes the device, signs out every browser and device on your account, and stops your devices sending your sources anywhere for 24 hours. Then:

1. Change your email password and turn on 2-step verification. Your email is the key to your account.
2. If the email says the device had already received your sources, sign one of your devices back in first. That changes your key, so the device you removed can’t read anything you add after it. Then change your passwords with those providers.
3. If you have a sync password and anyone else might know it, change it in Theia.
4. Sign your other devices back in.

Your devices

Settings > Account > Devices, or your account page, lists every signed-in device, up to 10. Remove signs a device out the next time it’s online. Check Also erase your providers and favorites from it to clear what came from your account too. If it had your key, your other devices change the key the next time Theia is open on one of them, so the removed device can’t read anything added after. A removed device can’t sign back in on its own: it needs your approval again, and then gets your key from one of your devices.

A PC or Mac shows up under its own name, such as “Sam’s MacBook Pro”, not its network name. Rename it in Settings > Account, and a TV on your account page. A name you chose is never changed. At 10 devices, signing in another asks you to remove one first.

If you lose your devices

Your locked sources and favorites open only with a key your devices hold. Without a sync password there’s no other copy, not even with us. If every device with the key is lost or reset, what’s locked is gone for good. Your license isn’t: sign in with your email and it comes back.

Two things prevent that. Set a sync password, or keep Theia signed in on two devices. When one device is the only one with the key, Settings > Account says so, and signing it out warns you first.

If it does happen and you set no sync password, the next device you sign in says none of your devices has your key and offers Start fresh. That erases the locked copy on our server and keeps your license. Then add your sources again with Use my phone or Type it here. Start fresh also removes the sync password.

Signing out

Sign out in Settings > Account takes your account’s license off that device. Signing out keeps your key on that device, so signing back in brings everything back. Check Also erase to remove that device’s key and the sources and favorites that came from your account too. Then what’s saved on your account can’t be opened from it again. A license key you pasted yourself stays.

Sign out everywhere, on your account page, signs out every browser and device at once. They keep their sources and favorites. Sign each one back in. For 30 days we keep a one-way code of each device, so one that kept its key can sign back in with it. A plain Sign out does the same. A device unused for 400 days is signed out the same way.

Deleting your account

In the app, choose Delete account in Settings > Account, then open the link we email you. On the web, use your account page or theiaplayer.com/account/delete.

It deletes everything tied to your email: your account, devices and locked data, plus any beta key request, the device names on your license activations, the reply address on problem reports and your waitlist entry. Your license keeps working on the devices that have it, and your sources and favorites stay on them. A monthly or yearly plan on the account won’t renew, and you won’t be charged again. The privacy policy has the details.