Sonarr and Radarr

A Newznab indexer over Telegram, Usenet and the Internet Archive - on your own machine

To Sonarr and Radarr, tgarr is an ordinary Newznab indexer and a SABnzbd download client. They search it, grab from it and import the result as they do with any other. No plugin, nothing to change in Sonarr or Radarr, and no BitTorrent.

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.

  1. Add the indexer. Settings → Indexers → + → Newznab. Fill it in as in the first table and press Test.
  2. 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.
  3. Let Sonarr or Radarr read the finished files. See where the file lands below.
  4. 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

FieldValue
Nametgarr
Enable RSS, Automatic Search, Interactive SearchOn
URLhttp://<your-host>:8765/newznab/
API Path/api (the default)
API KeyAny text - tgarr checks no key unless you set one (see the questions below)
CategoriesSonarr: 5030, 5040, 5045 (TV). Radarr: 2030, 2040, 2045 (Movies). They are filled in after Test.

The SABnzbd download client

FieldValue
Nametgarr
HostThe machine tgarr runs on
Port8765
URL Base/sabnzbd
Use SSLOnly if you put tgarr behind https
API KeyAny text, as above
Username, PasswordLeave empty
Categorytv in Sonarr, movies in Radarr
Recent Priority, Older PriorityDefault

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:

FieldValue
URLhttp://<your-host>:8765/newznab/usenet
API Path/api
API KeyThe same as for the first entry
Download clientYour 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 itHow
TelegramtgarrSonarr 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.
UsenetYour SABnzbd or NZBGettgarr 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 ArchivetgarrOffered 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:

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

If Test fails: open 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.
You stay responsible for what you index and fetch. tgarr hosts nothing and comes empty. It is not affiliated with Sonarr, Radarr, Jellyfin, Plex, Emby or Kodi.

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 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.