What it isThree sources behind one indexer
Telegram channels
tgarr reads the channels you follow, parses file names and captions into films and episodes, and offers them to Sonarr and Radarr. On a grab it fetches the file itself.
Usenet newsgroups
With a Usenet account, tgarr reads newsgroup headers and keeps a card for every named film and episode. When Sonarr or Radarr wants one, tgarr makes the NZB itself - no outside NZB indexer, no invitation. Choosing a provider.
The Internet Archive
When Radarr asks for a film, tgarr also offers what archive.org has under that title - with no account of any kind. How tgarr uses the Archive.
Set it upAdd tgarr to Sonarr or Radarr
tgarr listens on port 8765. Its dashboard and its Settings page show the exact address under Connect Sonarr / Radarr, with a Copy button.
- Add the indexer. Settings → Indexers → + → Newznab. Fill it in as in the first table and press Test.
- Add the download client. Settings → Download Clients → + → SABnzbd. Fill it in as in the second table and press Test. This entry is tgarr itself, not a SABnzbd you run.
- Let Sonarr or Radarr read the finished files. See where the file lands below.
- Try it. Open a series or a film, use the interactive search, and grab one of tgarr's results. It appears under Activity → Queue with tgarr as the client, and is imported when it is done.
The Newznab indexer
| Field | Value |
|---|---|
| Name | tgarr |
| Enable RSS, Automatic Search, Interactive Search | On |
| URL | http://<your-host>:8765/newznab/ |
| API Path | /api (the default) |
| API Key | Any text - tgarr checks no key unless you set one (see the questions below) |
| Categories | Sonarr: 5030, 5040, 5045 (TV). Radarr: 2030, 2040, 2045 (Movies). They are filled in after Test. |
The SABnzbd download client
| Field | Value |
|---|---|
| Name | tgarr |
| Host | The machine tgarr runs on |
| Port | 8765 |
| URL Base | /sabnzbd |
| Use SSL | Only if you put tgarr behind https |
| API Key | Any text, as above |
| Username, Password | Leave empty |
| Category | tv in Sonarr, movies in Radarr |
| Recent Priority, Older Priority | Default |
Usenet: a second indexer
If you switched Usenet on in tgarr (Settings → Usenet), add a second Newznab indexer beside the first, and give it your own Usenet downloader:
| Field | Value |
|---|---|
| URL | http://<your-host>:8765/newznab/usenet |
| API Path | /api |
| API Key | The same as for the first entry |
| Download client | Your SABnzbd or NZBGet - not the tgarr entry |
An indexer goes to one download client, which is why Usenet needs an entry of its own. The full text: tgarr in Sonarr and Radarr.
On a grabWhat happens, source by source
| Who fetches it | How | |
|---|---|---|
| Telegram | tgarr | Sonarr hands the grab to the tgarr download client. tgarr fetches the file from Telegram with your own account and shows the progress in Sonarr's queue. |
| Usenet | Your SABnzbd or NZBGet | tgarr builds the NZB from the headers on your news server and gives it to Sonarr, which passes it to your downloader. tgarr does not download films or series from Usenet. |
| The Internet Archive | tgarr | Offered to Radarr for films. tgarr fetches the file from archive.org over HTTPS, through the same tgarr download client. |
AfterwardsWhere the file lands
A file that tgarr fetched is written to /downloads/tgarr/<release-name>/ on the tgarr machine. Sonarr or Radarr then imports it into your library - the folders Jellyfin, Plex, Emby or Kodi already read. Nothing changes in the player.
Sonarr and Radarr must be able to read that folder:
- On the same machine: mount tgarr's downloads folder into the Sonarr or Radarr container at
/downloads. No remote path mapping is needed. - On another machine: share the downloads folder (the documentation shows NFS), mount it there, and add a Remote Path Mapping from
/downloadsto the place you mounted it.
A Usenet grab does not pass through this folder: it ends up where your own downloader puts it, as before.
WhyNo BitTorrent anywhere
Nothing is uploaded
tgarr does not seed. A file comes down from Telegram, from your Usenet provider or from archive.org, and that is all.
No peers
You connect to no other downloader, so your address is not shown to other downloaders.
No ratio, no invitation
There is nothing to keep up and nobody to ask. tgarr is free and open source (MIT).
HonestlyLimits
- It finds what is there. A search covers the channels and newsgroups that are indexed. If a search returns nothing, check that tgarr has indexed the channels you care about.
- Telegram sets the pace. Telegram slows down the fetching of large files at times; that is normal. A file can be up to 2 GB, or 4 GB with Telegram Premium.
- Your Telegram account does the fetching. Heavy automated use can trip Telegram's anti-spam systems. The documentation advises a dedicated account, not your main one.
- The Usenet entry is empty while Usenet is switched off or the news server does not answer. A release that is no longer on the server gives an error, not an NZB.
- Archive films are for Radarr. The Internet Archive is offered on film searches, not on series searches.
- Films and series only. Music and book searches are not offered, so Lidarr and Readarr get little from it.
- Adult material is left out of what Sonarr and Radarr are offered, unless the person who runs tgarr switches it on.
- The file must be readable. If a download finishes and is not imported, Sonarr cannot read the path - check the mount or the Remote Path Mapping.
http://<your-host>:8765/newznab/api?t=caps in a browser. It should return XML. If it does not, the address is wrong or something stands between Sonarr and tgarr.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.
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.
Linux and NAS
One line on Linux:
curl -fsSL https://raw.githubusercontent.com/tgarrpro/tgarr/main/install/install.sh | bashOn 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.
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 tgarr a Newznab indexer?
Yes. It answers the Newznab searches Sonarr and Radarr send - by title, and for series by season and episode - and you add it under Settings, Indexers, Newznab like any other. There is one address for what it finds on Telegram and the Internet Archive, and a second one for Usenet.
Do I need an API key?
Not unless you set one. By default tgarr checks no key, so any text will do in the API Key field. If you start tgarr with TGARR_API_KEY set, the Newznab and SABnzbd addresses refuse a request without that key, and you enter it in Sonarr and Radarr.
Why does tgarr appear as a SABnzbd download client as well?
A file from Telegram or the Internet Archive is not on Usenet, so a real SABnzbd could not fetch it. tgarr answers the way SABnzbd does: Sonarr hands it the grab, sees it in the queue and in the history, and imports the finished file as it would after any Usenet download.
Do I need a Usenet account, or a Telegram account?
Neither to begin. Radarr can ask for films from the Internet Archive with nothing configured but tgarr. To fetch a file from Telegram, tgarr signs in to your own Telegram account. For Usenet you give tgarr your account with a provider, and keep your own SABnzbd or NZBGet for the downloading.
Does tgarr download from Usenet itself?
Not films and series. For those it makes the NZB from the newsgroup headers and Sonarr or Radarr hands it to your downloader. tgarr itself fetches only small things that were posted whole - a book, a song, a picture - into its own Library, and never video.
Does it work with Lidarr and Readarr?
Not well. tgarr offers film and series searches only; music and book searches are not offered through Newznab. Books and music are found and opened in tgarr's own pages.
Does it use BitTorrent?
No. Nothing is uploaded to other people, there are no peers who see your address, and there is no ratio or invitation. Files come from Telegram, from your Usenet provider or from archive.org.