checkrr

Checkrr is a media-library integrity tool that can run as a daemon or as a one-off command, making it suitable for scheduled scans. It inspects files under one or more configured paths using ffprobe, magic-number detection, MIME-type checks, and file hashes. Files that pass are recorded in a bbolt flatfile database so later scans can avoid reprocessing unchanged media. When a file fails inspection and arr integration is enabled, Checkrr can use Sonarr, Radarr, or Lidarr to identify the corresponding media item, remove the bad file, and request a replacement through the relevant service. Multiple instances of each arr service can be configured. Processing can also be disabled, allowing Checkrr to run in a report-only mode where failed files are surfaced in the output without automatic deletion or replacement. Installation is documented for standalone binaries, Docker and Docker Compose, Debian/Ubuntu through an apt repository, and unRAID. ffprobe must be installed and available on the system path. Docker users must create the configuration and database files before mounting them, and may need path mappings when Checkrr and the arr services see media at different paths. The application uses a YAML configuration file, supports multiple check paths, and can run continuously or exit after a single scan with --run-once.