You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
42 lines
2.0 KiB
42 lines
2.0 KiB
4 years ago
|
Custom format synchronization is broken up into three categories:
|
||
|
|
||
|
- Creation: Custom formats that are in the guide but do not exist in Radarr are **created**.
|
||
|
- Updates: Custom formats that already exist in both the guide and in Radarr are **updated**.
|
||
|
- Deletions: If deletions are allowed by having the `delete_old_custom_formats` configuration
|
||
|
setting set to `true`, then custom formats in Radarr are deleted if they are removed from the
|
||
|
guide **or** removed from your configuration file.
|
||
|
|
||
|
> **Important**
|
||
|
>
|
||
|
> Trash Updater will *never* touch custom formats that you create by hand, unless they share a name
|
||
|
> with a custom format in the guide. In general, Trash Updater must have been the one to create a
|
||
|
> custom format in order to do anything to it (update or delete).
|
||
|
|
||
|
## Cache
|
||
|
|
||
|
### Summary
|
||
|
|
||
|
The synchronization cache in Trash Updater allows it to more accurately detect changes to custom
|
||
|
formats in the TRaSH guides. This mainly helps cover changes like renames.
|
||
|
|
||
|
Once Trash Updater creates or updates a custom format in Radarr, it records information about it in
|
||
|
a cache file located on disk. The location varies depending on platform:
|
||
|
|
||
|
- Windows: `%APPDATA%/trash-updater/cache`
|
||
|
- Linux: `~/.config/trash-updater/cache`
|
||
|
- MacOS: `~/Library/Application Support/trash-updater/cache`
|
||
|
|
||
|
The cache files are not meant to be edited by users. In general I recommend leaving them alone.
|
||
|
Trash Updater will manage it for you. However, sometimes a bug may cause an issue where deleting the
|
||
|
cache directory will be a good way to recover.
|
||
|
|
||
|
### Custom Format Identification Behavior
|
||
|
|
||
|
The cache stores and remembers the last known valid name for a custom format. If a custom format
|
||
|
gets renamed in the Trash Guide, you don't need to immediately rename it in your YAML config. Trash
|
||
|
Updater will issue a warning in console output when the names become outdated. This gives you plenty
|
||
|
of time to fix the issue.
|
||
|
|
||
|
Note that if the cache gets deleted, custom formats with outdated names will no longer synchronize
|
||
|
to Radarr and you will need to either remove it or fix the name.
|