Version Guides

Rules:

"Rules" define the quality requirements of your versions. The rules can be either formulated as a requirement or as a preference. The first rule has the highest priority, the last one the lowest.

Text based rules:

Text based rule values are interpreted as regex definitions, are case-insensitive and use official regex syntax. check out regexr.com to try out your regex definitions, or visit our discord server to see how other people use versions.

Basic Regex Syntax:

Special Characters:

small list of typical special characters

.     - matches any character
*     - matches zero or more of the preceding character
+     - matches one or more of the preceding character
?     - matches zero or one of the preceding character 
|     - matches either the preceding or the following characters
()    - creates a group 
[0-9] - matches any number
\     - escapes a special character so it's interpreted as text

Typical uses:

(2160)(.*)(HDR)       - matches "2160", followed by "anything", followed by "HDR"
(EXTENDED|REMASTERED) - matches either "EXTENDED" or "REMASTERED"
(H?D?.?CAM)           - matches "HD-CAM", "HDCAM", "HD.CAM", "CAM", ...
(S[0-9]+E[0-9]+)      - matches "S", followed by "one or more numbers", followed by "E", followed by "one or more numbers"

Advanced Regex Syntax:

Conditional Regex:

Conditional regex definitions allow you to use if-else statements inside your version rules.

(?(?=(regex-rule))(regex-if-true)|(regex-if-false))

Triggers:

"Triggers" define when plex_debrid should look for a version. You can add triggers that limit a version to a specific media type, or to specific movies/shows. You can define how many times plex_debrid should attempt to download a version and how many attempts should be made with other versions, before a version is attempted to be downloaded. Other triggers can limit a version to a specific genre or can limit a version to a specific user that requested the movie/show.