All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

• Sync: except_patterns option for reset_unmatched_scores to exclude custom formats by regex pattern (#235)

• CLI: Show default/optional status for quality profiles in list custom-format-groups --details (#725)

• Sync: Unnecessary warning when explicitly selecting default custom formats in CF groups
• Sync: Media naming status always showed as skipped for Radarr instances (#751)

• CLI: --details flag for list custom-format-groups to show member CFs and their required/default/optional status
• Sync: select_all option for custom format groups to include all CFs regardless of default status (#722)

• Sync: Custom formats and quality profiles that already exist in the service are now automatically replaced by Recyclarr. The state repair --adopt workflow is no longer needed.
• Docker: The latest tag is no longer published to Docker Hub or GHCR. Use a major version tag (e.g. 8) instead to receive updates within a major version.

• CLI: The state repair command is deprecated and will be removed in a future release. Sync now handles all state reconciliation automatically.

• Sync: Unmatched trash_ids in custom_format_groups.skip silently ignored instead of warning
• Migrate: Cache-to-state migration failure on cross-filesystem moves (e.g. Docker volume mounts)

• Sync: Default CF groups now apply to all profile variants sharing the same trash_id (#735)
• Sync: CF group assign_scores_to now accepts profile names for guide-backed profiles, enabling selective assignment to specific profile variants (#734)

• CLI: State repair crash when multiple quality profiles share the same trash_id.

• Sync: The same guide-backed quality profile trash_id can now be used multiple times with different names, allowing variations of the same profile on a single instance.

• Config: Empty YAML nodes (e.g. custom_formats: with all entries commented out) are now treated as no-ops instead of validation errors.
• CLI: RECYCLARR_APP_DATA deprecation message is now displayed cleanly instead of being buried in a stack trace.
• Config: YAML errors now show specific, actionable messages instead of generic "Exception at line" text (#728).
• Sync: CF group assign_scores_to with name no longer requires the profile to be in quality_profiles (#726).
• Sync: Quality profile names are now updated when the config or guide name differs from the service (#729).

• Config: Removed properties like replace_existing_custom_formats now produce a deprecation warning instead of silently preventing sync.
• Config: Using the same quality profile trash_id multiple times now produces a validation error instead of silently corrupting sync state.
• Sync: assign_scores_to with trash_id no longer requires the target profile to be in the CF group's include list (#726).

• CLI: list custom-format-groups now shows the contents of each group and supports filtering by name (#720).
• CLI: list quality-profiles now supports --details to show included custom formats and --filter to search by name.

• Notifications: Empty sync results (all zeros, no errors) no longer trigger notifications in normal mode.
• Sync: Overriding custom format scores from guide-backed profiles no longer produces a spurious warning in sync diagnostics.

• Custom Formats: CF group assign_scores_to now accepts name to target custom (non-guide-backed) quality profiles, in addition to the existing trash_id for guide-backed profiles.
• Sync: exclude option for custom format groups to opt out of specific default custom formats.

• Custom Formats: Adding a CF group where all custom formats are optional no longer silently produces nothing; a warning is now shown advising to use select.
• Sync: Diagnostic messages (errors, warnings, deprecations) were invisible when using --log, including the state repair --adopt suggestion for quality profile conflicts.
• Config: Helpful migration messages for removed config properties (e.g. replace_existing_custom_formats, quality_profiles) were never shown due to an internal wiring mistake.
• Config: YAML parsing errors (unknown properties, bad values) were silently swallowed, causing sync to produce no output instead of reporting the problem.

• Sync: select in custom format groups now adds non-default custom formats alongside defaults, instead of replacing them. Use exclude to remove unwanted defaults.

• CLI: The migrate command is deprecated. Migrations now run automatically at startup.

• State Repair: Quality profiles with a config name override were not matched to service profiles during state repair --adopt
• Sync: assign_scores_to with trash_id instead of name failed to resolve to the correct quality profile
• Sync: Crash when previewing quality profiles or quality sizes with square brackets in names

This release contains BREAKING CHANGES. See the v8.0 Upgrade Guide for required changes you may need to make.

• Media Management: New media_management configuration section with propers_and_repacks setting to control how Sonarr/Radarr handles Propers and Repacks (#225).
• Quality Profiles: Support for trash_id to sync TRaSH Guide quality profile definitions. When specified, qualities, custom formats, scores, and language are automatically configured from the guide, significantly reducing YAML complexity.
• Custom Formats: Support for custom_format_groups to sync TRaSH Guide CF groups. Groups marked default: true are automatically synced when using a guide-backed quality profile. Use custom_format_groups.skip to opt-out or custom_format_groups.add to opt-in to non-default groups.
• Custom Formats: assign_scores_to now accepts trash_id as an alternative to name for referencing guide-backed quality profiles (#251).
• Settings: Local resource providers now support relative paths, resolved against the app data directory.
• CLI: New --log [level] option for explicit log output control. Valid levels: debug, info (default), warn.
• CLI: New state repair command to rebuild cache mappings by matching configured resources (custom formats, quality profiles) to service resources by name.
• CLI: New list custom-format-groups command to discover available CF group trash_ids.
• CLI: New list score-sets command to list available score sets for custom formats.
• CLI: New list quality-profiles command to discover available quality profile trash_ids.
• CLI: New --raw option for list commands outputs TSV format for scripting.
• Sync: Unified diagnostics panel displayed at end of sync, consolidating all errors and warnings.
• Sync: Live progress display showing real-time status of all instances and pipelines during sync.
• Settings: Git resource providers now support both main and master as default branches.
• Config: New RECYCLARR_CONFIG_DIR environment variable for user configuration directory.
• Config: New RECYCLARR_DATA_DIR environment variable for ephemeral data (resources, logs), enabling backup separation from user configuration (#699).

• CLI: BREAKING List commands now display formatted tables instead of plain text. Use --raw for the previous behavior (now TSV format for scripting).
• CLI: BREAKING The global --raw option has been removed. It is now specific to list commands.
• CLI: BREAKING The --score-sets option on list custom-formats has been removed. Use list score-sets instead.
• Sync: Simplified custom format matching logic. Cached IDs are now trusted over name matching, reducing complexity and resolving edge cases like multiple CFs with case-variant names (#672).
• Sync: Preview mode now shows instance name in section headers and a visual separator between instances, making multi-instance output easier to navigate.
• Custom Formats: Preview now displays a table with action, name, and trash ID columns instead of log-style output.
• Quality Sizes: Preview now only displays items that will be changed.

• Config: BREAKING The replace_existing_custom_formats option has been removed. Use recyclarr state repair --adopt to adopt manually-created custom formats.
• Config: BREAKING The deprecated quality_profiles element under custom_formats has been removed.
• Config: BREAKING Include templates in the configs directory are no longer supported. Move include files to the includes directory.
• Settings: BREAKING The deprecated repositories setting has been removed. Use resource_providers instead.
• Migrate: BREAKING macOS users upgrading from versions prior to v6.0 must manually move app data from ~/.config/recyclarr to ~/Library/Application Support/recyclarr.
• CLI: BREAKING The --app-data option has been removed. Use RECYCLARR_CONFIG_DIR environment variable instead.
• Config: BREAKING The RECYCLARR_APP_DATA environment variable has been removed. Use RECYCLARR_CONFIG_DIR instead.

• CLI: delete custom-formats command failed when config used include templates.
• CLI: config create --template incorrectly logged "Replacing existing file" when creating new files.

• Installation: Homebrew is now supported on macOS and Linux. See the installation docs for details.

• Sync: Crash when using --preview flag after rendering quality sizes table.
• Sync: Custom formats being updated on every run even when unchanged.

• Quality Profiles: The min_upgrade_format_score property now works correctly. The YAML property was renamed from min_format_upgrade_score to match the Sonarr/Radarr API naming convention.

• Quality Definitions: Per-quality size overrides allow setting explicit min, max, and preferred values for individual qualities, with support for unlimited keyword (#253).
• YAML: New !file tag that allows including the contents of an external file as a YAML node value, particularly useful for working with Docker Secrets (#278).
• Settings: New resource_providers configuration enables custom data sources for TRaSH Guides and config templates (#238).
• Quality Profiles: Support for min_format_upgrade_score to control minimum custom format score required for upgrading already-downloaded releases (contributed by @beschoenen in #503).

• Settings: repositories configuration is deprecated in favor of resource_providers.

• Sync: Custom format includeCustomFormatWhenRenaming property now deserializes correctly from TRaSH Guides JSON files (#213).
• Sync: Crash during quality profile and quality size operations.
• Cache: Remove duplicate custom format ID mappings during cache cleanup to prevent downstream transaction processing issues.
• YAML: Improved messaging in logs and console output for YAML errors.
• CLI: Respect the NO_COLOR environment variable when piping command output to files (#462).

• Improved error handling in YAML configuration as well as how those errors are rendered to console output. (#396)

• Cutoff is no longer modified on implicitly referenced quality profiles (those that are specified in assign_scores_to but not under quality_profiles) (#417)

• Notifications: New verbosity setting for Notifications to control the frequency and content of notifications sent after sync operations (#354).

• Repositories: Show a warning when there's a git fetch failure (#355).

• Notifications support through Apprise

• A DependencyResolutionException is no longer raised in some commands (e.g. list) (#352).

• Custom Formats: Smarter change detection logic for custom formats with language specifications, which addresses the issue of some CFs constantly showing as updated during sync even if they didn't change.

• Performance: Reduced the number of API calls to obtain service version information.

• Custom Format: The error "CF field of type False is not supported" no longer occurs when syncing some language-specific custom formats (#318).

• Quality Definition: Support new quality upper limits for Sonarr (1000) and Radarr (2000). This is a backward compatible change, so older versions of Sonarr and Radarr will continue to use the correct upper limits.

• Quality Definition: Eliminated continuous syncing when no changes are present due to Radarr's adjustment of the upper limit for "Preferred" from 395 to 399.

• The node quality_profiles under custom_formats was renamed to assign_scores_to to disambiguate it from the top-level quality_profiles. The old name is deprecated until the next major release. See the upgrade guide for details.
• Quality Definition: Improved information about sync result in console output.

• Incorrect URLs were fixed in the local starter config template.
• Quality Definition: Preferred quality setting would not sync in certain situations (#301).

• The --app-data option is now common to all commands.

• CLI: Commands no longer crash due to a null app data directory variable (#288).

• Sync: In rare circumstances outside of Recyclarr, quality profiles become invalid due to missing required qualities. When this happens, users are not even able to save the profile using the Sonarr or Radarr UI. Recyclarr now detects this situation and automatically repairs the quality profile by re-adding these missing qualities for users. See this issue.

• CLI: Signal interrupt support for all API calls. Now when you press CTRL+C to gracefully exit/cancel Recyclarr, it will bail out of any ongoing API calls.
• CLI: The --app-data option works again (#284).

This release contains BREAKING CHANGES. See the v7.0 Upgrade Guide for required changes you may need to make.

• YAML: New includes subdirectory intended to hold only include templates. Relative paths specified in the config include directive are resolved starting at this new directory. Relative paths to include templates located under the configs directory is now DEPRECATED. See the "File Structure" page on the wiki for more details.
• Support the NO_COLOR environment variable for all Recyclarr commands (#223).

• BREAKING: The app data directory on OSX has changed. It now lives at ~/Library/Application Support/recyclarr instead of ~/.config/recyclarr. Users will need to run recyclarr migrate to move the directory (or do it manually).
• BREAKING: Removed support for Release Profiles and Sonarr version 3. The new minimum required version for Sonarr is v4.0.0.
• CLI: Slightly improved display of version number when using -v option.
• CLI: Greatly improved the layout of and information in the local starter YAML configuration that Recyclarr generates with the recyclarr config create command.

• YAML: Print more useful diagnostics when there's a connectivity problem to a service (e.g. incorrect base_url).
• YAML: Regression that prevented basic validation of base_url & api_key.
• CLI: CFs with no Trash ID will no longer be displayed when running the list custom-formats command (#229).
• Docker: Support running the container in read-only mode (#231).
• Sync: Sometimes CFs weren't deleted even with delete_old_custom_formats enabled (#237).

• CLI: Some custom formats were not properly categorized when running list custom-formats.
• CLI: Continue processing other instances when ServiceIncompatibilityException is thrown.
• Media Naming: In order to avoid confusion, the v3 and v4 version indicators for certain naming format keys has been moved to their own column in the list command table.

• Media Naming: Sync file naming configuration even if rename is not set to true.
• Quality Profiles: Validation check added for quality groups with less than 2 qualities.
• Quality Profiles: Fix "Groups must contain multiple qualities" sync error.
• Quality Profiles: Fix "Must contain all qualities" sync error.

This release contains BREAKING CHANGES. See the v6.0 Upgrade Guide for required changes you may need to make.

• Added Naming Sync (Media Management) for Sonarr v3, Sonarr v4, and Radarr (#179).
• A list naming command to show Sonarr and Radarr naming formats available from the guide.

• BREAKING: Minimum required Sonarr version increased to 3.0.9.1549 (Previous minimum version was 3.0.4.1098).
• BREAKING: Old boolean syntax for reset_unmatched_scores is no longer supported.

• Status text rendered during git repo updates is no longer shown when --raw is used with the list custom-formats command (#215).

• Remove INF log that showed a total count of CFs without scores assigned. This log caused a lot of confusion in support channels. You can still see a list of CFs without scores in the debug logs.
• Relaxed validation rules for trash_ids and quality_profiles under custom_formats. Both of these nodes may now be empty. This is mostly to make commenting out parts of configuration templates easier.
• The merge operation for custom_formats is now "Join" (previously "Add"). If, for the same profile, you "reassign" a different score to a CF, the score now gets updated without having to remove the CF from custom_formats sections in included YAML files.

• Print error information about HTTP 401 instead of "Unable to determine".
• Improved wording of remote service error messages.

• qualities (inside quality_profiles) is now a "Replace" merge operation instead of "Add". This means only one YAML file manages the full list of qualities. Either an include does it, or you override the full list in your configuration file. There is no longer any combination. See the docs for more details.

• If the guide data for "Include Custom Format when Renaming" is set to "true", it now syncs that correctly instead of always setting to "false" (#213).

• Print date & time log at the end of each completed instance sync (#165).
• Add status indicator when cloning or updating git repos.
• YAML includes are now supported (#175) (docs).
• New --include option added to config list templates to show a list of include templates for each service type (docs).

• Less-verbose console logging for scoreless custom formats.
• Git repository updates are now parallelized.
• Individual updated, created, and deleted CF logs are now debug severity. This makes the console output less verbose when syncing custom formats.

• Service failures (e.g. HTTP 500) no longer cause exceptions (#206).
• Error out when duplicate instance names are used.
• Print score instead of object in duplicate score detection warning

• Crash when doing recyclarr sync with no reset_unmatched_scores present.

• New delete command added for deleting one, many, or all custom formats from Radarr or Sonarr.
• Exclusions are now supported under reset_unmatched_scores. This is used to prevent score resets to specific custom formats. See the docs for more info.
• New score_set property available to each profile defined under the top-level quality_profiles list. This allows different kinds of pre-defined scores to be chosen from the guide, without having to explicitly override scores in your YAML.
• New --score-sets option added to list custom-formats which lists all score sets that CFs are a member of, instead of the CFs themselves.
• New --raw option added to list custom-formats which omits boilerplate output and formatting. Useful for scripting.

• Program now exits when invalid instances are specified.
• Scores are now pulled from the trash_scores object in the guide's CF json files.

• reset_unmatched_scores has a new syntax. The old syntax has been deprecated.

• If multiple configuration files refer to the same base_url (i.e. the same instance), this is now an error and the program will exit. To use multiple config templates against a single instance of Radarr or Sonarr, you need to manually merge those config files. See this page.

• Reduce the time it takes to clone the config and trash repositories by performing shallow clones (#201).

• Better error message to console when no configuration files are found.
• Allow quality group names to duplicate quality names (#200).

• base_url and api_key are now optional. These can be implicitly set via secrets that follow a naming convention. See the Secrets reference page on the wiki for details.
• Quality Profiles can now be created & synced to Radarr, Sonarr v3, and Sonarr v4 (#144).

• Better error messages for manually-specified, non-existent config files.
• More detail in error messages when Radarr/Sonarr API calls respond with HTTP 400 "Bad Data".

• Resolved error during exception message formatting that occurred in some cases (#192).

• Clone config template repo when config create -t is used.
• Fix error when completely commenting out a YAML configuration file (#190).

• Migration step added to delete old repo directory. Run recyclarr migrate to use.

• Update default clone URL for trash guides repo to new URL: https://github.com/TRaSH-Guides/Guides.git.

• When using sync, continue processing other instances when there's a failure.
• Regression: Perform Sonarr compatibility checks again (#189).

• Commenting/uncommenting CFs in configuration YAML no longer causes duplicate CF warnings when replace_existing_custom_formats is omitted or set to false (better caching logic).

• Recyclarr will now continue if git fetch fails for any repos, so long as there is an existing, valid clone to use.

• Address regression causing reset_unmatched_scores: false to not be respected.
• Do not show deleted custom formats in console output when delete_old_custom_formats is set to false.

This release contains BREAKING CHANGES. See the v5.0 Upgrade Guide for required changes you may need to make.

• The *.yaml extension is now accepted for all YAML files (e.g. settings.yaml, recyclarr.yaml) in addition to *.yml (which was already supported).
• New --template option added to config create which facilitates creating new configuration files from the configuration template repository.
• New --force option added to the config create command. This will overwrite existing configuration files, if they exist.

• API Key is now sent via the X-Api-Key header instead of the apikey query parameter. This lessens the need to redact information in the console.
• BREAKING: replace_existing_custom_formats now defaults to false.
• BREAKING: Restructured repository settings.
• Configuration templates repository moved to recyclarr/config-templates on GitHub. Corresponding settings for this repo as well (see the Settings YAML Reference on the wiki for more details).

• BREAKING: Array-style instances are no longer supported.
• BREAKING: Remove deprecated CLI commands: radarr, sonarr, and create-config.
• BREAKING: Removed reset_unmatched_scores support under quality profile score section.
• BREAKING: Migration steps that dealt with the old trash.yml have been removed.

• False-positive duplicate score warnings no longer occur when doing sync --preview for the first time.

• Fixed JSON parsing issue that sometimes occurs when pulling custom formats from Radarr (#178).
• Use correct wiki link in settings.yml template.

• New replace_existing_custom_formats property that can be set to false to disallow updates to existing CFs that Recyclarr never created in the first place. The default is true.
• New quality_profiles section supported for specifying information about quality profiles. For now, this section doesn't do much, but paves the way for quality profile syncing.
• New CLI command: config list which lists information about local and template config files.

• Log files are restructured. They are now under logs/cli.
• Log files are split. There is now a verbose.log and debug.log for every run. The time stamps (in the file name) between the two will be identical.

• replace_existing_custom_formats must be explicitly specified, otherwise you will get a deprecation warning. In a future release, the default will change from true to false. To prepare for that, users must explicitly state what behavior they want to avoid unwanted behavior in the future. Read more on the upgrade guide.
• reset_unmatched_scores is being moved to the quality_profiles section; a deprecation message will be logged until it is moved. Read more on the upgrade guide.

• Deleted custom formats are now included in the log message showing the count of CFs synced.
• An error will now be presented if an invalid option is specified on the CLI.
• Compressed builds are now enabled on MacOS. This means the executable size will be smaller.

• Environment variables may now be used in YAML configuration (#145).

• Exception when there's not configuration for both Sonarr and Radarr together.

• New list subcommand for listing information from the guide.
• New sync command for syncing all services, specific service types, and/or specific instances.
• New config subcommand for performing configuration-specific operations.

• The CLI has been completely redesigned to be more consistent and structured (#142).
• Improved preview output for quality sizes, custom formats, and release profiles.

• The create-config subcommand is deprecated and replaced by config create.
• The sonarr subcommand is deprecated and replaced by sync sonarr.
• The radarr subcommand is deprecated and replaced by sync radarr.

• Do not print skipped custom formats to console (they are too verbose). If you still want to see what was skipped, check the log file for additional debug logs.

• More scenarios were causing custom formats to sometimes not be synced (#160).

• Remove unredacted request URI from log files on exception.
• Scores/Custom Formats would not sync under certain conditions (#160).

• More robust configuration validation logic. You may notice new configuration errors that were not there before.

• Custom Formats: Updates that conflict with existing CFs in Sonarr/Radarr are now skipped and a warning is printed.
• When changing instance URLs, use new cache data to avoid mismatched custom formats on next sync.

• Better visual separation between processed instances in console output. (#146)
• More information about deleted, skipped, updated, and created CFs in console output. (#159)

• Category headers in --list-custom-formats output is now formatted as a YAML comment that can be copied with the list of Trash IDs.

• Sort CFs alphabetically in --list-custom-formats

• Releases now retain executable permissions on Linux and macOS.
• Sonarr: Do not modify or delete release profiles when using --preview

• Docker: Explicit init is no longer required in Docker Compose. It is now built into the image.
• Reduced size of the recyclarr executable
• macOS & linux are now released as tar.xz archives instead of zip.

• Fix CoreCLR / "killed" crash on Apple macOS platforms (#39). This was accomplished by properly signing and notarizing Recyclarr and disabling compression.

This release contains BREAKING CHANGES. See the v4.0 Upgrade Guide for required changes you need to make.

• BREAKING: Sonarr quality_definition configuration updated to address unexpected changes in Sonarr v4 that caused it to stop working. See upgrade guide for details.
• Default for preferred_ratio changed from 1.0 to using the values from the guide.

• BREAKING: Sonarr's hybrid quality definition removed.

• Do not warn about empty configuration YAML files when they aren't really empty.

• Improved logging: theme changes, better exception handling, more detail written to log files.
• Print instance name instead of URL in more places.
• Configuration parsing is more forgiving about errors:
  • If there's a YAML syntax error, skip the file but continue.
  • If there's a validation error, skip only that instance (not the whole file).

• Empty configuration files are skipped if they are empty (warning is printed).

This release contains BREAKING CHANGES. See the v3.0 Upgrade Guide for required changes you need to make.

• New configs subdirectory. Place your *.yml config files here and all of them will be automatically loaded, as if you provided multiple paths to --config. The primary purpose of this feature is to support multiple configuration files in Docker. See the docs
• Secrets support. You can now store sensitive information from your configuration YAML such as api_key and base_url in a secrets.yml file. See the secrets docs for more info. Huge thanks to @voltron4lyfe for this one. (#105, #139)
• Named instances are now supported in configuration YAML.
• New optional setting repository.git_path may be used to specify the path to a git executable. If not used, PATH will be searched.
• Docker: New RECYCLARR_CREATE_CONFIG environment variable which, if set to true, will automatically create /config/recyclarr.yml on container start up. Default is false.

• BREAKING: Recyclarr now requires git to be installed on host systems when using manual installation. If using Docker, there is no breaking change since git will be bundled with the image.
• Deprecated array-style instances in configuration YAML. Read more about this in the v3.0 Upgrade Guide.

• BREAKING: Completely removed support for names under custom_formats in recyclarr.yml. Note that this had already been deprecated for quite some time.
• BREAKING: The deprecated feature that still allowed you to keep your recyclarr.yml next to the executable has been removed.

• Sonarr: Run validation on Custom Formats configuration, if specified, to check for errors.
• Added more instructions, fixed broken links, and simplified the way you uncomment optional parts of the YAML in the starter recyclarr.yml template generated by the create-config subcommand.

• Sonarr: Incorrect VersionException occurred when using mixed versions of Sonarr (v4 & v3)

• For both Sonarr and Radarr, the custom formats in the output of --list-custom-formats are now grouped by their category, as determined by the tables at the top of the "Collection of custom formats" pages in the guide for each service.
• Recyclarr's Docker image is now available on Docker Hub!

• Docker: PUID and PGID no longer cause a failure on container start up.

• Use compact JSON for HTTP request/response body in debug log files. This makes logs much easier to scroll through.
• Sonarr: Run version enforcement logic when using CFs instead of RPs.
• A warning is now displayed when the same custom format is assigned multiple times to the same quality profile.

• Settings: New log_janitor setting that allows you to specify how many log files are kept when cleaning up (deleting) old log files. See the Settings Reference wiki page for more details. (#91)
• Sonarr: Custom Formats can now be synced to Version 4.

• Docker: Fix /config permissions when not using bind-mount for the volume. (#111)
• Sonarr: Error message is printed when attempting to use release profiles with Sonarr v4. (#100)

• Several vulnerabilities addressed (Thanks to @snoopy82481): CVE-2018-8292, CVE-2019-0980, CVE-2019-0981, CVE-2019-0820, CVE-2019-0657. (#112)

• Radarr: Custom formats were always showing up as changed in the logs (#109)

• New --list-qualities argument for sonarr and radarr subcommands that may be used to get a list of quality definition types from the guide.

• Quality definition data is now pulled from JSON files.

• Use the new paths for custom format and release profile JSON files in the guide.

• Radarr: New --list-custom-formats CLI option for getting a flat list of all CFs in the guide in YAML format, ready to copy & paste.
• Docker: New edge tag for experimental and potentially unstable builds on master. Includes both the latest Docker and Recyclarr changes to allow users to try them out before an official release.
• Settings: New branch and sha1 Repository settings. (#27)

• JSON Schema added to the config template YAML file.
• names list under custom_formats in config YAML is now deprecated. Use trash_ids to list your custom formats instead.
• Docker: The image is now rootless. The PUID and PGID environment variables are no longer used. See the Docker wiki page for more details.

• Docker: Resolved errors related to /tmp/.net directory not existing.
• An exception that says "Cannot write to a closed TextWriter" would sometimes occur at the end of running a command.
• Sonarr: Validate the TRaSH Guide data better to avoid uploading bad/empty data to Sonarr.

• Radarr: Reword the warning about missing scores for CFs to make it more clear that having no score does not prevent CFs from being synced.

• Do not exit when a YAML config has no sonarr or radarr section.
• Sonarr: Invalid release profile JSON files no longer cause the program to exit. Instead, it just skips them and prints a warning to the user. (#87)
• Radarr: Do not crash when quality_profiles is empty. (#89)
• Settings: Use repo URL after initial clone (#90)

• Docker support! Image name is ghcr.io/recyclarr/recyclarr. See the Docker wiki page for more information.
• Global app data path support via environment variable named RECYCLARR_APP_DATA. The path specified here will be used as the app data path for every invocation of recyclarr as if --app-data were specified.

• Renamed the "EVO (no WEB-DL)" custom format to "EVO (no WEBDL)" in the config template. (#77)
• Radarr: delete_old_custom_formats works again. (#71)
• The create-config subcommand now accepts YAML files again (it was taking a directory before, which was wrong).

• create-config would fail with --path specified.
• migrate no longer fails if the cache directory does not exist.

• Exception when running create-config command.

• New --app-data option for overriding the location of the application data directory.
• New migrate subcommand which may be used to perform migration steps manually.

• The default location for the default YAML file (recyclarr.yml) has been changed to the application data directory. This is the same location of the settings.yml file.
• Automatic migration has been removed. Instead, the migrate subcommand should be used.

• The recyclarr.yml file should no longer be located adjacent to the recyclarr executable.

• Version information in help output has been fixed.
• If a HOME directory is not available, throw an error to the user (use --app-data instead).
• Create $HOME/.config (on Linux) if it does not exist.
• Smarter migration logic in the trash-updater migration step that does a directory merge instead of a straight move. This is designed to fail less in cases such as recyclarr directory already existing.

• Sonarr: Fix unexpected missing terms when using filters. (#69)

• Sonarr: strict_negative_scores works again (broke in v2.0 release)

This release contains BREAKING CHANGES. See the Upgrade Guide for required changes you need to make.

• BREAKING: Sonarr Release profiles are now synced based on a "Trash ID" taken from the sonarr JSON files. This breaks existing trash.yml and manual changes are required.
• Do not follow HTTP redirects and instead issue a warning to the user that they are potentially using the wrong URL.
• Radarr: Sanitize URLs in HTTP exception messages (#17).
• Sonarr: Release profiles starting with [Trash] but are not specified in the config are deleted.

• Linux MUSL builds for arm, arm64, and x64. Main target for this was supporting Alpine Linux in Docker.
• Sonarr: Ability to include or exclude specific optional Required, Ignored, or Preferred terms in release profiles.
• Sonarr: New --list-release-profiles command line option which can be used to quickly and conveniently get a list of release profiles (and their Trash IDs) so you know what to add in your YAML config under release_profiles.
• Sonarr: New --list-terms command line option which can be used get a list of terms for a release profile. These lists of terms can be used to include or exclude specific optionals, for example.
• Migration System that is responsible for performing one-time upgrade tasks as needed.

• Sonarr: Error when syncing optionals release profile with the IncludeOptionals filter setting set to false.

• Unrecognized or unwanted YAML properties in configuration YAML (trash.yml) now result in an error. This is to help users more easily identify mistakes.

• Sonarr: Optionals release profile is now properly synced

• 64-bit ARM builds for Windows, Linux, and Mac OS.
• 32-bit ARM build for Linux.

• New settings file to control non-service specific behavior of Trash Updater. See the documentation for more information.
• Trash git repository URL can be overridden in settings.
• Schema added for settings.yml.
• Add setting to bypass HTTPS certificate validation (useful for self-signed certificates used with Sonarr and Radarr instances) (#20).
• A progress bar that is visible when pulling down Custom Formats (Radarr Only).

• Remove System.Reactive.xml from the published ZIP files.
• Fix exception that may occur at startup.
• Sometimes the "Requesting and parsing guide markdown" step would appear stuck and fail after several minutes. Many changes have been made to try to alleviate this.

• Sonarr version check failed when instances were slow to respond or there was high latency.

• Fix "free-quota limit" exception that occurred in new JSON schema generation logic that was added for API backward compatibility with Sonarr.

• libgit2sharp PDB is no longer required with trash.exe on Windows (#15)
• Unexpected character error due to breaking change in Sonarr API (#16)

• Fix "assembly not found" error on startup related to LibGit2Sharp (Windows only). Note that this introduces an additional file in the released ZIP files named git2-6777db8.pdb. This file must be next to trash.exe. In the future, I plan to have this extra file removed so it's just a single executable again, but it will take some time.

• Directly use the Trash Guides git repository to avoid getting HTTP 403 - rate limit reached error in github.

• Sonarr: Use new URL for release profile guide.
• Sonarr: Use new URL for quality definition guide.
• Radarr: Use new URL for quality definition guide.

• New setting reset_unmatched_scores under custom_formats.quality_profiles in YAML config which allows Trash Updater to set scores to 0 if they were not in the list of custom format names or listed but had no score applied (e.g. no score in guide).

• Support the new custom format structure in the guide: JSON files are parsed directly now. Trash Updater no longer parses the markdown file.

• Support trash_score property in Custom Format JSON from the guide. This property is optional and takes precedence over a score mentioned in the guide markdown.

• Custom formats can now be specified by Trash ID. This is useful for situations where two or more custom formats in the guide have the same name (e.g. 'DoVi').
• Debug-level logs are now written to file in addition to the Info-level logs in console output.

• An issue with radarr --preview that caused duplicate output when updating a second instance has been fixed.

• Fixed using incorrect URL for Sonarr

• Invalid cache data files no longer cause the program to exit. An error is printed and the application continues as if there was no cache at all.
• Fix a bug that resulted in certain custom formats not having their scores set in quality profiles.
• Fixed an issue where multiple instance configuration was not working.

• The log message listing custom formats without scores in the guide now prints information one per line (improved readability)
• Duplicate custom formats in the guide now issue a warning and get skipped.
• Do not invoke the Radarr API to update a quality profile if there are no updated scores inside it.

• Radarr Custom Format Support.

• Sonarr Quality Definition Max, when set to its maximum value of 400, is now properly set to "Unlimited". This is equivalent to the user maxing out the visual slider in the Sonarr UI. Without this, some larger sized releases were unintentionally rejected.

• Fix exception that occurred when running the create-config subcommand.

• Executable is now compiled using Ready to Run. This substantially increases the size of the executable but makes the code much faster.

• Radarr Quality Definition Max and Preferred, when set to their maximum values, are now properly set to "Unlimited". Without this, larger sized releases were unintentionally rejected.

• New configuration for Sonarr release profiles that allows all optional terms to be synced. Look for filter in the Configuration Reference for more details.

• New create-config subcommand to create a starter YAML config file

• Optional terms in the release profile guides are no longer synchronized to Sonarr.

• A warning is now logged when we find a number in brackets (such as [100]) without the word score before it. This represents a potential score and bug in the guide itself.
• Release profile guide parser now skips certain lines to avoid false positives:
  • Skip lines with leading whitespace (i.e. indented lines).
  • Skip admonition lines (lines starting with !!! or ???).

See the Python Migration Guide for details on how to update your YAML configuration.

• Full rewrite of the application in C# .NET Core 5
• More than one configuration (YAML) file can be specified using the --config option.
• Multiple Sonarr and Radarr instances can be specified in a single YAML config.

• Nearly all command line options removed in favor of YAML equivalents.
• Completely removed old python project & source code