On the television

Your own media center on Android TV, Google TV and Fire TV

tgarr-tv.apk is a small frame around the Media Center of the tgarr at home: full screen, driven by the remote control. Films, music, books and photos stay on your own computer; the television shows them.

Download tgarr-tv.apk

tgarr's Media Center on a television in the Cinema look: a dark page, yellow tabs and large covers
The Media Center on a television, in the Cinema look.

What it isA frame, not a second program

The Media Center, full screen

tgarr is a web page. The app opens its Media Center without a browser around it and hands the remote's keys to the page.

It needs the tgarr at home

Nothing is stored or played by the app itself. It shows the tgarr that runs on your computer or NAS. Install that first.

20 kB, one file of code

One Java file, no libraries. The source is in the tv/ folder of tgarr's repository.

InstallPutting it on the television

The app is not in a store. Download tgarr-tv.apk and put it on the television:

Android TV and Google TV

Send the file to the television - a USB stick, or an app such as "Send files to TV" - and open it with a file manager. The television asks once to allow installing from that app.

Fire TV

The "Downloader" app fetches it from the release's address:

https://github.com/tgarrpro/tgarr/releases/latest/download/tgarr-tv.apk

An early build named tgarr-tv-preview.apk came with 0.5.11 and was signed with a throw-away key. If you have that one, remove it before installing this.

First startHow it finds your tgarr

  1. It looks by itself. The app asks the other addresses on the television's home network for a tgarr on port 8765. This needs tgarr 0.5.11 or later.
  2. If it finds none, type the address you open tgarr at in a browser - 192.168.1.20 is enough.
  3. It remembers. Next time it opens straight at the Media Center. Press Menu for another address, or to load the page again.

The remoteArrows, OK and Back

ArrowsMove to the nearest thing in that direction.
OKOpens it.
BackGoes back; out of a film playing full screen first.
OK on FindOpens the keyboard, to search.
MenuAnother address, or loading the page again.

The arrows also work in an ordinary browser with a keyboard: the Media Center is the same page everywhere. Add ?tv=1 to its address to have it open with the first item chosen.

The lookCinema

On a television the Media Center starts in Cinema: a dark room and the pictures, made for a screen across the room. If the household has a default look, or this screen chose one of its own, that one is used. All the looks, and the rest of the Media Center.

Who sees whatThe PIN holds on the television too

A television that was not unlocked with the PIN shows the Media Center and nothing else - only what you ticked, with the time rules you set. That is tgarr's rule for every device, and the reason this app shows the Media Center.

HonestlyWhat it does not do

Check the signature if the file came from somewhere else. tgarr's TV app is signed by certificate CN=tgarr, SHA-256 1B:4F:42:8E:E4:32:5C:4E:1F:A4:C9:DE:56:41:DB:44:6D:BA:92:95:63:EC:57:E3:4F:7D:6B:D2:C2:A5:33:AF, and so is every later version.

InstallPut it on a computer that stays on

Windows 10 / 11

Download one file and double-click it - no terminal. It sets up WSL2, puts tgarr inside and opens the browser when it is done.

Download install-tgarr.cmd

macOS

Open the zip and right-click install-tgarr.command → Open. It needs Homebrew; the installer adds Colima and puts tgarr inside. This installer has not yet been run from end to end on a real Mac.

Download install-tgarr-macos.zip

Linux and NAS

One line on Linux:

curl -fsSL https://raw.githubusercontent.com/tgarrpro/tgarr/main/install/install.sh | bash

On Synology, QNAP, Unraid, TrueNAS or CasaOS: two files and docker compose up -d. On a NAS

Television

Android TV, Google TV, Fire TV: this 20 kB app is a frame around the Media Center of the tgarr at home, driven by the remote.

Download tgarr-tv.apk

No account of any kind is needed to begin. It takes about 3 GB of disk and 4 GB of memory to spare, and keeps itself up to date. The full instructions.

QuestionsAsked often

Is the app in Google Play or the Amazon Appstore?

No. It is one file, tgarr-tv.apk, on tgarr's releases page on GitHub. You put it on the television yourself; the television asks once to allow installing from the app you opened it with.

Does the television need tgarr installed on it?

No. tgarr runs on a computer or NAS at home. The app is a 20 kB frame around that tgarr's Media Center: it finds the server on the home network, or you type its address once, and it remembers it.

The app does not find my tgarr. What now?

Type the address you open tgarr at in a browser, for example 192.168.1.20. The search works for tgarr 0.5.11 or later on port 8765; a tgarr on another port or behind https has to be typed in. Menu on the remote offers another address at any time.

What can a child do with the remote?

What the Media Center allows. A television that was not unlocked with the PIN shows the Media Center and nothing else, with only what you ticked and with the time rules you set. That is tgarr's rule for every device.

How do I know the file is tgarr's?

It is signed with tgarr's own key: certificate CN=tgarr, SHA-256 1B:4F:42:8E:E4:32:5C:4E:1F:A4:C9:DE:56:41:DB:44:6D:BA:92:95:63:EC:57:E3:4F:7D:6B:D2:C2:A5:33:AF. Every later version is signed with the same key. A file that claims to be tgarr's TV app and is signed by anything else is not.

Has it been tried on a real television?

It was run on an Android TV 14 emulator, not yet on a television in a living room. Tell us on GitHub how it does on yours.