This Repo contains Cardigann YML indexer definitions for Prowlarr.
For more information on the formatting of the YML Indexer Definition, please see our Prowlarr Cardigann YML Version / Definition wiki entry
To develop and test definitions, you may use the Custom Definition Folder
For Prowlarr Indexer Requests; please see our request forum on Discord
Note
With some differences and a few exceptions Prowlarr Cardigann Indexers are synced upstream with Jackett via the indexer-sync script in this repository. Syncs are automated daily via GitHub Actions, but can also be triggered manually. Any user may also pull request a manual sync.
Tip
For detailed instructions on syncing Jackett indexers, including script features, usage examples, and command-line options, see the Contributing Guide.
Important
Versions require Prowlarr Cardigann C# modifications. Prowlarr will fall back to a previous version if no YML exists for the current version.
Each Cardigann Version has a YML Schema for it contained within the definitions's respective folder named schema.json
For more specific details between versions the schema files can be compared.
To test a definition file against a specific schema use the command below.
Important
Python 3.11 or higher is required for validation scripts
# Setup (one time)
python -m venv .venv
# Activate virtual environment
# On Linux/Mac:
source .venv/bin/activate
# On Windows:
source .venv/Scripts/activate
pip install -r requirements.txt
# Validate all definitions (supports both Prowlarr versioned and Jackett flat structures)
python scripts/validate.py
# Validate specific directory
python scripts/validate.py /path/to/definitions
# Validate single file against schema
python scripts/validate.py --single "file.yml" "schema.json"
# Show only first error (default shows all errors)
python scripts/validate.py --first-error-only
# Find best schema version for a file
python scripts/validate.py --find-best-version "file.yml"
# Or use convenience script
./scripts/validate-python.sh
The validation script supports:
- Flexible directory structures: Works with Prowlarr's versioned directories (
v11/
) and Jackett's flat structure with rootschema.json
- All errors by default: Shows all validation issues at once instead of stopping at the first error
- Concise error messages: Clean output showing only validation type, schema path, and invalid values
- Auto-detection: Automatically detects directory structure and uses appropriate validation method
Note
The repository currently supports indexer definition schemas from v1 through v11. The active version is:
- V11 Indexers - Dev 1.20.0.4590 - ACTIVE
- Contains all active indexer definitions (522+ indexers)
- Prowlarr Cardigann v11 includes several changes such as:
- Predefined setting type:
info_category_8000
- Optional
selectorinputs
andgetselectorinputs
for login section - Extended language support with duplicated language codes
- Enhanced SelectorBlock validation with dependency rules
- Predefined setting type:
Warning
These versions are deprecated and no longer maintained
- V10 Indexers - Dev 1.18.0.4543
- All indexers migrated to v11 as of 2025-08-24
- Schema remains for historical reference
- No active indexer definitions
- Prowlarr Cardigann v10 included:
- Predefined settings type:
info_cookie
,info_flaresolverr
andinfo_useragent
- Enhanced login validation with conditional requirements
- Extended SelectorBlock functionality with type restrictions
- Predefined settings type:
- Prowlarr Cardigann v1 are base level standard YML
- No new indexers are to be added to v1 as of 2021-10-13
- No new updates backported to v1 as of 2021-10-17
- Prowlarr Cardigann v2 includes several changes such as:
- Regex removal for Size parsing
- Multiple Download Selectors
- Optional Selectors
- Testlink Torrents
- InfoHash links
- AllowRawSearch property in caps
Warning
No new indexers are to be added to v2 as of 2022-04-18 No new updates backported to v2 as of 2022-04-18
- Prowlarr Cardigann v3 includes support for APIs and JSON
- Replace
imdb:
selector withimdbid:
- Makes
Description
an optional by default - All new Indexers using APIs shall be in v3 as of 2021-10-21
- Indexers utilizing CategoryDescr or any v4 features MUST be in v4
- Prowlarr Cardigann v4 includes several changes such as:
- TMDBId
- Genre
- TraktID
- CategoryDescr
- Prowlarr Cardigann v5 includes several changes such as:
- Allow JSON Filters
- Prowlarr Cardigann v6 includes several changes such as:
doubanid
supporttmdbid
TV Search Support
- Prowlarr Cardigann v7 includes several changes such as:
Publisher
,Year
,Genre
, Query support
- Prowlarr Cardigann v8 includes several changes such as:
- HtmlEncode and HtmlDecode filters
- Prowlarr Cardigann v9 includes several changes such as:
- AllowEmptyInputs
- default values
- MissingAttributeEqualsNoResults