Filter
Create one [filter] header per filter like [filter MY FILTER NAME]. All filter options are optional! If you don't use any filter options, then everything will be downloaded because your filter doesn't filter out anything.
Note: Not all filter options are supported on all trackers.
General¶
enabled¶
Type: Boolean
Default: true
Example: enabled = false
Description: Use it to disable a filter. All filters are enabled by default.
priority¶
Type: Integer
Default: 0
Example: priority = 10
Description: Use it to determine the order by which filters are checked. Negative numbers are allowed.
match-sites¶
Type: Comma separated list
Example: match-sites = tracker1, tracker2, tracker3
Description: It's compared against the tracker. Use the full tracker name, eg. MyTracker or use one of the tracker types found in ~/.irssi/scripts/AutodlIrssi/trackers/.tracker. Open one of the files and locate the **type="XYZ"* line. Use the value inside the quotes, eg. XYZ.
except-sites¶
Description: The exact opposite of match-sites. If a release matches this option, then it's NOT downloaded.
min-size¶
Type: Size
Example: min-size = 200MB
Default: 0
Description: Used to filter out too small torrents.
max-size¶
Type: Size
Example: max-size = 2.5GB
Default: any size is allowed
Description: Used to filter out too big torrents. Set it to a reasonable value, eg. for TV-shows, set it to about twice the size of a normal episode (just in case it's a double-episode).
upload-delay-secs¶
Type: Integer
Default: 0 (no wait)
Example: upload-delay-secs = 10
Description: The number of seconds autodl-irssi should wait before uploading/saving the torrent.
max-downloads¶
Type: Integer
Example: max-downloads = 15
Description: Download no more than this number of torrents per week/month (see max-downloads-per). Remove the filter option or set it to a negative number to disable it.
max-downloads-per¶
Type: String
Example: max-downloads-per = week
Description: Valid values are day, week, and month. See max-downloads.
download-duplicates¶
Type: Boolean
Default: false
Example: download-duplicates = true
Description: By default, it's false so no duplicate releases are downloaded. Set it to true if you want to download the same release if it's re-announced or announced by multiple trackers.
P2P¶
match-releases¶
Type: Comma separated list
Example: match-releases = The?Simpsons*, American?Dad*
Description: It's compared against the torrent name, eg. Some.release.720p.HDTV-GROUP. If the filter should only match TV-shows or movies, it's easier to use the shows filter option since it doesn't require wildcards.
except-releases¶
Description: The exact opposite of match-releases. If a release matches this option, then it's NOT downloaded.
use-regex¶
Type: Boolean
Default: false
Description: Changes match/except-releases filter options to use regex instead of wildcard syntax globally. This can also be set globally in the options header.
match-release-groups¶
Type: Comma separated list
Description: Unless the release matches one of the release groups, it's not downloaded.
except-release-groups¶
Type: Comma separated list
Description: Opposite of match-release-groups. If the release matches one of the release gorups, it's not downloaded.
max-pretime¶
Type: time-since string
Example: max-pretime = 2 mins 3 secs
Description: Some sites announce the pretime of the release. Use this to filter out old releases.
scene¶
Type: Boolean
Example: scene = true
Description: Some sites mark a release as scene or non-scene. Set it to true if you want only scene releases, false if you only want non-scene releases, or don't use this option if you don't care.
origins¶
Type: Comma separated list
Example: origins = P2P, Internal
Description: Some trackers set the origin of a release in a more fine-grained manner than scene/non-scene.
freeleech¶
Type: Boolean
Example: freeleech = true
Description: Only supported on a few trackers. Set to true if you only want to download freeleech releases. Set to false if you only want non-freeleech releases. Don't set if you don't care.
freeleech-percents¶
Type: Number list
Example: freeleech-percents = 50,75
Description: Some trackers have multiple levels of freeleech. Set a Number list representing the percentages (without the % sign) of the releases you want to download.
TV/Movies¶
shows¶
Type: Comma separated list
Example: shows = The Simpsons, American Dad
Description: This is for TV-shows and movies. autodl-irssi will automatically extract the TV-show/movie name from a scene release name. Example, The.Simpsons.S35E24.720p.HDTV-BLAH will match a shows option set to the simpsons. You don't need wildcards at all, though it's possible to use wildcards. It's recommended to use shows instead of match-releases if all you want is for the filter to match TV-shows or movies.
seasons¶
Type: Number list
Example: seasons = 1, 3, 5-10
Description: This is for TV-shows only. Unless the release matches one of the seasons, it's not downloaded.
episodes¶
Type: Number list
Example: episodes = 1, 3, 5-10
Description: This is for TV-shows only. Unless the release matches one of the episodes, it's not downloaded.
smart-episode¶
Type: Boolean
Default: false
Example: smart-episode = true
Description: Set to true to prevent downloading earlier episodes than your latest download. This option is set per filter, not per show, so it only makes sense to set one show per filter.
resolutions¶
Type: Comma separated list
Example: resolutions = SD, 720p, 1080p
Description: This is for TV-shows and movies only. Unless the release matches one of the resolutions, it's not downloaded. Valid resolutions are one or more of the following: SD, 480i, 480p, 576p, 720p, 810p, 1080i, 1080p.
encoders¶
Type: Comma separated list
Example: encoders = x264, xvid
Description: If you don't want windows WMV files, this option could be useful. :) Valid encoders are: XviD, DivX, x264, h.264 (or h264), mpeg2 (or mpeg-2), VC-1 (or VC1), WMV, Remux, h.264 Remux (or h264 Remux), VC-1 Remux (or VC1 Remux).
sources¶
Type: Comma separated list
Example: sources = HDTV, DVDRip, BluRay
Description: This is for TV-shows and movies only. Unless the release matches one of the sources, it's not downloaded. Valid sources are one or more of the following: DSR, PDTV, HDTV, HR.PDTV, HR.HDTV, DVDRip, DVDScr, BDr, BD5, BD9, BDRip, BRRip, DVDR, MDVDR, HDDVD, HDDVDRip, BluRay, WEB-DL, TVRip, CAM, R5, TELESYNC, TS, TELECINE, TC. TELESYNC and TS are synonyms (you don't need both). Same for TELECINE and TC.
containers¶
Type: Comma separated list
Example: containers = mkv, mp4
Description: Unless the release matches one of the containers, it's not downloaded.
years¶
Type: Number list
Example: years = 1999, 2005-2010
Description: Not all releases have a year in the torrent name, but if it does, you can use it to filter out too old or too new releases.
Music¶
years¶
Type: Number list
Example: years = 1999, 2005-2010
Description: Not all releases have a year in the torrent name, but if it does, you can use it to filter out too old or too new releases.
artists¶
Type: Comma separated list
Example: shows = Muse, Modest Mouse
Description: This is for artists/groups. You don't need wildcards at all, though it's possible to use wildcards.
albums¶
Type: Comma separated list
Example: albums = Some album, Some other album, yet another one
Description:
match-release-types¶
Type: Comma separated list
Example: match-release-types = Album,Single,EP
Description: Matches on the release type of the torrent.
except-release-types¶
Type: Comma separated list
Description: The exact opposite of match-release-types. When this matches, do NOT download the torrent.
formats¶
Type: Comma separated list
Example: formats = MP3, FLAC
Description: List the formats you want. Valid formats are: MP3, FLAC, Ogg, AAC, AC3, DTS.
bitrates¶
Type: Comma separated list
Example: bitrates = 192, V0 (vbr), lossless
Description: List the bitrates you want. Some example values: 192, 320, APS (VBR), V2 (VBR), V1 (VBR), APX (VBR), V0 (VBR), q8.x (VBR), Lossless, 24bit Lossless, Other.
media¶
Type: Comma separated list
Example: media = CD, WEB
Description: List the media you want. Valid media are: CD, DVD, Vinyl, Soundboard, SACD, DAT, Cassette, WEB, Other.
cue¶
Type: Boolean
Example: cue = true
Description: what.cd. Set it to true if you only want releases with a cue file, false if you don't want releases with cue files, or don't use this option if you don't care.
log¶
Type: Boolean
Example: log = true
Description: Set it to true if you only want releases with a log file, false if you don't want releases with log files, or don't use this option if you don't care.
log-scores¶
Type: Number list
Default: Any score allowed
Example: log-scores = 90-95,96,98,100
Description: Set the log scores of the releases you want to match.
Advanced¶
match-categories¶
Type: Comma separated list
Example: match-categories = MP3, TV/XVID
Description: It's compared against the torrent category.
except-categories¶
Description: The exact opposite of match-categories. If a release matches this option, then it's NOT downloaded.
match-uploaders¶
Type: Comma separated list
Example: match-uploaders = uploader1, uploader2
Description: Use it to only download from certain uploaders.
except-uploaders¶
Description: The exact opposite of match-uploaders. If a release matches this option, then it's NOT downloaded.
tags¶
Type: Comma separated list
Example: tags = hip hop, rock
Description: Unless at least one of your tags matches the release's tags, it's not downloaded. See also except-tags and tags-any.
except-tags¶
Type: Comma separated list
Example: except-tags = hip hop, rock
Description: Same as tags except if it matches any/all of these, it's not downloaded. See also tags and except-tags-any.
tags-any¶
Type: Boolean
Default: true
Example: tags-any = false
Description: Decides how to match the tags option, ie., if any or all of the tags must match.
except-tags-any¶
Type: Boolean
Default: true
Example: except-tags-any = true
Description: Decides how to match the except-tags option, ie., if any or all of the tags must match.