IRC
IRC stands for Internet Relay Chat. autobrr has its own IRC client built in which lets it monitor the #announce channels without the need for additional software.
Prerequisites
You need a registered nick on most IRC servers to be able to join channels. We will set up a registered user in a few easy steps.
You need a separate IRC client to do this. Here are some free and open source options:
- Konversation - Linux
- LimeChat - MacOS
- HexChat - Windows/Linux
- The Lounge - A web based, self hosted option.
Make sure your indexer is supported before proceeding.
Click to view supported indexers
| Indexer | Description | IRC | RSS |
|---|---|---|---|
| ABNormal | ABNormal (ABN) is a French General tracker | ✓ | ✓ |
| Acid-Lounge | Small general tracker. | ✓ | ✓ |
| Aither | Aither is a community-built Movie/TV/FANRES database. | ✓ | ✓ |
| AlphaRatio | AlphaRatio (AR) is a private torrent tracker for 0DAY / GENERAL | ✓ | ✓ |
| AnimeBytes | AnimeBytes (AB) is a private torrent tracker for Anime, Manga, J-Music, OSTS, Hentai, Games and Light Novel. | ✓ | ✓ |
| AnimeWorld | AnimeWorld is a private indexer for Anime. | ✓ | ✓ |
| Anthelion | Anthelion (ANT) is a Private Torrent Tracker for MOVIES | ✓ | ✓ |
| Bemaniso | Bemaniso is a private tracker for Bemani which is a series of music and rhythm games by Konami | ✓ | ✗ |
| BeyondHD | BeyondHD (BHD) is a private torrent tracker for HD MOVIES / TV | ✓ | ✓ |
| BIT-HDTV | Bit-HDTV (BHDTV) is a specialized HD tracker in movies and TV with so many daily uploads. | ✓ | ✓ |
| BitHUmen | BitHUmen is a Hungarian Private site for TV / MOVIES / GENERAL | ✓ | ✓ |
| BitSexy | BitSexy (BSEX) is a private torrent tracker for XXX | ✓ | ✓ |
| BitTorrentFiles | BitTorrentFiles (BTF) is a GERMAN private torrent tracker for MOVIES / TV / GENERAL. | ✓ | ✓ |
| BroadcasTheNet | BroadcasTheNet (BTN) is a private torrent tracker focused on TV shows | ✓ | ✓ |
| BrokenStones | BrokenStones is a Private Torrent Tracker for macOS | ✓ | ✓ |
| Cathode-Ray Tube | Cathode-Ray Tube (CRT) is a private torrent tracker for classic and international movies. | ✓ | ✓ |
| DanishBytes | DanishBytes is a private torrent tracker for HD MOVIES / TV | ✓ | ✓ |
| DigitalCore | DigitalCore (DC) is a private torrent tracker for General / 0 Day. | ✓ | ✓ |
| DocsPedia | DocsPedia.world private torrent tracker for EDUCATION | ✓ | ✓ |
| Empornium | Empornium (EMP) is a private torrent tracker for XXX | ✓ | ✓ |
| Enthralled | Enthralled (ENT) is a private torrent tracker for XXX | ✓ | ✓ |
| FearNoPeer | FearNoPeer (FnP) is a private torrent tracker for Movies, TV Shows & General releases | ✓ | ✓ |
| FileList | FileList (FL) is a ROMANIAN private torrent tracker for MOVIES / TV / GENERAL | ✓ | ✓ |
| FinElite | FinElite (FE) is a finnish private tracker. | ✓ | ✗ |
| FunFile | Welcome to funfile.org, where files are fun! | ✓ | ✓ |
| Fuzer | Fuzer is a private Israeli tracker | ✓ | ✗ |
| GazelleGames | GazelleGames (GGn) is a private torrent tracker for GAMES | ✓ | ✓ |
| Hawke-UNO | Hawke-UNO (HUNO) is a private torrent tracker for MOVIES / TV. | ✓ | ✓ |
| HD-Only | HD-Only (HD-O) is a FRENCH Private Torrent Tracker for HD MOVIES / TV | ✓ | ✓ |
| HD-Space | HD-Space (HDS) is a Private Torrent Tracker for HD MOVIES / TV | ✓ | ✓ |
| HD-Torrents | HD-Torrents (HD-T) is a private torrent tracker for HD MOVIES / TV | ✓ | ✓ |
| HDBits | Private HD tracker | ✓ | ✓ |
| Hebits | Hebits is a private Israeli tracker | ✓ | ✗ |
| iAnon | iAnon is a Private Torrent Tracker for macOS | ✓ | ✓ |
| ImmortalSeed | ImmortalSeed (iS) is a Private Torrent Tracker for MOVIES / TV / GENERAL | ✓ | ✓ |
| iNSANE | iNSANE is a HUNGARIAN Private Torrent Tracker for 0DAY / GENERAL | ✓ | ✓ |
| IPTorrents | IPTorrents (IPT) is a private torrent tracker for 0DAY / GENERAL. | ✓ | ✓ |
| KeepFRDS | PT@KEEPFRDS is a CHINESE Private Torrent Tracker for HD MOVIES / TV | ✓ | ✓ |
| Locadora | Locadora is a Brazilian tracker for Movies, TV Shows and Animes. | ✓ | ✗ |
| LST | LST is an English private tracker for MOVIES / TV / GENERAL | ✓ | ✓ |
| LustHive | LustHive (Lsh) is a private torrent tracker for XXX | ✓ | ✓ |
| Milkie | Milkie is a private torrent tracker for GENERAL. | ✓ | ✓ |
| MoreThanTv | MoreThanTv (MTV) is a torrent tracker for Series and Movies. | ✓ | ✓ |
| MyAnonamouse | MyAnonaMouse (MAM) is a large ebook and audiobook tracker. | ✓ | ✓ |
| nCore | nCore | ✓ | ✓ |
| Nebulance | Nebulance (NBL) is a ratioless private torrent tracker for TV | ✓ | ✓ |
| Norbits | NorBits is a Norwegian Private site for MOVIES / TV / GENERAL | ✓ | ✓ |
| Nyaa | Nyaa is an indexer for Anime. | ✓ | ✗ |
| OnlyEncodes | OnlyEncodes (OE) is a private torrent tracker for MOVIES / TV | ✓ | ✓ |
| Orpheus | Orpheus (OPS) is a Private Torrent Tracker for MUSIC | ✓ | ✓ |
| PassThePopcorn | PassThePopcorn (PTP) is a private torrent tracker for MOVIES | ✓ | ✓ |
| PixelHD | PixelHD is a specialty movie site. Ratio free. | ✓ | ✓ |
| PolishSource | PolishSource (PS) is a POLISH private torrent tracker for 0DAY / GENERAL. | ✓ | ✓ |
| PolishTracker | PolishTracker (PT) is a POLISH private torrent tracker for 0DAY / GENERAL. | ✓ | ✓ |
| Pornbay | Pornbay (PB) is a private torrent tracker for XXX | ✓ | ✓ |
| PreToMe | PreToMe (PTM) is 0Day/General ratioless tracker with very good speed & Pretime. | ✓ | ✓ |
| PrivateSilverScreen | PrivateSilverScreen (PSS) is a private tracker for MOVIES / TV / MUSIC | ✓ | ✓ |
| PTFiles | PTFiles (PTF) is a Private site for TV / MOVIES / GENERAL | ✓ | ✓ |
| PussyTorrents | PussyTorrents is the adult sister site of the well known TorrentLeech. | ✓ | ✓ |
| Redacted | Redacted (RED) is a private torrent tracker for MUSIC | ✓ | ✓ |
| ReelFliX | ReelFliX (RFX) is an English private tracker for MOVIES | ✓ | ✓ |
| RetroFlix | RetroFlix (RFX) is a private torrent tracker for CLASSIC MOVIES / TV / GENERAL | ✓ | ✓ |
| RevolutionTT | RevolutionTT (RTT) is a private torrent tracker for 0DAY / GENERAL. | ✓ | ✓ |
| Romanian Metal Torrents | Romanian Metal Torrents (RMT) is a private torrent tracker for METAL MUSIC. | ✓ | ✓ |
| SATClubbing | SATClubbing is a RUSSIAN/ENGLISH Private Torrent Tracker for ELECTRONIC MUSIC | ✓ | ✗ |
| SceneHD | SceneHD (SCHD) is a private torrent tracker for HD MOVIES / TV. | ✓ | ✓ |
| SeedPool | SeedPool is a private torrent tracker for 0DAY / GENERAL | ✓ | ✓ |
| Sharewood | Sharewood (Sw) is a Private French Torrent Tracker for MOVIES / TV / GENERAL | ✓ | ✓ |
| SpeedApp | SpeedApp is a ROMANIAN Private Torrent Tracker for MOVIES / TV / GENERAL | ✓ | ✗ |
| SubsPlease | SubsPlease is an indexer for Anime. | ✓ | ✓ |
| SugoiMusic | SugoiMusic (SM) is a private torrent tracker for MUSIC | ✓ | ✗ |
| SuperBits | Superbits is a SWEDISH private torrent tracker for MOVIES / TV / 0DAY / GENERAL | ✓ | ✓ |
| TheDarkCommunity | TheDarkCommunity (TDC) is a private torrent tracker for MOVIES / TV | ✓ | ✓ |
| TheOldSchool | TheOldSchool (TOS) is a general french tracker. | ✓ | ✓ |
| Tokyo Toshokan | A BitTorrent Library for Japanese Media | ✓ | ✗ |
| TorrentBytes | TorrentsBytes (TBy) is a private torrent tracker for GENERAL | ✓ | ✓ |
| TorrentDay | TorrentDay (TD) is a private torrent tracker for GENERAL. | ✓ | ✓ |
| TorrentHR | TorrentHR (THR) is private croatian tracker | ✓ | ✓ |
| TorrentLeech | TorrentLeech (TL) is a private torrent tracker for 0DAY / GENERAL. | ✓ | ✓ |
| TorrentNetwork | Torrent Network (TN) is a GERMAN Private site for TV / MOVIES / GENERAL | ✓ | ✓ |
| TorrentSectorCrew | Torrent Sector Crew (TSC) is a GERMAN Private Torrent Tracker for MOVIES / TV / GENERAL. | ✓ | ✓ |
| TorrentSeeds | TorrentSeeds (TS) is a GENERAL/0-DAY tracker with great pretimes. | ✓ | ✓ |
| TorrentSeeds Music | TorrentSeeds (TS) is a GENERAL/0-DAY tracker with great pretimes. | ✓ | ✓ |
| TorrentSyndikat | TorrentSyndikat (TS) is a private german torrent tracker. | ✓ | ✓ |
| TranceTraffic | TranceTraffic is a Private site for MUSIC | ✓ | ✓ |
| UHDBits | UHDBits (UHD) is a private torrent tracker for HD MOVIES / TV | ✓ | ✓ |
| Upload.cx | ULCX is an English private tracker focused on quality movies and tv. | ✓ | ✓ |
| XSpeeds | XSpeeds (XS) is a private torrent tracker for MOVIES / TV / GENERAL. | ✓ | ✓ |
| Generic Newznab | Newznab is an API search specification for Usenet | ✗ | ✗ |
| Generic RSS | Generic RSS | ✗ | ✓ |
| Generic Torznab | Generic Torznab | ✗ | ✗ |
Registering with NickServ
When you first open the IRC client it usually tells you to set up your nickname and choose what server to connect to. You should preferably choose the username you use on the tracker(s) you want autobrr to monitor for this.
- Connect to the IRC network using your IRC client of choice.
- Register your nick with NickServ:
/msg nickserv register PASSWORD EMAIL
The password should not match the one you use for logging in to the tracker. The e-mail address doesn't have to match either.
If you do not plan to use grouped nicks (read the next section), make sure to disconnect from the IRC server in your IRC client before attempting to set it up in autobrr.
Grouping nicks
It is recommended to set up autobrr with a grouped IRC nick since you might want to talk in the other channels in a separate IRC client while autobrr monitors the #announce channel.
Some trackers require the |autodl or |bot part to let you join the #announce channel. Others are fine with something like user-bot or user_bot. Some IRC networks won't even accept the pipe |. Your tracker wikis usually tells you what to use.
NickServ allows you to group two nicks to the same account in a few easy steps:
- While connected to the IRC server with
username, do/nick USERNAME|AUTODLto change to the nick you want autobrr to use. - Ask NickServ to group your nicks:
/msg nickserv group USERNAME PASSWORD - Change back to your username:
/nick USERNAME
You have now successfully grouped your nicks and can safely connect autobrr to the IRC network with username|autodl while using username in another IRC client if you want.
Getting banned on IRC
In some rare occurrences your bot might get banned from the IRC network. This can happen if the network suddenly changes how people are allowed to connect for example.
Some networks won't require special authentication, while others do, but they could implement it at any time. If they do, and your bot isn't set up for it, it will just retry to join the channel into infinity on a set interval. The network owners might ban you in this case.
Usually these things can often be resolved by contacting their support. Most trackers have a #support channel as well as a ticket system on their site.
You shouldn't need to worry about it, but it's nice now to know what you need to do if that were to happen.
Setup
The initial setup of IRC networks and channels are done during the setup of indexers.
If you for some reason need to setup a network manually, or edit an existing one, you can do that in Settings > IRC.
Before setup, make sure you have generated the necessary keys. Some networks have invite commands with extra keys. Some require you to be registered with NickServ (see registering with NickServ). Trackers have documentation for the extra authentication protocols in their wiki pages.
- If NickServ Password is marked
*as required, then you need to have a registered account on that IRC network. See registering with NickServ above. - If NickServ Account is marked
*as required, that's only used as nick, but supports NickServ auth. - The invite command field in
Settings > IRC > Edit networkare pre filled, but you need to add your IRC key. The rest should be left as is.
Quite a few indexers use the same network, specifically irc.p2p-network.net.
- If you use the same nick with multiple indexers, it will reuse the same connection for them.
- If you have more than one nick on the same network in will create a new connection for each.
Adding or removing indexers/networks/channels can therefore break things.
Troubleshoot
If you have any issues with IRC not connecting or staying red then do the following:
- Go into
Settings -> Logsand set Level toTRACE - Go into
Settings -> IRCand either hit the enabled toggle or click the thre dots button press theRestartoption - Go to the
Logspage and look what it is doing
There will be a lot of info with Trace logs so you'll have to read carefully. NickServ and SASL errors are related to auth and could mean you have not registered when it's required, or put in the wrong info.
autobrr uses the Auth Mechanism SASL by default. Some networks does not support it and a change of Auth Mechanism to NickServ will generally fix it. Some does not require NickServ registration at all and then you can set it to None-
If you need some assistance then the best way to get help is Discord.
Bouncing around (optional)
This is meant for advanced users or those that need a single irc connection for certain networks or for those using multiple servers with multiple autobrr instances.
Due the current way of the release-parsing pipeline works, you may want to use a dedicated autobrr instance for your downloader. For this purpose, having a IRC bouncer in front will be beneficial, as it enables you to use the same irc-bot account for multiple autobrr instances. This still require you to have gone trough the above steps of setting up a bot account.
Setting up ZNC
This write-up will use the Linuxserver ZNC docker image.
---
version: "2.1"
services:
znc:
image: lscr.io/linuxserver/znc:latest
container_name: znc
environment:
- PUID=1000
- PGID=1000
- TZ=Etc/UTC
volumes:
- /path/to/data:/config
ports:
- 6501:6501
restart: unless-stopped
This example will get you a working baseline, there will be some tips to enable SSL further down.
Theres two ways to configure ZNC, straight in irc, or trough the webui, this write-up will use the webui where possible.
Consult the containers readme for up-to-date info on the current default credentials(at the time of writing it is admin/admin), use these to log in to the webui on port 6501. Go to "Your Settings" on the menu on the top left, as you will want to change the default password, you can also change the default irc nick here. Save by selecting "Save and continue", as you want to stay on this page for the next step.
Now you want to set up the networks, the exact settings varies, fortunately autobrr´s irc definitions holds all the information you want. The write-up will use the current (as of writing) definition for AR.
You want to set Network Name to something recognizable as it is the identifier you will use when connecting to this network in autobrr. Set Nickname, Alt. Nickname, Ident and Realname to the bot nickname.
Leave Active to true, this way ZNC automatically connects to the network once it starts up.
Next up you want to add the server for this network, under the Servers of this IRC network section. Read the definition for the server, port and tls settings needed. For the linked definition, this will be line 30, 31 and 32 respectively.
You may need to enable some modules for the network based on the networks setup. You usually need either the SASL or NickServ module. There is currently no way based on the definition to tell if a network supports SASL, so you might need to resort to NickServ. There is no reason to set up channels here, as autobrr will join the one specified in the definition (or send the private message needed), like it would without the bouncer.
Enabling SSL
While this is not required, it might be easier to get going than you think. This section is based on already having Linuxserver´s SWAG generating a certificate for znc.mydomain.com, while keeping all traffic between containers inside the same docker network.
There is two changes that need to be done to the compose example to allow this to work.
version: "2.1"
services:
znc:
volumes:
- /path-to-swag-config/etc:/swag-ssl
networks:
default:
aliases:
- znc.mydomain.com
This utilizes the documented way to share SWAGs certificates to other containers. To have DNS match, we tell docker to add a alias to the container using the domain we have a certificate for.
Before you apply this change, you also want to update the znc.conf in the persistent data of ZNC.
SSLCertFile = /swag-ssl/letsencrypt/live/<mydomain.com>/fullchain.pem
SSLDHParamFile = /swag-ssl/letsencrypt/live/<mydomain.com>/fullchain.pem
SSLKeyFile = /swag-ssl/letsencrypt/live/<mydomain.com>/privkey.pem
Prepare the network
While the SASL module offers a way to configure it in the webui, doing it over irc was easier, as you would need to do so for NickServ if SASL failed.
Connect to the network you set up in ZNC with your favorite client, like mentioned in the Prerequisites step. The IRC server is running on the same port as the webui in the default config for the Linuxserver image. For the username, use the bot nickname. The password tells ZNC which network you want to connect to, therefore it follows a preset syntax, there is some helper-text about this on the top of the network page in the webui. For this example it would be admin/AlphaRatio:admin.
Once connected to the ZNC network, you need to set up authentication.
SASL
You can set up SASL by telling it about your bot username and password.
/query *sasl Set <username> [<password>]
SASL is only negotiated on connection, so you need to tell ZNC to do a reconnect to the network.
/query *status jump
If you are still not authenticated with the bot username, you need to use NickServ.
NickServ
To tell the module about your password, you use almost the same command as with SASL
/query *nickserv set <password>
At this point you can disable/unload the module for the authentication method you are not using.
Using the bouncer in Autobrr
You tell autobrr to use the bouncer by toggling the Bouncer (BNC) switch in the IRC settings, this presents you with a field to enter the address of the bouncer, in HOST:PORT format, where host can be ip or a domain. You also need to to fill the password for the network with the same scheme(admin/AlphaRatio:admin) as you did when you connected your client to the bouncer.
Once you save these changes, you should now be able to confirm that the bouncer network is used, by looking at your network list in ZNC, it should now have increased the numbers of clients on the network.