User guide · Chapter 14 of 16

Keeping TiviGlass healthy

Keeping TiviGlass healthy: updates, diagnostics, support.

64

Updates Free

Path: Settings → This device → Updates
How
  1. Leave Check for new versions automatically on and TiviGlass offers updates as they appear.
  2. Read the patch-note preview in Update available, or choose View full release notes. Long notes open in a wide reader; use Page up and Page down with the remote.
  3. Check for new version looks immediately.
  4. Receive beta updates opts into early builds. Beta testers still receive every normal release too, so you never fall behind by staying opted in.
Good to know
The check tells you what it compared: the build number you are on, and whether it looked at the stable channel alone or stable and beta together. Because beta and stable share one build counter, a stable release published after a beta is the newer build — so “you’re on the latest version” with beta updates switched on is a correct answer, not a sign the opt-in failed. Settings → About → Release channel confirms which build you are running. If the update service cannot be reached the screen says so rather than claiming you are up to date.

Updates install over the top — your playlists, profiles and recordings are untouched. On the first launch after an update, What’s new shows those full release notes once more; it does not appear when somebody installs TiviGlass for the first time. The first time an update is installed, the TV may ask permission to install apps from TiviGlass; that’s a one-off.

If an update stops before Android’s installer even opens — an older version says APK signing certificate mismatch, or a current one says the update can’t be installed automatically — download the current APK from tiviglass.com and open it once. When Android accepts it, it installs over the existing app without clearing its data; future in-app updates then use the corrected check. If Android’s own installer instead says the app is incompatible, stop and contact support rather than uninstalling, so your local data can be protected first.
65

Diagnose problems yourself Free

Path: Settings → Help & diagnostics
How
  1. Run self diagnostics 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
Check everything now gives one quick summary of setup, provider and internet health. Recent activity shows what the app just tried. Device logs and the redacted diagnostics export are under Technical details so the normal help screen stays calm; the export never contains passwords or stream URLs.

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 & diagnostics → Self diagnostics 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.
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 → Storage & reset
How
  1. The Storage card shows what TiviGlass and the device are using.
  2. Clear cache removes temporary artwork and files.
  3. Apps you may not need scans for installed apps you could remove.
  4. Clear database cache rebuilds the on-device catalogue from your provider.
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 & diagnostics → 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 five minutes.
  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 → Storage & reset
How
  1. Open Start again at the bottom of Storage & reset.
  2. Clear watch history empties Continue watching and the recent rails.
  3. Reset settings to defaults keeps your playlists and account but resets every preference.
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.