Skip to main content
Version: Latest

Filters

tip

You can easily convert your autodl-irssi filters into autobrr filters using our built-in conversion tool by going to Filters > ▼ button right next to "Create Filter" > Import Filter. Please note that not IRC channels and IRC networks will not be imported. You will have to do that manually yourself.

Most fields can take a comma separated list like value1, value2.

The comma separated lists supports wildcards, where * means 0 or more characters and ? means exactly one character. An example would be: *this*,that?movie. In this case we would match any title containing this (or tHiS) or in the second case, any title which matches exactly like That Movie or tHaT MoViE or even THAT.MOVIE.

If no value is specified in a field, then that field will match any/all possible values. That means if nothing but Filter Name and Indexers is given, then the filter it will match all/any releases for the specified indexers.

Please note that all filters are case-insensitive, so write them however you desire. Another thing to note is that it is not possible to escape wildcard fields.

info

If you want to match a string partially, then don't forget to use the * around the before/after/around what you're looking for. If you want to match a string exactly, then try to avoid the use of the * wildcard character.


General

FieldDescriptionDefault value
Filter nameThe name of this filter.
EnabledIs this filter active?false
IndexersWhich indexers should this filter work for?
Announce TypeSee Announce Type for more information.ALL

Announce Type

TypeDescriptionSupported By
NEWNewly uploaded releasesAll indexers
CHECKEDStaff verified/checked releasesPTP
PROMOPromotional releases (freeleech/neutral/half)PTP
PROMO_GPGolden Popcorn marked releasesPTP
RESURRECTEDReseeded/revived releasesPTP

Rules

About Size

Some indexers don't announce the size of a release, so autobrr will download the torrent file to get a size.
This check is only triggered if a minimum or a maximum size in that particular filter has been set.
For workflows that require an external size check for an external application set Min. size to 1.
To get around downloading every torrent file, some APIs for trackers that are problematic are implemented.

For TV and movies it's advised to use filters like resolution, source and codec
since these often have known approximate sizes.

FieldDescriptionDefault value
Min. sizeMinimum torrent size allowed. Supports units such as MB, MiB, GB, etc.
Max. sizeMaximum torrent size allowed. Supports units such as MB, MiB, GB, etc.
DelayNumber of seconds to wait before running actions.0
PriorityFilters are checked in order of priority. Positive and negative numbers allowed. Higher number = higher priority.0
Max downloadsNumber of max downloads as specified by the respective unit.0 (which means +Inf)
Max downloads perThe unit of time for counting the maximum downloads per filter.
Skip duplicates profileThe profile describing how to prevent duplicate downloads. See Skip Duplicates.None
info

If "Max downloads" is set, the filter will only match if you have downloaded fewer than "max downloads" items since the beginning of the "max downloads per" period. For instance, if you set "max downlods" to 3 and "max downloads per" to "day" the filter won't match unless you have downloaded fewer than 3 items since the beginning of the current day, in local time.