tgarr is Linux software in containers. On Linux the installer starts them. On Windows and on a Mac there is no way around a small Linux underneath - every "Docker for the desktop" is one - so the installer sets it up for you and puts tgarr inside. You get a page at http://localhost:8765; what runs underneath need not concern you again. It keeps itself up to date.
It needs about 3 GB of disk to begin with (about 600 MB is downloaded), and 4 GB of memory to spare. On Linux, when the machine has an Intel or NVIDIA graphics card, films are converted on it.
Windows 10 and 11 run on a Windows 11 PC
Download install-tgarr.cmd · 1 kB
- Double-click the file. Windows may say it is not commonly downloaded, or "Windows protected your PC" - it says that of every script no company has paid to sign. More info → Run anyway. The file is a few lines; open it in Notepad to read them.
- Say Yes when Windows asks whether the installer may make changes.
- If WSL2 - the Linux that Windows carries - is not switched on yet, it is switched on and Windows restarts once. When you have logged in again the installation goes on by itself (and asks for permission once more).
- It installs tgarr and asks whether the other devices at home may reach it. Enter is yes: phones, tablets and televisions on your home network can then open it - never anything from the internet.
- The browser opens on tgarr.
It starts with Windows, in the background, before anybody logs in. Its files are at \\wsl$\Ubuntu\opt\tgarr in Explorer. Windows 10 needs version 2004 or later.
macOS new - not yet run on a real Mac
Download install-tgarr-macos.zip · 1 kB
- It needs Homebrew. If you do not have it, install it first (one line, on its site).
- Open the zip and right-click
install-tgarr.command→ Open (the first time; macOS does not open an unsigned file on a double-click). - It installs Colima - a small Linux machine with Docker in it - starts it, has it start again at login, and installs tgarr inside.
What tgarr fetches is put in ~/tgarr/downloads, where Finder sees it. This installer has been written with care and tried piece by piece, but nobody has yet run the whole of it on a Mac: if you do, tell us what it printed.
Linux run on a new Ubuntu 24.04
curl -fsSL https://raw.githubusercontent.com/tgarrpro/tgarr/main/install/install.sh | bash
It installs into ~/tgarr. If Docker is missing it asks before installing it. On a NAS - Synology, QNAP, Unraid, TrueNAS, CasaOS - use the two files and docker compose up -d instead: the README says how.
On the television, and on a phone
- Android TV, Google TV, Fire TV: tgarr-tv.apk (20 kB) is a full-screen frame around tgarr's Media Center, driven by the remote control. It finds tgarr on the home network by itself. How to put it on the television.
- Phone or tablet: open tgarr in the browser and choose Add to Home Screen. From the Media Center page you get an icon that opens the Media Center alone - the one for a child's tablet.
Afterwards
- No account is needed to begin. The first page names the ways to fill the library: the Internet Archive and your own files need none; Telegram and Usenet take the accounts you have.
- Updates come by themselves within the hour of a release. Settings → Updating tgarr has it look at once.
- Run the installer again at any time: it brings tgarr's files up to date and starts what is not running. Your settings and your data are left alone.
- Settings for the installers, and how to remove tgarr again: the full guide.