Troubleshooting

Keeping TiviGlass healthy

Keep TiviGlass running well: install updates, diagnose problems yourself, free up space, get help from support, or start again.

  • Chapter 14 of 16
  • 7 how-tos
64

Updates Free

Path: Settings › This device › App updates
How
  1. Released sideload builds with automatic updates enabled check for new versions in the background. Choose Check for updates to check immediately, then follow the update prompt and Android installer.
  2. For a first install or an early manual-only build, open Downloader. For TiviGlass (TG1), enter https://tiviglass.com/apk. For TiviGlass² (TG2), enter code 3817356 or https://tiviglass.com/tg2/apk.
  3. If Android asks, allow the app performing the update to install apps, then return to the installer and confirm.
  4. Check Version under Settings › Help & about after installation.
Good to know
Do not uninstall or clear app data to update. Installing a newer, correctly signed APK over the existing app preserves its saved data. If Android says the package is incompatible, or refuses an older version, stop and contact support before removing anything.

Each app updates to its own interface; a TG2 update does not replace TiviGlass. Early TG2 versions need one manual upgrade to a release that supports automatic checks. Android still asks you to approve installation. Private staging development builds are installed directly by the developer and have no public updates. Google Play editions update through Google Play. Updating your TV services and programme guide is separate.

TiviGlass needs Android 6.0 or newer; the Google Play edition needs Android 7.0 or newer. On an older device, downloading the APK again or uninstalling the current app will not make it compatible.
65

Diagnose problems yourself Free

Path: Settings › Help & about
How
  1. Find and fix a problem does an end-to-end check of playlist, guide, on-demand, recording, account and sync.
  2. It ranks what it finds and names a likely root cause.
  3. Fix what I can applies the safe fixes automatically.
  4. Probe a channel tests one specific stream in the background.
  5. Cancel stops a run there and then. Back asks whether to Keep running or Cancel run, so a check that takes a while is never thrown away by the press you use to leave every other screen.
Good to know
Quick connection test checks only your internet and TV services, and Check my saved data only what is stored on this TV. On a TV with a very large saved catalogue, Database integrity stops after 10 seconds and shows as skipped, so the check never holds the TV up; that is not a fault. Recent activity shows what the app just tried. If a TiviGlass safety update has switched something off on your TV, such as Match TV frame rate on one kind of box while a fault is fixed, Fix a problem says what at the top. It is temporary and ends on its own. Restart TiviGlass closes the app completely and opens it again, which is quicker than finding Force stop in your TV’s settings. Everything you have saved is kept, but a recording that is running stops, and the question says so first. View device log and Save a support report, the redacted diagnostics export, are under Settings › Account › Privacy; the export never contains passwords, tokens or keys.

Send crash reports, on that page, sends a technical report when something goes wrong, so the fault can be found and fixed. While it is on, it also sends a short summary of how smoothly video played. That summary is numbers only and goes at most once a week, after at least 10 minutes of sampled playback or app performance measurements since the last report. It says how long video played, how often it stopped to buffer and how smooth the picture was, along with the device details a crash report carries. Nothing you watch is named in it, and the player’s errors in a crash report name no channel or title. When a video fails to play, or the app switches to another copy of a channel, a short technical record of what happened goes with the next report: the kind of error, the state of the connection and the decoder, what the app tried, and what you did next. Nothing you watch is named in it, not even a channel number. The summary also includes sampled processor and memory use, and graphics rendering times where this device supports them, to help us improve performance. It can be sent after ten minutes using the app even if no video was played. Turn the setting off and the summary and these records stop, and any not yet sent are deleted.

A run keeps going if you leave it. Choose Keep running when you press Back and a small banner stays at the top of the screen with your report ID and how far it has got; come back to Settings › Help & about › Find and fix a problem and you pick up exactly where you left off, or read the finished report. One exception: a run that includes a playback check cannot be left running, because it needs the video player you are about to go back to — there, Back simply cancels and keeps whatever finished. Whatever you choose, the checks that already ran are kept in Previous runs.

Every run has a report ID like TGD-M3K8QF2-1, shown on the results screen. Copy report puts a short plain-text summary on the clipboard for support: the ID, which checks ran and whether each passed, and nothing else — no channel names, no server addresses, no passwords.

You don’t have to come here to find these. When a channel fails to play, the Get help button on the error takes you straight to the right row with it already highlighted — the health check if the channel never started, or self diagnostics if it started and then stopped. Press Back and you are returned to whatever you were watching or browsing before, not left in Settings. If the setting has moved or been renamed in a newer version, TiviGlass opens the page it is on and tells you it moved, rather than silently landing you somewhere blank.
Leaving a run on iPhone, iPad and Mac: press Back while the checks run and choose Keep running, and a small banner at the top of the app shows the report ID and how many checks have finished, then that the report is ready. It is only a sign: it can’t be tapped or clicked, and it never covers a channel or film playing full screen. Open Settings › Help & about › Find and fix a problem to watch the run, cancel it or read the report; the banner goes once you are back there.
65b

When a screen is loading, or will not load Free

Path: Anywhere in TiviGlass
How
  1. A screen that is still working tells you what it is preparing, not just “Loading”. If it is unusually slow it says so, and the rest of TiviGlass keeps working while you wait.
  2. If something fails, the message names what failed, which part of the system it belongs to (your TV service, your account, or storage on this box) and whether anything was lost.
  3. Every failure offers a first thing to try — usually Try again — and, where it can, a second option such as Run a check or Sign in again.
  4. If the profile screen cannot load, Try again re-reads it. You no longer have to close and reopen the app.
Good to know
Anything already on screen stays there when a refresh fails. If your channels, movies or guide are already loaded and an update cannot complete, TiviGlass keeps showing what it has and puts a small line at the top explaining why, rather than emptying the screen. An empty screen therefore means genuinely empty, not “the refresh went wrong”.

A message never blames your internet for something that happened on the box, or the other way round. If it says storage on this device, your broadband is not the problem.

Options that would not do anything on the screen you are looking at are simply not shown. The profile screen appears before the rest of the app exists, so it offers Try again and nothing else; the same failure on the Home screen also offers Run a check, because self diagnostics is reachable from there.

During first-time setup, a step that was tried and did not finish now says so under the card, so Try again is not the only clue that something went wrong.
66

Free up space Free

Path: Settings › Help & about › Storage
How
  1. The lines at the top of Storage space show what TiviGlass and the device are using, including what recordings and paused TV take up. TiviGlass measures its own folders in the background when the page opens, so for a moment the line says Measuring. On a very slow drive it stops measuring after about ten seconds and says at least, because the true figure is then bigger than the one shown.
  2. The rows that only show or open something come first, so the page never opens with a delete highlighted: Apps you may not need scans for installed apps you could remove, and Open Android storage settings and Open device apps settings open the TV’s own screens.
  3. Clear cache removes temporary artwork and files. Paused TV that a channel is using right now is kept, and so are recordings and a recording in progress; the message afterwards says when paused TV was kept.
  4. Re-download all channels & guide deletes the downloaded TV guide for every TV service on this TV, and the downloaded pictures, then runs Update all TV services, so channels, the guide, movies and shows download again, one service after another. Your services, favourites and settings are kept. While an update is already running it asks you to try again when that finishes. To do this for the service in use only, use Clear downloaded TV guide on the TV guide page.
Good to know
Clearing the cache never touches favourites, custom names, groups or recordings — those are stored separately and rebuild on top of the fresh catalogue.

Anything on this page that clears or resets in bulk asks you to confirm first, and the confirmation now starts with an Applies to line saying how far the change reaches — This TV service, This device or Your whole account. Read that line rather than guessing from the title: “Restore all group names” affects only the TV service you are using, while “Remove device” affects your account on every TV. On anything irreversible the highlight starts on Cancel, so it always takes a deliberate move to go ahead.

TiviGlass also tidies up on its own. If you have several playlists and haven’t opened one for about a month, its downloaded movie list, show list and TV guide are released to free up space; the playlist itself, and everything you set up on it, stay exactly where they are. The next time you switch to that playlist it fetches them again, so the first load takes a little longer than usual. Anything you starred, added to your watchlist, put in a custom folder or renamed is kept, so it keeps showing up in your lists in the meantime. A playlist you imported from a file is never touched this way, because there would be nothing to download it back from.
67

Get help from support Free

Path: Settings › Help & about › Start support session
How
  1. Select Start support session, choose the problem you want checked, then select Start.
  2. The TV begins the matching diagnostic checks straight away and shows an 8-character code. Give that code to support within one hour.
  3. A banner shows when support connects; select End session to disconnect at any time.
Good to know
The first person to use the code is the only person who can claim that session. If TiviGlass restarts, it safely resumes an unfinished session and does not repeat a completed support action. Passwords, tokens and stream URLs are stripped before results leave the TV. Sessions end themselves after 20 minutes of inactivity and cannot last more than two hours.
68

Start again Free

Path: Settings › Help & about › Advanced
How
  1. Open Settings › Help & about › Advanced.
  2. Reset settings to defaults keeps your TV services, account and PIN, and resets every other setting. While a PIN is set it also keeps your parental controls as they are: Enable parental controls, Skip PIN on locked channels, films & shows and the Ask for the PIN before opening switches.
  3. Clear watch history is on Settings › Channels & library › Watching & history. It empties Continue watching, the Recently watched channels in Live TV and the guide, the watched ticks on episodes and where you stopped in movies and episodes, for the current viewer on the TV service in use. Other profiles and your other TV services keep theirs. With Cloud sync on, the clear no longer comes back after the next sync, and it reaches that viewer’s other supported TiviGlass devices once they have the latest update (a TV still on an older version clears Continue watching and resume points, but keeps listing the rest until it updates). Anything you watch afterwards appears as normal.
Good to know
Take a backup first (how-to 63). If cloud sync is on, a reset device pulls its data back down as soon as you sign in again.
69

Privacy Free

Path: Settings › Account › Privacy
How
  1. Your privacy at a glance shows, read from this TV’s own settings: advertising and tracking code (none is built into the app), where your watch history is kept, what diagnostics are sent, what your account holds, how your TV service logins are protected, and when support can see this TV. Press a line to change it.
  2. Turn on Private session to stop TiviGlass keeping new watch history, Continue watching, resume points, the last channel and recent searches. The side menu’s top card shows Private while it is on, and You and your TV has End private session.
  3. Diagnostics & device log holds Send crash reports, Remote technical checks, Keep a device log, View device log and Save a support report.
  4. Your data clears your recent searches, links to clearing watch history, to Cloud sync and backups and to deleting your account, and explains how to ask for a copy of your account data.
  5. Services this app connects to lists every service the app can contact, what it sends and whether it is in use now.
Good to know
What a private session does not do. It changes what TiviGlass keeps about you; it does not make you invisible. Your TV service still sees what you stream, and your internet provider can still see which servers your TV connects to. Recordings, reminders and favourites you set while it is on are kept, because you asked for them. What was already saved before you turned it on stays until you clear it. A film you pause during a private session resumes in the same session, and that place is forgotten when the session ends. It is yours alone: anyone else chosen in Who’s watching is recorded as normal, and switching back to you finds it still on. It ends when you turn it off, when Kids mode starts, or when you sign out; restarting the TV does not end it. It also pauses remote technical checks and automatic subtitle searches.

Saved TV service addresses. New service and recording addresses are encrypted when saved, including an M3U address with a login inside it. Older saved addresses are protected during background maintenance. The privacy dashboard still points out addresses that include a login, so you know to treat those links as private.

Two-step verification. If you have turned on an authenticator for your TiviGlass account, enter its code when opening the website’s TV service settings or changing saved service logins. The same check protects cloud copies and linked home servers. A TV signed in through the phone’s verified pairing flow keeps its verified session; you do not need to type a code for each programme. If the account security check is temporarily unavailable, saved logins stay protected until it can be checked again.

Remote technical checks let the TiviGlass team run read-only checks on this TV to find faults nobody has reported. They read technical facts: memory, storage, connection tests, counts, your TV service’s server name and error logs with logins removed. They cannot ask for your history, recordings, channel line-up, your services’ names or what is playing. Switch them off here at any time.

Recent searches are kept for the profile that typed them. Another profile, or another account on the same TV, sees none of them, and signing out clears them. The list is not sent to TiviGlass.

The connection list is part of the app and is checked every time the app is built. It is not a recording of your TV’s traffic.
On iPhone, iPad and Mac: open Settings › Account › Privacy (under Household & account; Help & about has a link to it). Your privacy at a glance shows advertising and tracking code (none), where your watch history is kept, what diagnostics are sent (none: the app sends no crash reports or usage statistics), what your account holds and that your TV service logins are kept in the device’s keychain (the links inside an M3U playlist are kept as the playlist gives them, so a login written into them is kept too). Turn on Private session to stop TiviGlass keeping new watch history, Continue watching, resume points, Recently watched, the last channel, recent searches and Most watched counts for you on this device, and to stop automatic subtitle searches; a playback failure in Recent activity is logged without the title. The navigation menu’s top card shows Private while it is on, and You and your TV has End private session. A film you pause resumes in the same session; that place is forgotten when the session ends. It ends when you turn it off, when Kids Mode starts or when you sign out; closing the app or restarting the device does not, and a child’s profile cannot start one. Diagnostics & device log (moved here from Help & about) holds Keep a device log and View device log. Your data clears your recent searches and links to clearing watch history, Cloud sync and deleting your account. Services this app connects to lists every service the app can contact; there are no remote technical checks or support sessions on these devices. Signing out, for any reason, also clears every profile’s recent searches and the app’s cache of web responses.