User guide · Chapter 1 of 16

Getting started

TiviGlass keeps three things separate: your TiviGlass account (identity, plan and cloud features), your TV sources (the TV services, M3U playlists and addons…

TiviGlass keeps three things separate: your TiviGlass account (identity, plan and cloud features), your TV sources (the TV services, M3U playlists and addons you actually watch), and your profiles (the people in the house). You can use the app with just a TV source — the account is what carries your plan and syncs between TVs.

1

Choose how to sign in Free

Path: First launch → sign-in screen
How
  1. Choose Sign in, then Use phone — recommended. Scan the QR code or enter the short code and the TV connects itself.
  2. Choose Use remote only when you want to type your email and password on this TV.
  3. Create account opens the phone flow for a brand-new account.
  4. Continue as guest skips the account entirely.
Good to know
This is your TiviGlass account, not your IPTV provider login — that comes next. The phone route is far quicker than typing a password with a remote. If you started as a guest and sign in later, TiviGlass asks whether to keep the profiles you already made or start fresh.
2

Add your first TV source Free

Path: Settings → TV sources → Add TV source
How
  1. Choose — pick Type it on my phone instead, or the connection type your service supplied (see the table below).
  2. Enter — fill in only the required details. A friendly name, backup addresses, guide URL and unusual device headers are under Optional details. Anything missing or malformed is flagged under the box it belongs to, not in one message at the bottom.
  3. Test — select Run test. TiviGlass checks the details against your provider and tells you what it found. Nothing is saved at this point, so a wrong password or a mistyped address costs you a retype and nothing else.
  4. Review — check the summary. Your password and any debrid key are shown masked, never in full. Select Add and import to go ahead.
  5. Import — the stages are listed as they happen, with real counts. As soon as your channels are in, Start watching appears and the TV guide keeps loading behind you. You can also leave the screen entirely; the import carries on.
Good to know
Nothing is created until you confirm. Choosing a type, filling in the boxes and running the test all leave your TV exactly as it was, so you can back out at any point — and if you do, TiviGlass asks before clearing what you typed. Everything you have entered also survives a failed test or a failed import, so fixing one field never means retyping the other six.

A TV service is not your TiviGlass account. The account is your sign-in and your plan; a TV service is the provider whose channels you are adding. TiviGlass does not supply or sell channels.

If the test cannot get through, it says which part failed — the address was never reached, or it was reached and your login was refused — because those need different fixes. Where your provider only accepts a particular User-Agent, the test finds a working one and tells you it has set it for you; where you have entered backup addresses and the first one is down, it says which one answered.

You can add as many playlists as you like — multiple playlists are free. Each TV uses one current source at a time, and every TV chooses independently. To change which one you are watching, you do not need Settings: open the sidebar and press the TV service line in the panel header. It lists everything this profile can use, says whether each one is on your account or only on this device, and switching keeps you exactly where you were in the app. The line is only pressable when you have more than one service to choose between. Separate TVs can play at once as long as they are within your TiviGlass account’s device allowance and each provider allows the required connections. Your credentials are encrypted on the device, never stored in plain text.

On a new install TiviGlass then walks you through the last two steps by itself: loading your channels, and fetching the TV guide. Both start on their own — you only press anything if one doesn’t finish.

If the guide step won’t complete, choose Skip for now — start watching. Some providers offer no programme data at all, and others are simply busy when you first connect; neither stops your channels working. TiviGlass keeps trying quietly in the background, and you can fetch the guide any time from Settings → EPG.
Provider typeWhat you needNotes
Xtream CodesServer URL, username, passwordThe most common IPTV format. Brings Live TV, movies, shows, guide data and catch-up. Given more than one URL? See the note below.
M3U playlistA URL, a local .m3u/.m3u8 file, or pasted textOptional XMLTV guide URL. Plain, gzip-compressed and ZIP-wrapped playlist files are accepted, even when a provider omits the expected filename or compression header. Mixed lists are sorted automatically into Live, Movies and Shows. If the list supplies Catch Up rules, guide time shifts, relative stream/guide links or per-item User-Agent/Referer headers (including VLC, Kodi adaptive and #EXTHTTP forms), TiviGlass applies them automatically across Live, Movies and Shows. Kodi-style User-Agent/Referer options attached to the playlist URL itself are also understood. A link copied without http:// is accepted too. Channel groups come from the list’s own group-title or #EXTGRP tags — a list with neither simply shows everything under All channels, and you can build your own with Custom Groups. If what you point TiviGlass at is not a channel list at all — a saved web page, a provider error page, an XMLTV guide file or an .m3u8 stream link — it says so and stops, whether it came from a URL, a file or pasted text. Nothing is imported and an existing line-up is left exactly as it was. A file or pasted list has no address to re-check, so it stays on this TV and you update it by picking the file again under Edit — that keeps your favourites and history. Give it a URL instead and you can re-pull it any time with Update on the playlist’s row (how-to 2c).
Stalker / Ministra portalPortal URL and MAC addressDevice ID, serial number and set-top-box profile are optional — fill them in only if your portal is strict.
Stremio addons PremiumAddon URL(s), optional debrid API keyAggregated movie, show and compatible TV/channel catalogues. Set-up in full: how-to 27b–27d.
TV service blocking your connection? Open Optional details in the add or edit screen and use the User-Agent auto-detect option — TiviGlass tries a series of user agents and tells you which one works.
2a

Given several server URLs? Enter them all Free

Path: Settings → TV sources → Add TV source → Xtream Codes → Optional details
How
  1. Put the address you were given first in Server.
  2. Select Add backup URL and type the next address into the line that appears.
  3. Repeat for each spare address you were given — up to five. Use Remove to delete a line you no longer want.
  4. Fill in your username and password as normal and continue through Test and Review. If the address you typed first is down, the test uses a backup and tells you which one answered.
Good to know
Many providers issue two or more addresses for the same account. They are usually the same service reached by a different name — a spare in case the first address stops working, not a faster one to choose between. So there is nothing to test or compare: enter them all and let TiviGlass handle it.

You can also manage these from your account portal on a phone or computer, under the playlist's Backup server URLs, and they sync to every TV signed in to your account.

Once they are saved, TiviGlass tries each address in turn whenever the one in use stops working, and keeps the one that works as its first choice from then on. It does this when you load or refresh channels (it retries straight away and tells you), during overnight background updates (silently — look under Settings → Help & diagnostics → Recent activity if you want to see it), and while you are first adding the playlist, so an address that is already unreachable will not stop you getting set up.

One thing to expect: if the address dies while you are watching, that channel still stops and you will see the usual playback error — but the app has already moved to your backup behind the scenes, so simply picking the channel again, or any other channel, plays normally.

Your username and password stay the same either way. TiviGlass only switches when the address itself is the problem — a wrong password, an expired subscription, or "too many connections" all stay put, because a second address cannot fix any of those.

Add no backup lines at all if you were only given one address — nothing changes.
2b

Type it on your phone instead Free

Path: Settings → TV sources → Add TV source → Type it on my phone instead
How
  1. Select Type it on my phone instead, the first choice on the screen. It is also offered on the details screen itself, so you can switch to your phone after starting on the remote.
  2. Scan the QR code with your phone, or type the web address shown into your phone's browser.
  3. Choose your TV-source type on the phone, fill in the details and select Send to TV.
  4. The form on the TV fills itself in and stops there. Check it, then continue through Test and Review as usual.
Good to know
Your phone must be on the same Wi-Fi network as the TV — a guest network usually cannot reach it. Nothing is sent over the internet: the page is served by your TV itself. The page closes as soon as you send it, and always within 10 minutes. Sending only fills in the boxes — the phone cannot skip the test or the confirmation, so nothing is saved until you press Add and import on the TV. The review screen also says the values came from your phone, so you know to check them.
2c

Refresh one playlist Free

Path: Settings → TV sources → the source card → ManageUpdate now
How
  1. Open Playlists. The active provider is first and clearly marked; each card shows whether its connection is online and the subscription expiry date reported by that provider.
  2. Choose Manage on the provider you want, then Update now. TiviGlass re-pulls that provider’s channels, movies, shows and TV guide, telling you which stage it’s on.
  3. When it finishes you get a single message with the new channel count — or a plain-English reason if something didn’t come back.
Good to know
Xtream providers normally report a dated expiry or explicitly say that the line has no expiry. Other source types may show Expiry not provided because their protocol has no reliable expiry field; Expiry unavailable means TiviGlass could not read the Xtream account response. The app checks again after a manual update, so a renewal can appear without re-adding the playlist.

Use this when one provider has changed its line-up and you don’t want to wait for every other playlist to be re-checked too — a large provider can take several minutes on its own. Update all at the top of the page still does the lot.

Automatic playlist updates uses your chosen interval for the same data, but refreshes the time-sensitive TV guide first. The guide can update while you are watching; only the heavier channel, movie and show catalogue work waits for playback to finish or for more memory. If a provider cuts a guide download short, TiviGlass retries that guide separately without repeating the large catalogue update. Android schedules background work approximately, so the start time can be a little later than the selected interval. The timer also waits while the device is offline.

If a playlist’s channel and guide downloads both fail several times in a row — a provider that has gone dark, or a box that runs out of memory part-way through — TiviGlass pauses the automatic channel, movie and show update for that playlist only, and says so under Recent activity. It keeps updating that playlist’s TV guide throughout, leaves every other playlist alone, and tries the catalogue again by itself a few hours later. Nothing is deleted, and pressing Update on the playlist starts it again immediately.

Updating a playlist does not switch to it. Whatever you were watching keeps playing and your active playlist stays active, so you can refresh a spare line-up in the background.

Your own changes are kept: favourites, watch history, renamed channels, hidden channels, custom groups and your channel order all survive an update — it only replaces what the provider sends.

If you switch to or remove a playlist while an update is running, that update is cancelled first and any data it already saved is kept. Your selection then continues automatically.

One exception: an M3U list you imported from a file or pasted text has no address to re-check, so Update will say so and point you at Edit connection to pick the file again.
3

Set up the household Free

Path: Settings → Account & Premium → Switch profile
How
  1. Move right to Add profile.
  2. Give each viewer a name, avatar and colour, and mark children as Child profiles.
  3. Set a household PIN (4–8 digits) when prompted — it protects profile changes.
  4. Hold OK on a profile to edit it, set access rules or remove it.
Good to know
Up to 8 profiles per household. Each one keeps its own favourites, watch history, watchlist, reminders and personal display settings. A deleted profile stays recoverable for 30 days under Recently deleted.
4

Find your way around Free

Path: Press Left from any screen to open the sidebar
How
  1. The sidebar lists every section: Home, Search, Live TV, Sports Hub, Multi-view, Catch Up, Movies, Shows, Kids, Apps, Reminders, Recordings and Settings.
  2. Move up and down, press OK to open a section.
  3. Press Back at the top level to reopen the sidebar; press it twice quickly to leave the app.
Good to know
Sections you don’t have — or that a profile isn’t allowed to use — simply don’t appear. You can reorder, rename and hide sidebar entries later (see how-to 50). By default, opening Live TV, Movies or Shows slides this same panel horizontally to that section’s groups; the TiviGlass heading, account details, clock and divider stay fixed. Back returns it to the main menu, so no second sidebar is added.

Back always undoes exactly one step, in the order you took them: an open film or series page first, then the groups panel, then the sidebar itself. Closing the sidebar is treated as a cancel, so it never counts toward leaving the app — only Back from a section with nothing open does that, and it tells you (“Press Back again to exit”) before the second press. Remotes that repeat a held button, and some HDMI-CEC setups that send a burst of presses, cannot skip a step: presses that arrive within a fifth of a second of the last one are ignored, so one press means one step even on a remote that stutters.

When you open a film or series from Home, Search or the Sports Hub, Back returns you to that screen — with your search text and position intact — rather than dropping you into the Movies or Shows list. Jumping to the TV guide from a Search result works the same way: it is a visit, so one Back puts you back in your results rather than opening the sidebar. If a section disappears while you are using it (a profile change, a hidden section, or a plan change), TiviGlass moves you to the closest section still on your sidebar and says so, instead of silently jumping to the top. Switching TV service closes an open film or series page, because that item belongs to the service you switched away from; TiviGlass tells you that too.

Learn the remote

TiviGlass is built for a physical remote. This table is also available on the TV itself — open the player menu and choose Remote controls.

5

The buttons that matter Free

Path: While watching → Menu → Remote controls
How
  1. Press OK while watching to reveal the on-screen controls, and again to hide them.
  2. Hold OK on a channel, poster or tile for its action menu.
  3. Use Back to step out one layer at a time.
Good to know
Every one of these can be reassigned — see how-to 51. Number and colour keys are especially worth mapping if your remote has them.
ButtonWhat it does while watching
OKShow or hide the on-screen controls
Play / PausePause and resume
Channel + / −Next / previous channel (live TV)
Up / DownNext / previous channel (live TV)
Left / RightSkip back / forward 10 seconds (movies and shows)
0–9Type a channel number to jump straight to it
LJump back to the last channel you were on
Rewind / ForwardRewind and fast-forward; on live TV, rewind where catch-up is available
Previous / NextPrevious / next episode (shows)
MenuOpen More — audio, subtitles, quality, display and help
AChange the picture shape (aspect ratio)
QChoose video quality
SShow playback details — codec, frame rate, buffer
PSave a screenshot
Hold OK (guide or live video)Open programme actions, including saving a matching movie or show
BackHide the controls, then leave the player