The --filter option is probably the the most powerful, yet least used option the CLI has to offer. As long as everything "just works" you will never need --filter but if you get mismatches then --filter will allow you to pass in arbitrary rules to help FileBot make the correct match. Plus, once you're familiar with format expressions you'll immediately get filter expressions.
The --filter expression allows you to control which episode or movie object is considered for matching. So if one show is confused with another due to bad naming or missing data you can simply exclude the bad one.

Examples:
If you only process recently aired episodes you could exclude any episode of any show that has been aired more than a few days ago, immediately eliminating any and all potential mismatches with similarly named TV Shows aired at different times.
Code: Select all
--filter "age < 7"
Code: Select all
--filter 'age < 7 || !model.any{ it.age < 7 }'
Code: Select all
--filter 'n != "Doctor Who"'
Code: Select all
--filter '!(n in lines("/path/to/excludes.txt"))'
Advanced Usage:
--filter expressions can be passed via external *.groovy files:
Code: Select all
--format /path/to/Filter.groovy

