User guide

Getting started

Set up TiviGlass: sign in, add your first TV service with an Xtream login, Stalker portal or M3U playlist, set up the household and learn the remote.

  • Chapter 1 of 16
  • 12 how-tos

One account, two interfaces

TiviGlass uses the original left sidebar. TiviGlass² uses the redesigned top navigation on TV. Both use the same account, plan rules and features. Choosing the other interface has no additional charge. Layouts differ, so the top-bar, connected-panel and Quick settings instructions below describe TiviGlass²; in TiviGlass, use the sidebar and Settings for the corresponding feature. Phone and tablet layouts adapt to the screen.

iPhone and iPad: on an iPhone held upright, the menu button at the top left of each screen opens every destination, your profiles, TV services and Settings (or swipe in from the left edge); the Search button sits at the top right. Landscape phones and wider iPad windows show a strip of destinations down the left edge of the screen, with Menu at the top and Settings at the end of its list, and the menu opens over it from the same edge. On an iPhone with a notch or Dynamic Island, the screen uses its full width when held sideways, right to both edges. Your full customised menu and Groups remain available. Guide previews sit above the portrait channel list at the size chosen in Guide preview size. On iPhone the preview can collapse to give the schedule more space; an iPad and a Mac have room for it, so it always stays. Sheets, forms and confirmation messages adapt to the current window and text size. Opening video keeps your current orientation; turn the device or use the player’s Picture size controls to rotate. Closing video keeps the orientation you are using.

Install TiviGlass² (TG2): open Downloader on your TV and enter 3817356, or use https://tiviglass.com/tg2/apk. For the original TiviGlass (TG1), use https://tiviglass.com/apk. Android asks you to approve the installation. When updating, choose the same app and install over it without uninstalling or clearing app data.

TiviGlass² redesigned interface

The TV bar is Home, TV, Shows, Movies, Catch up, Recordings, Multiview, Hubs and More. Hubs opens Sports and Kids. Visibility and access still follow your profile and plan. Search, Groups and Quick settings sit beside the destinations. Your existing TiviGlass account works here.

Select TV, Movies, Shows or Catch up to open its connected Groups browser. Short OK opens a group; hold OK for 550 ms for its supported actions. Back closes the attached actions and restores the same group and scroll position. Real provider and custom group names are retained.

When changing archive days, focus stays on the selected date while its listings load. Only that day’s loaded programmes can be opened.

If reloading the same archive day fails, its previously loaded programmes stay available with a Retry action. Changing channel or day clears the old listings. Days follow your local calendar, including clock changes. Watch and Record are unavailable before a programme starts or after your TV service’s archive window expires; a provider may still refuse an otherwise eligible replay.

The TV guide uses lightly translucent resting cells over your theme and a faint background watermark. Programme information has no solid card backing, and the larger mini player keeps its selected size with tighter spacing above and below. On TV, Catch up uses the selected top tab as its page heading; the small label below names the current archive group. Open its Groups menu for filters and Order groups.

In the TV guide, hold OK on a channel for its fixed panel on the right. Up and Down browse channels after returning Left to the guide while the connecting outline follows the selected row. The guide keeps its normal scale and focus lands in the panel on opening; Right re-enters its actions. Left returns to the guide, and Back closes the panel. Watch live, programme actions and channel tools use your existing provider capabilities and permissions.

Search shows horizontal rows of Channels, Programmes, Movies and Shows with details for the highlighted result on the right. Select a kind or See all to narrow the results. Left and Right browse a row; Right from its last card enters the actions. Left or Back from the actions returns to the same card. Short OK opens the result, and held OK opens its existing options. Back from the results closes Search and returns to the screen it was opened from. The service filter and microphone still search through the existing search engine. Missing artwork or guide information is left out rather than invented.

The gear opens Quick settings. Search and Quick settings share a continuous outline that curves around their circular header icon and into the panel. Choose a section to extend the same panel to the left, then choose a setting to open its choices. OK or Left on a Quick settings section enters its column; Back or Right collapses one level and returns focus to the original row after the column closes. Choice lists open on the current value; themes with the same name remain separate choices. All settings opens the complete settings directory, including search and advanced tools. Simple On/Off switches change with one OK press. Other choices open beside the setting when there is enough room; on smaller screens they temporarily replace the options area. Left or Back closes the choices and returns to the same row. Search lists all matching settings, including their page and section, and keeps your query and result position when you return. The overview also returns to the shortcut you opened, at the same scroll position. PIN and plan restrictions still apply. On TV, a movie’s details keep the main playback action visible beside More actions. Open it for the existing favourites, watchlist and other controls; Back collapses the strip and returns focus to More actions. On a show’s page in TiviGlass², the actions sit in the column on the left instead of a band across the page: the play button (Continue, Next or Play) at the top, then the seasons, More like this and Cast, then Trailer, favourites, watchlist, Random episode and the full story. The episode list keeps the space the band used. Landscape artwork may sit behind the details; portrait covers stay as posters.

The live player’s Recently watched row uses the current programme’s guide image first. If none is supplied, it can use matching artwork from that programme’s TV service Movies or Shows catalogue, like the guide preview. A missing match keeps the channel fallback; switching channels does not wait for an artwork search.

Guide-view visibility choices stay saved when restarting the app or changing TV service or profile.

In TV guide settings, Show All channels and Show All channels from all services control whether those entries appear in Groups and the optional horizontal group row. Off keeps them hidden even if that view is currently open or loading. Search and configured shortcuts can still open their channel lists; turning off the entry never removes channels.

With the TV top navigation, Back closes an open panel or detail page first, then returns from a temporary section visit. Once you are at the main screen with nothing left to close, Back returns to the top menu without an exit message. From that menu, press Back deliberately and then again within three seconds to exit. Moving around cancels the exit request. A child profile returns to profile selection instead. The bottom key hint names the next action.

Group cards are compact and show cached channel, movie or show counts instead of repeating the service name. Views stay above the groups. Choose Grid or List to change the layout. TiviGlass² remembers your choice separately for TV, Movies, Shows and Catch up on this TV, so each opens the way you left it; Reset settings to defaults puts them all back on Grid. Search and Actions stay visible while you browse; from a tile at the left edge, press Left to reach Search, then Right for Actions. Down from Search or Actions enters the views above the groups; Down again returns to the last browsed group, or the first result after a search removes it. Up from the views returns to Search. Actions contains the library’s existing filters, Surprise me and editing or guide tools where available. The service remains visible in category options. Counts describe cached membership before optional display filters. Hold OK for options; Left or Back closes the attached panel and restores the original tile and scroll position. The origin keeps a quiet marker while the active option has the stronger highlight.

Web pages close when you change account or viewer. Website sign-ins and site storage are cleared at that boundary; bookmarks and history continue to follow their existing profile rules. The first visit after this update also clears old website sessions whose owner cannot be established. You may need to sign in to those sites again.

In Cast matches, a failed page request keeps the last loaded results visible with Retry. Changing profile, service or access permissions clears those retained results.

The Kids channel picker respects the profile’s allowed groups and excludes protected channels. If those checks cannot be read, it offers Retry before showing choices.

Catch up keeps archived channels on the left and programmes for your chosen day beside them. Channel logos and archive indicators show the real available depth; the horizontal date strip labels each provider-reported archive day. Compact programme rows show thumbnails when supplied, with a text-only fallback, times and duration. The connected preview shows available artwork and description beside the existing Watch catch-up and Record actions. Select Catch up in the top bar for its connected archive-group dropdown. Short OK plays an airing. Hold OK or press Right for its attached Watch, Record and Details actions; Left or Back returns to the same programme. Entering the wide preview directly from the date strip also gives its actions a return path to the programme, or the selected date if that row is unavailable. On a narrower layout the actions use the programme area until you close them. The date strip and group browser retain their browsing position when closing programme options. Choosing a different archive group or changing the channel search starts the channel list at its first result; ordinary guide refreshes keep your position. Spoiler-free sport hides score-bearing titles, descriptions and programme images together.

Recordings has shortcuts to the populated Recording now, Scheduled, Series Link and Library sections. Each shortcut jumps within your existing list. OK plays a playable recording; Right or held OK opens attached details and actions in the same frame. The selected row stays marked. Left or Back closes the actions and restores the row; on a smaller layout or with larger text, the actions temporarily use the full workspace. Status labels wrap when needed. Stop, Delete, Cancel and Remove keep their existing confirmations. Menus opened above Recordings or Catch up handle Back before the workspace beneath them.

Apps keeps Pinned, Recent, Your apps, Web shortcuts and Get more apps in labelled sections of one TV grid. Hold OK for attached app options; Left or Back returns to the same occurrence and scroll position, even if the app also appears in another section. Pinning, hiding, editing, Android app settings, uninstall support and PIN restrictions retain their existing rules. Reminders uses the same connected list-and-actions layout: OK opens the guide for an upcoming reminder or plays its channel once started; hold OK or press Right for device placement and Remove. Remove still asks for confirmation. An empty list returns focus to New reminder.

In TV services, each service has one compact row with its current status. Select it for attached management actions: use the service, browse its channels and groups, update it, edit its login or choose what it downloads. Browsing or opening management does not change the active service; choose Use this service to switch. Back returns to the originating row. The active-service settings and advanced controls remain available below.

Scheduled recordings in both TV apps keep the configured end padding even if the timer starts a few seconds late. A delayed start or resumed recording still stops at the planned end time, rather than extending into the next programme.

Edit timer is available for scheduled recordings in both TV apps: open the programme’s guide actions or choose its timer under Recordings › Scheduled. Change the date, start, end or repeat days, then choose Save changes. The channel stays the same. Clashes are checked again. Once the recording is starting (including start padding), its timer can no longer be edited. A changed window keeps the original programme’s recording badge but no longer follows automatic guide time changes. If another profile shares the timer, their schedule stays unchanged. Timers on the same channel with exactly the same start share a capture: to give yours a different end, choose a different start too. The editor explains this before saving.

After scheduling from the TV guide, remote focus returns to the selected channel or programme. In TiviGlass², with Loop lists round enabled, Left from the first top tab reaches Quick settings and Right returns to the first tab; the Settings directory loops in both directions on a fresh press. In the guide-source form, Down from the address reaches Add source (or Save changes), even before an address has been entered; an unavailable action explains what is needed.

New timer searches up to 60 available channels at a time. Type more of the name to narrow the results. A failed search offers Retry. If your service or profile changes while choosing, open the timer again and choose a current channel.

New reminder and New timer share attached channel, date and time pickers. Search narrows the channel list to at most 60 matches. Choose an hour, then any minute on the 24-hour clock; Back steps out of the picker and restores its field. On a narrow layout the picker uses the form area until it closes. Check the summary before saving.

File backups lists each saved copy by date, filename and size. Select one for attached Restore this backup and Delete file actions. Restoring needs its original passphrase; deleting still asks for confirmation. Back returns to the same file, or a nearby file if it was removed. Self diagnostics shows three clear stages: choose checks, checking your setup, and results with next steps. Back retains the existing keep-running or cancel choice during a run.

Full Settings shares one frame between its directory and the page beside it. The highlighted directory row uses the same accent treatment as navigation. Utility pages use compact headings; account sign-in, profile selection, terms, service setup and shared dialogs use the same dark surfaces and rounded outlines. Large text or constrained widths move header actions below the title instead of squeezing them. These presentation changes retain the existing account, PIN, subscription, settings and recovery paths.

Sports and Kids use compact spotlights with clear artwork beside their actions. Related picks adapt to the available space and text size; the full programme rows remain below. Multiview keeps its channel pictures and setup controls inside one frame. Layout, channel selection, presets, connection guidance and full-screen viewing remain available.

Groups on TiviGlass² TV. Select Live TV, Movies or Shows in the top bar to open that library and its searchable Groups grid together. The grid is joined directly to the selected navigation tab. Selecting the current library tab opens its groups again. Your custom folders keep their names and sit under Your groups; provider categories stay under their TV service. Select a service heading to expand its listed groups. Search groups filters the groups currently available in this panel; expand another service to browse its groups. The cards use actual group names and available descriptions, without inventing genres or channel counts. Use the arrows to move and tap OK to choose. Hold OK for just over half a second (550 ms) to open a category’s options in an attached section on the right. The originating card keeps a quiet marker; Up/Down selects an action and OK runs it. Back closes the options and returns to the same card and scroll position. A hold never also opens the category. Rename, smart rename, restore original name, move, PIN lock, hide and reset use the existing category controls and confirmations; custom folders offer the actions supported by that folder. Service headings retain their service options. Views stay above the scrolling groups. Search, Grid/List and Actions stay reachable while searching, including when no groups match. Actions opens an attached column containing the existing library commands. On a group tile, Menu still opens its category options; from the fixed controls, Menu opens Actions. The layout uses consistent plain tiles across TV, Movies and Shows: no images or genre icons are guessed from group names. Counts describe the cached membership before optional content filters; a missing count is not invented. Press Back again to close Groups.

TiviGlass keeps three things separate: your TiviGlass account (identity, plan and cloud features), your TV services (the IPTV 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 service — 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. The sign-in screen opens with a QR code ready to scan. Sign in on the page that opens, then return to the TV; it connects automatically. On a phone or tablet the same card offers Open the sign-in page on this device, so you sign in right there and the app connects on its own when you come back.
  2. Choose Use the remote instead to type your email and password on this TV. Back returns to the phone route without clearing what you typed.
  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 page works with both TiviGlass apps. If your code expires, select Try again on the TV and scan or enter the replacement code. Use a different TV code changes which TV you are connecting. Email-code sign-in also offers Use password instead, keeping your email and selected TV. Once approved, the page waits for the TV to collect the sign-in before saying TV linked. If you started as a guest and sign in later, TiviGlass asks whether to keep the profiles you already made or start fresh.
Try the demonstration catalogue. For reviews and screenshots, add https://tiviglass.com/demo/playlist.m3u as an M3U address. It includes 30 demonstration channels, 24 openly licensed short films and science documentaries, and ten two-season anthologies, with automatic guide discovery and three days of demo catch-up. For richer film and season details, choose Xtream Codes with server https://tiviglass.com/demo, username demo and password demo. These public demo details are separate from your TiviGlass account. The anthologies are curated collections of complete films. Favourites, watch progress and recordings are created as you use the app. See the demo source page for film attribution and screenshot credits.
2

Add your first TV service Free

Path: Settings › TV services › Add a TV service
How
  1. Choose — pick the connection type your service supplied (see the table below) to enter it on this device. For help typing on a TV, choose Type it on my phone instead; on a phone or tablet, the same option is called Use another device and opens a one-time setup page on another device on your network.
  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. Content — choose which of your provider’s groups to bring in. Everything is on to begin with, and providers often offer hundreds of groups, so the step is built for picking a few out of a lot: there is a search box, a row of section chips (UK, US, Sports and so on, taken from your own provider’s group names, each showing how many groups it covers), and bulk buttons that act on what is on screen. The quick way is: press a section chip, then Only these — that keeps the ones you are looking at and drops the rest in one press. Use the strip at the top to move between Live TV groups, Movie groups and Show groups. Anything you leave out is never downloaded at all, which makes both this import and every later update quicker. A playlist file or a pasted list has no groups until it has been downloaded, and add-on catalogues come from each add-on as you browse — for those two the step says so and you choose afterwards instead.
  5. Review — check the summary. If you left the friendly name blank, TiviGlass fills one in for you here: what the source calls itself where it says so, and otherwise its address, so two services never arrive with the same name. It is only a suggestion, so step back to Enter and type over it whenever you prefer your own. Your password and any debrid key are shown masked, never in full. Select Add and import to go ahead.
  6. 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. A new service becomes the one this TV shows while its channels come in; your other services stay saved, and Use this service on any of them switches back. You can also leave the screen entirely; the import carries on. A very large service can take longer than this screen waits, and when that happens it says so and offers Leave it running — closing the screen does not stop the import, and nothing you have added is lost.
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 More › You and your TV and choose the TV service line. 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, your channels and TV guide start loading automatically. Once your channels are ready, choose Start watching, even if the guide is still updating. Any guide update already running continues in the background. If the guide has not finished, you can retry it from setup or manage it later under Settings › TV guide › Guide listings.
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. A group named Movies or Films can still contain live channels; its name alone does not move them into Movies. Refresh an existing playlist to apply corrected classification. 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. Before you confirm a new M3U service, TiviGlass reads the playlist and shows its groups in Content. Choose which groups to bring in; the confirmed import uses that same playlist and applies your choices before adding channels, movies or shows. Changing the address, file or pasted text reads the groups again. If reading fails, choose Retry or go back to correct the source. A URL remains an M3U source throughout this journey; use Xtream login separately if your provider does not allow playlist exports.

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. Send device IDs is on by default. Turn it off in the TV’s optional connection details only if your provider requires login without a device ID or serial number. Your typed values are kept for when you turn it on again; this does not change your provider’s device or connection limits. The account portal keeps the same three under Portal handshake. A TV keeps the ones it is using: syncing with your account changes them only when somebody changed them more recently, on the website or on another TV, and clearing a box on the TV and saving clears it on your account too. Updating TiviGlass, or moving between the beta and stable versions, no longer puts back a Device ID you removed.
Add-ons PremiumAdd-on URL(s), optional debrid API keyMovie, show and compatible TV/channel catalogues from add-ons that work with Stremio. You don’t need the Stremio app or a Stremio account. Dedicated Add-ons section and set-up: how-to 27a–27d.
Stalker portals on iPhone, iPad and Mac: Send device IDs is in Add a TV service › Stalker portal › Device details and in the service’s Edit login & address, and is on by default. Turn it off only if your provider says its portal uses the MAC address alone: the portal is then shown the MAC only, and the Device ID and serial number you typed are kept, not sent, for when you turn it back on. It does not change your provider’s device or connection limits, and TiviGlass never switches it by itself. On a service from your account, the change goes to your account like the other device details. Catch-up on a Stalker portal asks the portal’s own archive for the programme you picked, as a MAG box does, when the programme came from the portal’s TV guide and you start it from its beginning; otherwise, or if the portal has no archive service, it asks the way it always has, and if the portal’s archive link turns out not to work TiviGlass asks the other way once. A very large film and show library that the first import (or an Update) could only partly fetch carries on by itself a few minutes later, each pass starting where the last one stopped, while Update automatically is on and the app is open; it waits while something plays or records, and stops after twelve passes or three failed ones.
Keeping services safe on iPhone, iPad and Mac: an update never replaces what you already have with an empty or much shorter list. If an Xtream Codes service answers with no channels, films or shows, or with a tiny fraction of them, or an M3U playlist link downloads cut off part-way, everything already on the device is kept and the service says so; a real change (a provider dropping some channels) still comes through, and so do groups you chose to leave out under What this service downloads. A file or pasted playlist is your own copy and is taken as it is. A Refused badge has a line under it saying what it means: HTTP 403 is your provider turning this device’s connection away (often a line that has expired, been disabled or reached its device limit, or a block on your internet connection) and HTTP 429 is your provider limiting how often this device asks, so wait a few minutes; neither is a wrong password. When an Xtream Codes provider answers its account check with a web page instead of your account details, TiviGlass says so in Test connection, when adding the service, on an update that failed and under Provider reachable in Find and fix a problem, and quotes what the page says (The page says: “…”) with your username, password, addresses and tokens taken out of the quote. A page that came from a different site than the address you entered (a Wi-Fi sign-in screen, or an address that has moved) is never described as your provider’s. After several failed requests in a row to one provider, the app holds off from it for a minute or so (Retrying soon on the badge) instead of asking again and again. Update now, Update all TV services, Test connection and Find and fix a problem still ask your provider once each time you press them, and carry on only if it answers; automatic updates wait until the pause is over. Starting a channel, film or episode from an Xtream Codes, M3U or Stalker service is never held back; an add-on or debrid service can be. An automatic update also waits until TiviGlass has been open for about 45 seconds and for half a minute after you start a channel, film or episode, at most two and a half minutes, so opening the app and starting to watch stay smooth. For Xtream Codes catch-up, when a provider’s advertised time zone disagrees with its own clock, the clock wins, so catch-up starts at the programme you picked; that is checked again at every update, and when you play catch-up (in the background, at most every 12 hours) so a change to or from summer time is picked up even with automatic updates off. An add-on source’s add-ons are asked with the User-Agent and Referer set on that service.
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. It checks up to three channels spread across the service rather than just the first one, because a service that passes your streams on from more than one source can accept a user agent on one channel and refuse it on the next.

This is also worth trying when one saved service keeps saying your provider refused the connection, or shows a Refused badge on its row, while your other services are fine. That message usually means too many players are on your account at once, so close the others first; but some providers accept one particular user agent only, and refuse everything else in exactly the same way. Auto-detect is what tells the two apart, and it is added on the service that is failing rather than in Settings.

A live channel refused with HTTP 403 or 458? When nobody has set a User-Agent for it, the Playback failed card in the full-screen player can also offer Try player User-Agent. It waits a moment for your provider to free the previous connection, then tries that one channel again, once, with a media player’s User-Agent. If the channel then plays, TiviGlass asks whether to keep it. Save for all services stores it as User-Agent for all services (Settings › TV services › Advanced), which every TV service on this TV then uses; if cloud sync is on, it applies to every device on your account. Not now keeps it for that channel only, until you leave it. The button is not shown when you or your service chose a User-Agent, and the guide preview never shows it.

When you save a User-Agent for all services, characters that cannot be sent in a web request, such as curly quotes, accented letters or emoji, are removed, and a non-breaking space becomes an ordinary space. What Settings shows afterwards is exactly what is sent.
Live output format: For Xtream services, Auto prefers MPEG-TS and uses HLS when MPEG-TS is unavailable. This applies to new services and existing services left on Auto. You can still select HLS explicitly in the service’s optional details; a supported explicit choice is kept.
2a

Given several server URLs? Enter them all

Path: Settings › TV services › Add a TV service → 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 & about › 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. That includes an address that has been blocked but still accepts your login while refusing to send channel lists: TiviGlass moves to your backup then too.

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

Fusion: one channel, every copy you own Premium

Path: While watching, press Menu → Switch source  ·  Settings › Playback › When a channel fails · Fusion › Fusion overview · Switch service when a channel fails (previously Switch to another playlist if playback fails) · Choose copies by
How
  1. Add two or more TV services that carry some of the same channels. Fusion starts matching a new service’s channels within seconds of it being added, and Switch source can already find copies on it before that match has finished.
  2. Watch anything. Press Menu and choose Switch source. The top line says what is playing now (service and quality), and the list includes matching copies from your other services, not just the copies on the one you are browsing.
  3. Pick one. The picture changes source; the channel, the TV guide, your favourites and the service you are browsing all stay exactly where they were.
  4. Choose Suggest alternatives for a brief notice when another copy may help, or Automatic to let Fusion switch to a verified copy by itself when a channel fails.
  5. Open Fusion overview to see how your services match up and what Fusion has done on this TV.
Good to know
The Switch source list sorts copies by how sure Fusion is. Verified copies are the ones Automatic may switch to. Same channel, not verified yet copies play when you pick them, but Fusion will not switch to one by itself. May show something different holds PPV, one-off event and 24/7 loop copies: they are listed so you can choose, but two feeds labelled “PPV 1” are very often two different events, and a loop channel is at a different point in its loop. Possible matches are copies Fusion is unsure about: select one to confirm it is the same channel (it does not play it). Each copy says which service it is on, its picture quality, whether it is on a separate provider account, the same account, or an account not confirmed, and how it has played on this TV, for example Played 4 of 5 recent starts, Not tried on this TV yet or Resting after a failure.

The heading on the Switch source list tells you what you actually have. “3 sources” means three copies. “Protected by 1 independent backup” means something stronger: at least one of those copies comes from a genuinely different provider account, so it is still there when the first one is not. Two services that turn out to be the same subscription under two addresses, or two resellers passing on one supplier, count as one. TiviGlass will not tell you that you are covered when you are not.

Hold Select on a copy (press and hold on a touch screen) for its options. Prefer this copy makes Fusion try it first when this channel fails (verified copies only), and Stop preferring this copy undoes it; you can also clear it under This channel at the bottom of the list. Keep separate stops Fusion treating a copy as this channel, after asking you first. Either way the decision sticks, on this TV, for this profile. You can also turn automatic switching off for one channel without changing the setting for everything else.

Suggest alternatives is the starting setting (previously called Ask before switching). When a channel stops, Fusion shows at most one brief notice per channel tune, naming what it found, for example Fusion found HD on Provider B · More › Switch source. It never opens a dialog or takes focus, and normal retries continue. Open Menu / More → Switch source when you want to choose a copy. If the channel gives up and the Playback failed card appears, it has a Switch source button too whenever another copy exists. While a channel plays, a quiet line at the top of the player controls says what Fusion has for it, for example Fusion · Protected by 1 independent backup; it is not there when Fusion has nothing to offer. Automatic switches to a verified copy without asking, and once the picture is back a short message says which service it switched to, for example Fusion restored playback using Provider B. When a verified copy on a separate provider account is ready, Automatic also gives up on a dead stream sooner (after three failed connection attempts instead of six), so the switch happens in seconds. A name and quality label alone are never enough for that: the two copies must also agree on the guide (the same guide channel or the same schedule) or on the country they are labelled with, or you must have confirmed the match. A matching logo or language helps Fusion group copies, but on its own it never makes one switch automatically, because the UK and US versions of a channel often share both. This is a metadata check, not a live audio/video comparison. It only opens the chosen copy, so recovery still depends on how quickly that provider responds and the picture buffers.

Choose copies by decides which verified copy is tried first. Balanced (the starting setting) puts a copy on a separate provider account first, then the copy that has played best on this TV, then picture quality. Best picture tries the best picture first, and Most reliable the copy that has played best here. A copy, or a service, you chose to prefer comes before all of these, with one exception: when your provider refused the channel or has run out of connections, a copy on a separate provider account goes first, because another copy on the account that just refused is the one most likely to be refused too.

Fusion overview (also on Settings › TV guide › Fill gaps · Fusion) shows each of your services with how far Fusion has got checking its channels, for example Checking · 12,400 of 52,000 channels; how many of the channels on the service you are using are also on your other services, and how many of those are on a separate provider account; and what Fusion has done on this TV, such as Restored playback 12 times · 3 in the last 7 days. Numbers it cannot work out yet are left out and it says why, rather than showing a 0. Select a service under Prefer copies from to have Fusion try copies on that service first (with the same exception for a refused channel), or No preference. Every Fusion switch is there as well. With a remote, the overview opens on its summary at the top: press Down to reach the services and switches, and Up to come back to the summary; a summary longer than the panel scrolls with Up and Down first.

A +1 feed is never treated as the same channel as the live one, and neither are two versions of a channel from different countries.

Nothing is uploaded and nothing is shared. Fusion only ever plays services you have already added, using your own logins, and it works with no internet connection to us at all. Turn the whole thing off with Switch service when a channel fails → Off, or hide other services’ copies from the list with Show copies from other services. Both are on Settings › Playback › When a channel fails · Fusion.

When you finish adding a TV service and now have two or more, the last setup screen says in one line that Fusion is matching it, or, without Premium, what Fusion would do. On a very large service the full match carries on in the background, when the box is not busy, and Fusion overview shows how far it has got.
Fusion on iPhone, iPad and Mac: copies are matched by the same rules as on the TV. A wrapped country label such as |UK| or [DE] no longer keeps a copy apart, US and USA (or GB and UK) count as one country, and a country the name does not give is read from the channel’s group or guide channel; two copies that disagree only there are listed under Possible matches rather than hidden. Copies with different names but the same guide channel are offered there too. A shared language or logo never makes a copy switch automatically. An M3U link of an Xtream login (the get.php address with your username and password) is the same subscription as that login, so the list says same account and never counts it as an independent backup. A TV service you have just added is searched as soon as you open Switch source; the full match runs in the background once the app has been open for a few seconds, and it pauses while a screen is still loading. Switch source on iPhone, iPad and Mac (More › Switch source, or Command–Shift–S on a Mac or an iPad with a keyboard) names the copy that is playing, then lists the others under Verified, Same channel, not verified yet, May show something different and Possible matches, each with its service, its account (Separate provider account, Same account or Account not confirmed) and how it has played on this device, such as Played 4 of 5 recent starts. Touch and hold a copy (Control-click on a Mac) to Prefer this copy or Keep separate; Stop preferring is under This channel. Choose copies by (Balanced, Best picture or Most reliable) is in Settings › Playback › When a channel fails · Fusion while switching is on, and Fusion overview is there and in a TV service’s Guide sources under Fill gaps · Fusion: it shows how far matching has got on each service, how many channels are also on your other services, what Fusion has done on this device, and lets you choose a service to prefer. The live controls show a quiet Fusion · Protected by 1 independent backup line once a channel is playing and has another copy. An automatic switch that brings the picture back says Fusion restored playback using the service it moved to; Suggest alternatives says Fusion found and names the copy. A live channel’s Playback failed card offers Switch source when another copy exists. While the device is offline, a dropped connection or a stall never moves you to another service. Adding a second TV service ends with one line saying Fusion is matching its channels.
2a3

Fill in a channel that shows “No programme information” Premium

Path: Settings › TV guide › Fill gaps · Fusion › Fill gaps from other services  ·  Fusion: also use near matches  ·  Fusion overview
How
  1. Leave Fill gaps from other services on. When a channel has no listing of its own, TiviGlass shows the schedule from a matching channel on one of your other playlists.
  2. Fusion: also use near matches covers the rest. Some channels have no guide because their name matched two entries in your EPG equally well, or matched none of them closely enough for TiviGlass to be sure — so it matched neither and left the row blank. This setting shows the closest entry it found anyway.
  3. Choose how close the name has to be. Likely matches (70%) is the default, and 70% means the same thing here as it does in Match listings. Drop it towards Fill as much as possible (50%) to fill more channels, or raise it to Only near-certain (90%) to fill fewer and be surer of them.
  4. This setting saves nothing, and it is not the same control as Match listings. It borrows a listing only while a channel has none, and the borrowed rows disappear the moment that channel’s real guide arrives. To make a match stick, use Match listings (how-to 14b), which saves your choice and keeps it. The two have their own percentages and changing one never moves the other.
Good to know
A channel’s own guide always wins. Filling only ever happens where a row is blank, and a borrowed listing says underneath where it came from — another playlist by name, or the EPG source it was read from. Nothing is written to your channel: turn the setting off and the row goes straight back to how it was, and a real guide arriving replaces the borrowed one on its own.

Lower settings fill more and get more of them wrong. That is the trade, and it is why the wording says likely and loose rather than just a number. If one channel matters to you, Match listings from its hold-OK menu is still the exact answer: a match you pick yourself is never overridden by any of this, and No listings for this channel keeps a row blank that you want blank.

Live events and 24/7 channels are deliberately never filled from a name match. “Sky Sports Box Office” and the event it happens to be showing tonight look identical to a name, and a wrong schedule there is worse than none.

The matches are worked out when your guide updates, so a channel that is still blank right after you add an EPG source will fill in after the next update of that playlist.

Borrowing from a channel on another TV service uses the same channel matching as Fusion’s Switch source, which starts within seconds of a service being added. Fusion overview, at the bottom of this section, shows how far matching has got on each service; it is the same overview as on Settings › Playback.
2b

Type it on your phone instead Free

Path: Settings › TV services › Add a TV service → Type it on my phone instead
How
  1. Select Type it on my phone instead, the first choice on a TV. On a phone or tablet, select Use another device to type on another device on the same network. This option is also offered on the details screen itself, so you can switch after starting to type.
  2. Scan the QR code with your phone, or type the web address shown into your phone's browser.
  3. Choose the kind of details your provider sent you, then select Continue. Enter the details and select Send details to TV. Change login type takes you back without clearing what you typed. The service name is optional.
  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 local network as the TV — a guest network usually cannot reach it. The TV and the phone do not have to use the same kind of connection: a TV on Ethernet and a phone on the house Wi-Fi are fine. If your phone is on a VPN, allow it local-network access or turn it off for a moment. 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. If the phone page stops responding before you send it, the TV says the connection ended — select Try again on the TV for a fresh QR code, or Back to TV setup to enter the details with your remote. 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 services › This service › Update now  ·  for another service, Manage under its card → Update now

Channels & groups is one full screen, opened from Settings, beside a named TV service, from Movies and Shows, or from Edit in Channels & groups at the top of a group’s options in the guide, which opens straight onto that group. Every group is listed on the left: Favourites, then Your groups and New group, then the TV service’s own groups under All channels. The channels of whichever group you stop on are listed on the right, each with its number, logo and whole name. Right goes into them and Left comes back. The line along the bottom always says what each key does where you are.

Four tabs down the left edge say what OK does, so it never surprises you. Press Left from any group to reach them, however far down the list you are: Up and Down choose one, and Right or OK takes you back to the group you were on. On a touch screen, tap a tab. In Show & hide OK switches a group or channel in or out of your guide; hidden ones stay listed, dimmed, so another OK brings them back. A group one of your name rules keeps out names that rule (for example Hidden by your name rule “Sports”), and OK there offers Turn off its name rule, after saying that the rule stops acting on every group, not only that one; it is turned off, not deleted, and you can turn it back on where you made it. The group’s menu still offers Hide, if you want it kept out even once the rule is off. In Movies and Shows, a group with nothing in it says No movies in this group (or No shows in this group): those sections leave an empty group out whatever its switch says, and it comes back by itself once your TV service puts titles in it. A group whose titles could not be loaded at the last update says Couldn’t load this category instead, as Movies and Shows do, and a group left out for a moment while the lists catch up says Not in Movies at the moment (or Shows, or your guide). In Arrange OK picks a group or channel up: Up and Down move it, Left sends a group to the top and Right to the bottom, OK puts it down, and Back puts it back where it was. The order is saved for this TV service and this profile, and it is what the guide shows. While groups are sorted A to Z there is no order to arrange, and OK offers to switch to your own. In Rename OK offers a tidied name and the provider’s own name first, so you rarely need to type; Or type a name is under them. Tidy up (Live TV only) holds the duplicate, HEVC, regional and name tidy-ups and the ways to bring hidden groups, hidden channels and the provider’s names back. Its Merge duplicates card, next to Duplicate copies, shows the SD, HD and backup copies of a channel as one row, and OK turns it on or off. It is the same switch as Merge duplicate channels in Settings and Merge duplicates in the guide’s Customise menu, and it applies on every TV service; nothing is hidden, and the player’s Switch source chooses between the copies. A merged row offers catch-up whenever any of its copies on that TV service has it, and plays past programmes from that copy. A merged row plays the best-quality copy unless you choose another: hold OK on the channel in the TV guide and choose Choose main copy (each copy says whether it has catch-up), or, while it plays, choose Make … the main copy in Switch source. The guide and Channel up/Channel down then play that copy; Best quality automatically goes back. The other cards cover the group you are on, one of your groups, or the whole line-up when you are on Favourites or All channels, and shows how many channels it will touch when it can count them. Nothing is ever deleted. Its New groups card decides what happens when your TV service adds a group: set it to Hidden and new groups arrive switched off for your profile, so a provider adding forty countries overnight does not undo a tidy guide. Groups already there are not touched, a group you have switched on or off yourself keeps your choice, and the card is free on every plan. The choice is kept with your profile for that TV service on this TV, and in its backups; the groups it switches off are switched off wherever your profile syncs, and a choice you make about a group on any TV always wins. A provider that renumbers every group at once is treated as a fresh line-up, so nothing is hidden then.

Merged channels on iPhone, iPad and Mac: with Merge duplicate channels on, a merged channel shows catch-up when any of its copies on that TV service has it: its replay mark, Watch from the start and recording from catch-up use that copy, while watching live plays the copy shown. To choose which copy plays, touch and hold the channel (Control-click on a Mac) and choose Choose main copy; each copy says whether it has catch-up, and Best quality automatically goes back. While it plays, More › Switch source offers Make … the main copy or Go back to best quality. The choice is kept for that TV service on this device, Channel up and down follow it, and a favourite on two TV services shows the copy on the service you are using.

Menu, or holding OK, opens everything else for that group or channel: Lock with a PIN, Add all its channels to one of your groups, Select several, Undo my changes to this group, Show every group or Hide every group, Sort groups A to Z and Change TV service. The rest of the channel settings, such as Merge duplicate channels, Channel order, Favourites from every TV service and Hide groups & channels by name, are in Settings › Channels & library, which is also where you opened this screen from, so Back takes you straight there. Find a group or channel narrows the groups on the left and lists matching channels from every group on the right, saying how many hidden channels also match. A protected group shows no logos until you unlock it with your PIN: press Right on it, or choose Unlock on its card. Protected channels in Favourites and your own groups are listed with a padlock instead of a logo. Movies and Shows work the same way, with titles in place of logos and no Tidy up tab; a title can’t be hidden on its own, so OK ticks it for one of your groups.

How
  1. Open TV services. The service in use has its own This service section; every other service has a card with its latest source check and the subscription expiry date reported by that provider. The service in use is marked separately from the check result.
  2. For the service in use, choose Update now under This service. For another, choose Manage under its card, 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. Stalker portals also show an expiry date when their account or device profile supplies one. Expiry not provided means the provider supplied no readable date; Expiry unavailable means TiviGlass could not obtain the Xtream or Stalker account details. A missing date does not mean the subscription has ended. Check unavailable describes a failed source check, not a playback failure: channels and playlist updates may still work. Refused means your provider turned this TV’s sign-in away, and the line under it says how: HTTP 403 is the provider refusing this connection (often a line that has expired, been disabled or reached its device limit, or a block on your internet connection, which you can rule out by trying another network such as a phone hotspot), and HTTP 429 means this TV asked too often, so wait a few minutes. Neither is a wrong password. The source screen refreshes these checks while open and when reopened, and checks again after a manual update. Network results are cached for up to 15 minutes to avoid repeatedly contacting the provider; 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 TV services, under Keeping up to date, still does the lot.

Update automatically uses the interval you set in Update every for the same data, for every TV service set up on this TV for its household, with or without a TiviGlass account (every profile’s, not only the one in use), but refreshes the time-sensitive TV guide first. When one automatic run cannot get through every service, the service that has waited longest goes first next time, so none is left behind. 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. A Stalker portal that combines movies and shows is read once per pass and split into the two libraries. If its first import saves only part of the library, TiviGlass schedules a continuation. A very large movie and show library is fetched in several shorter passes a few minutes apart, each carrying on where the last one stopped, so no single background run has to hold your provider connection for long and nothing already fetched is downloaded twice. If any of your services is an add-on source, Add-ons in TV services has an Add-ons & debrid row that opens its add-on list directly. Keeping up to date also says when each TV service last updated, and whether its automatic updates have been failing. A source that has failed several times in a row says so, with the reason; one that has been paused says when it will try again and reminds you that Update works straight away regardless. 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 Android stops an automatic update before it finishes, for example because the connection dropped, the next attempt still refreshes any TV guide that was not finished. A background retry that keeps being stopped gives up after a few attempts and leaves the work to the next scheduled update, and Recent activity says when that happens.

If a playlist’s channel and guide downloads both fail several times in a row — a provider that has gone dark, a box that runs out of memory part-way through, or an update Android keeps stopping before it can finish — 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.

An update you start yourself (Update now or Update all TV services) carries on in the background when you leave Settings, so you can go straight back to watching. If you switch to another TV service while it runs, including by opening a section that uses a different service, it pauses while the switch happens and then carries on by itself; opening a section that uses the service already in use does not interrupt it at all. Press the same button again to cancel it. If the TV service changes several times while it runs it stops and says so, and anything it already loaded is kept. Removing a TV service stops that service’s update, and so does switching to a profile that can’t use it. Removing a TV service carries on in the background in the same way: once you confirm Remove this service, it leaves the list straight away and the removal finishes even if you leave Settings or leave TiviGlass with Back or Exit, so it does not come back when you return. If the TV is switched off, or Android closes TiviGlass, part-way through a removal, the removal finishes the next time you open TiviGlass and choose a profile, as long as you are still signed in to the same account and have not signed out in between. If you sign out before a removal finishes, the service can come back when you sign in again; remove it again then. If the TV briefly can't read your sign-in, Remove says so and removes nothing, so try again in a moment. Remove several and they are removed one after another. Pressing Sync TV services from my account straight after a removal waits for it to finish first, so the sync carries it to your account; if the removal is still running after two minutes, the sync says so and does nothing, so sync again a little later.

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 login & address to pick the file again.
2d

Bring in less, so updates finish sooner Free

Path: Settings › TV services › This service › What this service downloads  ·  for another service, select its row under Your TV services → What this service downloads  ·  when adding one, the Content step

This chooses what is downloaded to this TV. To look at another service’s channels, open Live TV and choose TV services in the groups panel instead (how-to 8b).

How
  1. Download movies & shows — turn this off to use a source for live TV only. It is usually the biggest saving there is: a film and show catalogue is often larger than the whole channel list.
  2. Live TV groups, Movie groups and Show groups — pick the kind from the strip, then untick any group you do not want. Each row shows how many items you currently hold in that group.
  3. Finding a group in a long list — type into Search groups, or press one of the section chips above it. The chips are built from your own provider’s naming, so a provider that calls its groups UK | Sports gives you a UK chip covering all of them. Search ignores punctuation, so uk sports finds UK | SPORTS HD.
  4. Changing a lot at once — the buttons act on whatever the search or chip has left on screen, never on the whole list. Only these keeps what you can see and drops everything else; Bring in shown, Leave out shown and Invert shown do what they say. Showing switches between all groups, just the ones you are bringing in and just the ones you are leaving out, and Sort can put the biggest groups first.
  5. Select Save, then Update now on that service to apply it.
Good to know
This is not the same as hiding a group. Hiding takes a group out of your lists and keeps everything downloaded; unticking it here means it is never downloaded at all, so it is the one that shortens the wait, uses less storage and puts less load on a slow box.

What you already have stays. Turning something off stops future downloads; it does not delete anything. Use Clear downloaded movies & shows when you want the space back. Your favourites, watchlist and viewing history are kept either way and reattach if you download it again.

Anything left out is not searchable, because it is not on the TV to search. Turn a group back on and update if you want it back.

Groups your provider adds later are brought in unless you untick them, so a new sports section does not silently go missing.

You can keep at least one group per kind. To bring in none at all, use the Download movies & shows switch instead — that is the control that says what it means.
2e

Change a service’s address or login Free

Path: Settings › TV services › This service › Edit login & address  ·  for another service, select its row under Your TV services → Edit login & address
How
  1. Change what your provider gave you: the server or portal address, the username and password, the backup addresses, or just the name.
  2. Select Save changes. For the service you are watching, TiviGlass first checks the new details with your provider, and saves them only once they connect. A service you are not using is saved as typed and checked the next time you use it.
  3. Select Done, or press Back, to return to TV services. If you changed something and have not saved it, TiviGlass asks Save your changes? first: Save (already highlighted) saves and closes, Don’t save leaves the service as it was, and Keep editing takes you back to the form. With nothing changed, Done simply closes. Pressing Done while a save is still being checked never throws it away: the form closes as soon as it has saved. While it saves, Save changes reads Saving…; press Done and it changes to Close now, which closes the form straight away if you press it again, while the save still finishes and tells you how it went.
Good to know
If the new details do not connect, nothing is saved. TiviGlass says what your provider answered and offers Go back, which is highlighted and returns you to the form with everything you typed, or Save anyway. Save anyway keeps the new details even though they did not connect, so what you are watching may stop until they work. Use it only when you are sure, for example when your provider has told you the new address goes live later.

An M3U playlist checks a new address by loading it. If it does not load, the playlist keeps its old address and channels; Save anyway keeps the new address and brings its channels in on the next update that can reach it.

After a change of address or login, the connection badge on the service (Online, Refused, Login rejected and so on) is checked again against the new details, rather than showing the old answer for up to 15 minutes.

On a service saved to your TiviGlass account, the new address reaches your other TVs, keeping each TV’s favourites, renamed and hidden channels and locks for that service. TVs on this version or later do not bring the old address back as a second copy. A TV still on an older version may show a second copy at the old address until it is updated; nothing on any TV is removed because the address changed.

A change to a service saved to your TiviGlass account, its name included, goes to your account straight away, and only what you changed is sent, so a rename here never undoes a change made on another TV or the website. If your account cannot be reached at that moment, this TV keeps the change and tries again at each sync for up to three days, and nothing from your account puts the old name or details back in the meantime, unless this TV is signed out of your TiviGlass account before the change gets through. If your account turns the change down for good, for example because the service was removed on the website, this TV goes back to your account’s copy.
3

Set up the household Free

Path: Settings › Parental controls › Switch profile
How
  1. Choose Add profile from Who’s watching, or open Quick settings › Switch profile › Profiles & accounts.
  2. Choose A profile on this account to share TV services with separate favourites and history, or A separate TiviGlass account to use another person’s own sign-in, plan and services.
  3. For a profile, enter a name and choose Adult or Kids. Change look is optional. Confirm the household PIN if asked; when creating a new PIN for Kids, enter it twice.
  4. For a separate account, enter a name for it on this TV and continue to phone or remote sign-in.
  5. Manage profiles shows each person beside their controls: Name & appearance, What they can watch and Remove profile. The main profile cannot be removed.
Good to know
Up to 8 profiles per household. Each one keeps its own favourites, watch history, watchlist, reminders and personal display settings. Opening management leaves the current viewer selected. Startup choices and Recently deleted are inside management; deleted profiles remain recoverable for 30 days. The Accounts tab switches saved accounts or removes their sign-in from this TV without deleting the cloud account.
4

Find your way around Free

Path: TiviGlass sidebar or TiviGlass² top navigation
How
  1. In TiviGlass, open the left sidebar to choose Home, Live TV, Movies, Shows or another section. In TiviGlass², use the top bar and its Search and Settings controls.
  2. In TiviGlass², Hubs opens Sports and Kids, and More holds additional destinations. TiviGlass lists its destinations in the sidebar. Hidden or unavailable sections follow your profile settings.
  3. Use You and your TV in the sidebar, or the profile and service controls in TiviGlass² Quick settings, to switch. Protected profiles still ask for their PIN.
  4. Groups opens filters and browsing tools for the current library. Select a group to return to the content; Back closes the panel.
  5. Back closes the current detail or panel first. On the TiviGlass² main screen, it returns focus to the top bar; press Back there to request exit, then again within three seconds to leave. Moving around cancels the request. Follow the bottom key hint in either interface.
Good to know
TiviGlass keeps its original sidebar; TiviGlass² uses the top bar on TV. In TiviGlass², More does not repeat its destinations and Groups contains no second navigation rail. Your saved order and section names are retained within the top bar and More. Use More → Customise navigation to change them. Touch devices retain their adaptive navigation.

Get TiviGlass on a Mac: download it from tiviglass.com/download, for macOS 15 Sequoia or later on Apple silicon or Intel. Open the file and drag TiviGlass onto Applications. It looks for a new version once a day and asks before installing it; to look straight away, choose TiviGlass › Check for Updates. Like the TV app it’s a player only. Sign in with the same TiviGlass account you use on your TV and your plan comes with you, along with the TV services saved on your account. To buy Premium on a Mac, choose Get Premium on tiviglass.com (in Settings › Account, on Home, or on a locked feature): it opens your account on the TiviGlass website, where you sign in and pay. When you come back to TiviGlass, it picks up the new plan.

iPhone and iPad shortcuts: touch and hold the TiviGlass icon on the Home Screen for Watch Last Channel, Live TV, Search and Recordings. The same four are App Shortcuts, so you can ask Siri (“Watch my last channel in TiviGlass”), find them in Spotlight or add them in the Shortcuts app, on a Mac too. Watch Last Channel plays the channel you watched last on the TV service in use, asking for a PIN or your age first where the channel needs it; it opens nothing in Kids Mode or on a profile without Live TV, and says so. On an iPhone held upright (or an iPad in a narrow window), swipe in from the left edge of a screen to open the menu, as well as tapping the menu button at the top; on a page you opened inside a screen the swipe goes back, as usual. With a keyboard on an iPad, Esc closes the sheet or panel in front (Settings, a pop-up at the right edge, a PIN prompt) and Return presses its main button, such as Save; the number keys, Delete and Return type and confirm a PIN. The menu bar has a Playback menu while the player is open, with the Mac’s keys: Command–Right and Left Arrow skip, Command–Up and Down Arrow change channel, Command–Shift–R records, Option–Command–Down Arrow mutes and Command–W closes the player. Hold Command to see them, with the player’s own keys (Space, the arrows, Return, Esc and the number keys). A channel’s schedule moves with the arrow keys, Page Up and Page Down too, and Space opens the highlighted programme. At the largest text sizes, touch and hold a player button or a PIN key to see it enlarged.

The Mac window: as on the TV, a strip of icons runs down the left of the window, with the menu you chose on the TV, in its order, and your profile picture at the top. Click an icon to open it (hover over it to read its name), or press Command–1 to Command–9 in the menu’s order. To see the names, click the menu button at the top of the strip, the sidebar button in the toolbar, or choose View › Show Sidebar (Control–Command–S): the full menu opens beside the screen, and closes back to the strip as soon as you choose something, as the TV’s menu does. In the full menu an entry your plan doesn’t include shows the plan it comes with (Essentials or Premium) beside its name; at a large text size, where that label would cut the name short, a padlock in the plan’s colour takes its place (hover over it to read the plan). On the strip a locked entry is dimmed with a small padlock. After a click the strip or menu takes the keyboard: Up and Down Arrow move along it, typing a name’s first letters jumps to it, Return opens it and Right Arrow goes back to the screen. Drag the full menu’s edge to make it wider or narrower. Your profile and TV service sit at the top: click them to change who’s watching or the service. Settings is at the foot. Choosing Live TV, Movies, Shows or Catch Up shows its groups in a column beside the strip; choosing a group closes the groups and the menu, leaving just the strip so you can see what it shows, as on the TV, and choosing the section again brings the groups back. Drag the column’s edge to make it wider or narrower. Escape or Go › Back (Command–[) steps out one layer at a time: the full menu first, then a film, show or channel page you opened from the section (its groups stay beside it), then the groups. When the window has no room for the groups beside the full menu, opening the menu puts them away until it closes. View › Hide Groups (Option–Command–S) and View › Hide Icon Strip give the screen more room, and TiviGlass remembers both on this Mac; the window always opens with the menu closed. In a narrow window the groups open over the screen instead. To leave a film, show or channel page, choose Go › Back (Command–[), press Escape or use your mouse’s back button; a trackpad set to swipe between pages with three fingers can swipe too. Escape first closes the full menu if it is open, then whatever is open on the screen, such as the guide’s highlight or programme details. The Window menu names the screen you’re on, or what’s playing. The window’s close, minimise and zoom buttons and the sidebar button sit in a plain band across the top of the window, with the strip, the groups and the screen below it; double-click the band to zoom the window, or to do whatever you chose in System Settings › Desktop & Dock › Double-click a window’s title bar to, and drag it to move the window. The same goes for the top of the Settings window, which you can also resize and minimise, and of the player’s own window, where a double-click at the top zooms the window rather than going full screen. In full screen the band hides with the menu bar, so the screen uses the whole display; move the pointer to the top of the screen and the menu bar and the sidebar button slide back over it.

Mac player menus: the Playback menu shows the skip length used by the current player. Command–Right Arrow skips forward; Command–Left Arrow skips back. While watching live TV, Playback › Record… (Command–Shift–R) opens the recording and reminder options available to your profile. It says Recording… while that profile is recording the channel. Playback › Playback Options… (Command–Shift–O) opens More over the picture, the TV remote’s Menu button; while a Fusion found another copy notice is showing it opens straight on Switch source. Playback › Switch Source… (Command–Shift–S) is listed on live TV when the channel has another copy. An iPad with a keyboard has the same two shortcuts. Playback › Sound lists the audio tracks; a track you pick there is remembered as in More → Sound, and Use automatic choice appears below the tracks while a pick is remembered. These player shortcuts apply while the player is in front (in the main window or its own); close an open sheet first. Command–W closes the player, then the window. The keyboard’s Previous and Next media keys change channel on live TV and go to the previous or next episode in a series.

Mac windows and menus: TiviGlass › Settings (Command–comma) opens Settings in a window of its own, with the pages listed down its side and a search field at the top of the list, so you can keep it beside the guide or the player; close it with its red button or Command–W. Choosing Settings again brings it to the front. Option panels open at the right edge of the window, beside the page you are on: click beside one or press Escape to close it. Short lists open on their own button instead: in Movies and Shows, Sort and Layout are menus with a tick by the choice in force (About This Order… at the foot of Sort has the order’s description and Share viewing counts), Filters and Live TV’s … open a small panel under the button, and Search’s In is a menu of TV services. A yes/no question is a standard Mac alert; Return and Escape both give the safe answer, so Return never removes or stops anything. In Add a TV service, Return presses the step’s main button (Continue, Test connection, Add and import, Start watching), Return in a field moves to the next one and then runs the test, and Back (Command–[) goes back a step; Escape cancels an import that is running. File › Open Playlist File… (Command–O) adds a playlist file the same way as opening it from Finder, and Back Up to a File… and Restore from a File… open Settings › Sync & backup (signed in, on a plan with backup files, from an adult’s profile). Go › TV Service switches the TV service in use, ticking the one you are using, and Go › Switch Profile… opens You and your TV. Help has Keyboard Shortcuts (Settings › Help & about, at that row), Find and Fix a Problem… and Contact Support.

The Mac player’s window and the Dock: Playback › Open Player in Separate Window (Option–Command–P), or the window button at the top of the player, moves what is playing into a window of its own, without stopping it, so you can browse the guide, Movies or Settings in the main window meanwhile. The window keeps the picture’s shape as you resize it, goes full screen on its own and opens where you last left it; a channel or film you start while it is open plays in it. Return to Main Window (the same keys) puts the player back, and closing it closes the player. Closing the main window while the player is in its own window only hides the main window: Return to Main Window brings it back, and closing the player’s window afterwards quits TiviGlass, as closing its last window always does. Previews on Home and Sports don’t play while it is open. Playback › Float on Top (Option–Command–T) keeps the window with the player above other apps’ windows; TiviGlass remembers it on this Mac for the next player, and never floats the window in full screen or once the player has closed. The Playback menu also has Mute (Option–Command–Down Arrow, the player’s own sound, until it closes), Show Stream Facts, Recently Watched on live TV and Picture in Picture (Control–Command–P), which is dimmed when the stream can’t float and otherwise works as the player’s own button. Control-click TiviGlass in the Dock for Play or Pause, the next and previous channel, the last five channels you watched on the TV service in use (each asks its parental question as usual) and, while you are recording on this Mac, Stop Recording; nothing in it plays while Kids Mode is on. A recording runs only while TiviGlass is open: closing the window while one runs asks first, with Keep recording the default (TiviGlass then keeps running in the Dock and the window hides; click it in the Dock to bring the window back) and Quit and stop recording beside it. While a timer is due within 12 hours, the first close in a session says that TiviGlass keeps running for it, and later closes just hide the window. Quitting while a recording runs asks first too, with Keep recording the default; the alert also says how many timers won’t record while TiviGlass is closed. Settings’ window asks for the parental PIN as soon as a protected page opens, even while something plays in the main window, and Sign in opens on the window you asked from.

Sizes and the pointer on a Mac: the Mac app is laid out for a desk, not a phone: text is the same easy-to-read size as on iPhone, and buttons and rows are sized for a pointer. To make text, icons and controls larger, choose Comfortable or Large in Settings › General › Text size; Compact uses the Mac’s own smaller size. Buttons, rows, guide cells and the player’s controls light up under the pointer, and with keyboard navigation on they show the same highlight as the remote’s cursor on the TV. Rest the pointer on an icon-only button to see what it does; the player’s buttons also name their key, such as Pause (Space), Back 10 seconds (←) or Close player (⌘W). On iPhone and iPad, sizes are unchanged; their icons now follow the Text size too.

The TV guide on a Mac: the guide uses the Mac’s own sizes, with a wider channel column, and the preview shows the programme’s description when the window has room. Click a channel, or what is on now, to preview it; double-click it to watch full screen (turn on Open fullscreen with one click in Settings › TV guide to go straight to full screen). Closing full screen (Escape, Command–W, the close button, or closing the player’s own window) goes back to the guide with the preview still playing the channel you were last watching, with the keyboard highlight on its row. If you had rewound into catch-up, were still changing channel, or the channel had stopped with a problem, the preview starts that channel again live instead. Click a programme that is still to come, or one that has finished, to select it: its details open in a column on the right of the window while you keep using the guide, and the column follows whatever you click or move to with the arrow keys. View › Hide Programme Info (Command–I), or Escape, closes it. In a narrower window the column has no room, so double-click a programme to open its details instead. Double-click a finished programme to watch it from the start when the channel has catch-up. Rest the pointer on a programme for a moment for a summary with Watch, Record, Remind and Details (it closes when the pointer moves off, the guide scrolls, or you go to another screen or start watching), or turn Show programme details on hover off in the same section; with it off, the pointer shows the programme’s title and time. Right-click (or Control-click) a programme or a channel for all its options. To move along the timeline, scroll over the times at the top, hold Shift while you scroll, or swipe sideways on a trackpad; the guide carries on into the next or previous day as you reach an end. Option–Left or Right Arrow moves a screen earlier or later, Command–Left or Right Arrow goes to the day before or after, and Escape hides the keyboard highlight. Settings › Help & about › Keyboard shortcuts lists them all.

Films, shows, Search and Catch Up on a Mac: Home, Movies and Shows use the whole width of the window, with up to twelve posters in a row (List layout keeps its rows at a readable width). Rest the pointer on a poster, card or channel name to read the whole title; a locked title shows only that it is locked. Right-click (or Control-click) a poster for Play or Resume and Open before its other options: a film resumes where its page would, and a show plays the episode its page offers next. On a film’s page Return plays it (Resume when you stopped part-way, unless Continue where you stopped is set to Never). On a show’s page Return plays the next episode, the arrow keys move through the season’s episodes, Return plays the one highlighted and Command–I opens its details. Home’s spotlight holds still while the pointer is over it or the keyboard is on it, and carries on a couple of seconds after you move away; Left and Right Arrow step it while the keyboard is on it. In Search, Down Arrow (or Return) moves from the search field into the results, the arrow keys move through them, Return opens or plays the one highlighted, Command–I opens a programme’s details, Option–Left or Right Arrow changes the filter, and Up Arrow from the first result goes back to the field; Escape empties the field, and a second Escape leaves it. In a window at least 900 points wide, Catch Up shows the channels on the left and the chosen channel’s programmes on the right, starting with the first channel that doesn’t ask for a PIN; choose the day from the menu above the programmes or with Command–Left and Right Arrow, click a programme to select it and double-click (or press Return) to watch it, and Right and Left Arrow move the keyboard between the two lists. Right-click a channel there to watch it live, find it in the TV guide or add it to your favourites. In Sports and Kids, the rails and filters scroll with the pointer and the keyboard, and right-clicking a channel or a featured programme offers Watch, the TV guide, recording, reminders and Multi-view. In Live TV, Command-click a channel to start Select channels with it (or to tick and untick one more), Shift-click to tick every channel between it and the last one you clicked, Command–A to tick every channel shown, and Escape to finish.

iPhone and iPad TestFlight builds: sign in with your normal TiviGlass account. TestFlight builds use the same servers, TV services and plan as the App Store app.

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.

In the original TiviGlass interface, the default side menu lists Home, Live TV, Movies, Shows and Search first, followed by Catch Up, Recordings, Reminders, Sports Hub, Kids, Multi-view and Apps, with Settings and Exit pinned at the bottom. Each destination has its own name; the former My TV hub has been removed. Your saved menu order, names and hidden choices are kept. Profile restrictions and section switches still apply. In TV mode, the closed menu shows your profile picture and the clock above the navigation icons, using your chosen 12- or 24-hour format.

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.

How menus work in the original interface. Menus, option lists and questions in TiviGlass use the established side panels. TiviGlass² uses connected panels and workspaces for many of these controls. Every one of them slides in from the right edge of the screen as a full-height panel, the same way More opens in the player: menus, option lists, forms, larger pages such as long lists, and questions that need an answer (the screen behind a question dims until you answer it). Each choice is one line with an icon, its current setting shown at the end (for example Subtitles — English), and an arrow where it leads to a next step. The highlighted line turns red on a choice that removes something. A line at the foot of the panel says what the highlighted choice does, the usual key guide along the bottom of the screen shows which keys work in the menu while it is open, and Back always goes back exactly one step. Switches flip where they are, and a setting with a list of values opens its list in that panel with the current value highlighted, so pressing OK straight away changes nothing. Only things that cannot be undone ask “Are you sure?”, and both answers say what they do. Over live video, options open on the right so the picture stays visible. On boxes with Android 12 or later and plenty of memory, the page behind a menu is softly blurred; the video itself never is.

The player separates programme information from the playback buttons. The highlighted control's name appears below the buttons, for example Pause, Subtitles or More options. Channel and programme names have separate lines, with larger timing text. Stream information such as resolution, HDR, codec, bitrate and frame rate stays visible in a quieter row that wraps when needed. The full-screen player and the live-TV guide player share this layout.

Paused: on a TV, phone or tablet, a round pause symbol sits in the middle of the picture for as long as the video is paused, so a paused picture never looks frozen after the controls hide. It steps aside while the controls, a menu or a message are open, and goes as soon as you press Play. On iPhone, iPad and Mac the controls stay on screen while paused instead.

A compact navigation legend sits below the content, beside the full-height navigation panel. While browsing content it shows D-pad — Move and Back — Go back, including when an item has no hold action. In the navigation panel, movement reads ↑ ↓ — Browse and Back describes its current action: Close menu, Main menu, or the temporary Exit app confirmation (Switch profile for a child). Select describes the highlighted control: ordinary buttons say Choose, Movies and Shows tiles say Open details, and Continue watching tiles say Play. When holding Select does something, its action appears alongside, such as Hold Select — Options or Hold Select — Rename. Disabled actions are omitted. A glowing edge marks your current section in both the open menu and the collapsed icon rail; the bright bar that slides between entries follows the remote. The card at the top keeps your TV service and viewer together above the menu. On a TV every menu entry fits on the screen; where a list is longer than the screen (a phone, larger text, or a long list of groups) its top or bottom edge fades to show there is more. The legend follows focus into the navigation panel and moves clear of the expanded panel without shifting the grid. It uses two steady rows on narrower screens or with larger text. During full-screen playback, hold guidance stays inside the existing control-label area; no separate legend appears beneath the OSD. On touch screens, use a long press; the legend appears when navigating with a remote or keyboard.

ButtonWhat it does while watching
OKShow or hide the on-screen controls
Play / PausePause and resume
Channel + / −Next / previous channel (live TV); in the TV guide, a whole screen of channels at a time
Page Up / Page DownNext / previous channel (live TV only), for remotes whose channel buttons send these keys. Movies, shows and the TV guide are unchanged: in the guide they still move a whole screen of channels at a time. A job you gave these buttons yourself under Settings › General › Remote buttons still wins.
Up / DownNext / previous channel (live TV)
Left / RightSkip back / forward by your seek step (10 seconds by default)
Guide group previewRest the highlight on a provider group in the guide sidebar or horizontal group row and, after a moment, the guide shows that group’s channels and schedule together from the top while the current channel keeps playing. Holding the button down to sweep through the list loads nothing until you stop. Focus stays on the group while you look. Its channel list keeps your hidden-channel choices, renamed channels and manual order. To stay on it, press OK, press Right in the sidebar, or move down into its channels; it then becomes your Last used group. Press Back, or leave the list any other way, and the guide goes back to the group you were on. Find playing channel and the Tools actions do not choose a group either, and if you press OK on a protected group and then cancel its PIN or age question, you stay on the group you started from. A group you only previewed is never remembered. Protected groups need OK and access approval first. Turn off Preview group on focus in Settings › TV guide › Advanced to require OK for every group. Channel Up/Down and Page Up/Down page through the group list; the guide wrap preference applies at its ends.
Show or hide several itemsIn a Show/Hide list, choose Select several, mark the rows, then choose Show selected or Hide selected. Select displayed selects the current filtered results. Bulk changes never affect selected rows outside the displayed results.
Add-on phone setupChoose Add-ons, then Enter on phone. The TV keeps checking the same code through temporary connection failures. If the code expires, choose Try again for a new one. Received details fill the TV form for you to review. Closing the handoff cancels it.
Skip lengthIn Settings › General › Remote buttons › Skip length, choose 10, 20, 30 or 60 seconds. Remote keys, on-screen seek buttons and touch double-taps share this choice. Holding a seek key accelerates the step.
Last ChannelA remote with a physical Last Channel button returns to the previous live channel. Your explicit shortcut binding takes priority. Shortcut editors list actions supported by the chosen screen; unsupported saved actions leave ordinary key handling available.
0–9Type a channel number to jump straight to it (live TV); it changes once you stop typing. Five-digit and longer channel numbers work too; enter the whole number before pausing. It finds the channel showing that number (your own number for a channel you renumbered, else your provider’s), and a channel with no number by its place in the list. A channel that shows a number is never reached by its place. When nothing matches, the player says No channel and the number. Opened from the TV guide, it finds the same channel the guide would.
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). No such keys on your remote? Open More and choose Next episode or Previous episode.
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
BackClose an open panel or hide the controls, then leave the player. In guide fullscreen, Back returns to the guide even when no control is highlighted.