proxmox-infra/docs/recyclarr-setup.md

Recyclarr Setup - TRaSH Guides Automation

Last Updated: 2025-11-16

Overview

Recyclarr automatically syncs TRaSH Guides recommended custom formats and quality profiles to Radarr and Sonarr.

Installation Details

• LXC: VMID 122 on pm2
• IP Address: 10.4.2.25
• Binary: /usr/local/bin/recyclarr
• Config: /root/.config/recyclarr/recyclarr.yml

Configuration Summary

Radarr (Movies)

• URL: http://10.4.2.16:7878
• API Key: 5e6796988abf4d6d819a2b506a44f422
• Quality Profiles:
  • HD Bluray + WEB (1080p standard)
  • Remux-1080p - Anime
• Custom Formats: 34 formats synced
• Dolby Vision: BLOCKED (DV w/o HDR fallback scored at -10000)

Key Settings:

• Standard profile prefers 1080p Bluray and WEB releases
• Anime profile includes Remux with merged quality groups
• Blocks Dolby Vision Profile 5 (no HDR fallback) on standard profile
• Blocks unwanted formats (BR-DISK, LQ, x265 HD, 3D, AV1, Extras)
• Uses TRaSH Guides release group tiers (BD, WEB, Anime BD, Anime WEB)

Sonarr (TV Shows)

• URL: http://10.4.2.15:8989
• API Key: b331fe18ec2144148a41645d9ce8b249
• Quality Profiles:
  • WEB-1080p (standard)
  • Remux-1080p - Anime
• Custom Formats: 29 formats synced
• Dolby Vision: BLOCKED (DV w/o HDR fallback scored at -10000)

Key Settings:

• Standard profile prefers 1080p WEB releases (WEB-DL and WEBRip)
• Anime profile includes Bluray Remux with merged quality groups
• Blocks Dolby Vision Profile 5 (no HDR fallback) on standard profile
• Blocks unwanted formats (BR-DISK, LQ, x265 HD, AV1, Extras)
• Uses TRaSH Guides WEB release group tiers and Anime tiers

Automated Sync Schedule

Recyclarr runs daily at 6:00 AM via cron:

0 6 * * * /usr/local/bin/recyclarr sync > /dev/null 2>&1

Manual Sync

To manually trigger a sync:

ssh pm2 "pct exec 122 -- /usr/local/bin/recyclarr sync"

Dolby Vision Blocking

Both Radarr and Sonarr are configured to completely block Dolby Vision releases without HDR10 fallback (Profile 5). These releases will receive a score of -10000, ensuring they are never downloaded.

What this blocks:

• WEB-DL releases with Dolby Vision Profile 5 (no HDR10 fallback)
• Any release that only plays back in DV without falling back to HDR10

What this allows:

• HDR10 releases
• HDR10+ releases
• Dolby Vision Profile 7 with HDR10 fallback (from UHD Blu-ray)

Custom Format Details

Blocked Formats (Score: -10000)

• DV (w/o HDR fallback): Blocks DV Profile 5
• BR-DISK: Blocks full BluRay disc images
• LQ: Blocks low-quality releases
• x265 (HD): Blocks x265 encoded HD content (720p/1080p)
• 3D: Blocks 3D releases
• AV1: Blocks AV1 codec
• Extras: Blocks extras, featurettes, etc.

Preferred Formats

• WEB Tier 01-03: Scored 1600-1700 (high-quality WEB groups)
• UHD Bluray Tier 01-03: Scored 1700 (Radarr only)
• Streaming Services: Neutral score (AMZN, ATVP, DSNP, HBO, etc.)
• Repack/Proper: Scored 5-7 (prefers repacks over originals)

Monitoring

Check Recyclarr logs:

ssh pm2 "pct exec 122 -- cat /root/.config/recyclarr/logs/recyclarr.log"

View last sync results:

ssh pm2 "pct exec 122 -- /usr/local/bin/recyclarr sync --preview"

Updating Configuration

1. Edit config: ssh pm2 "pct exec 122 -- nano /root/.config/recyclarr/recyclarr.yml"
2. Test config: ssh pm2 "pct exec 122 -- /usr/local/bin/recyclarr config check"
3. Run sync: ssh pm2 "pct exec 122 -- /usr/local/bin/recyclarr sync"

Troubleshooting

Check if sync is working

ssh pm2 "pct exec 122 -- /usr/local/bin/recyclarr sync --preview"

Verify API connectivity

# Test Radarr
curl -H "X-Api-Key: 5e6796988abf4d6d819a2b506a44f422" http://10.4.2.16:7878/api/v3/system/status

# Test Sonarr
curl -H "X-Api-Key: b331fe18ec2144148a41645d9ce8b249" http://10.4.2.15:8989/api/v3/system/status

Force resync all custom formats

ssh pm2 "pct exec 122 -- /usr/local/bin/recyclarr sync --force"

Important Notes

• Do not modify custom format scores manually in Radarr/Sonarr web UI - they will be overwritten on next sync
• Quality profile changes made in the web UI may be preserved unless they conflict with Recyclarr config
• The DV blocking is automatic - no manual intervention needed
• Recyclarr keeps custom formats up-to-date with TRaSH Guides automatically

Next Steps

• Monitor downloads to ensure DV content is properly blocked
• Adjust quality profiles in Recyclarr config if needed (e.g., prefer 1080p over 4K)
• Review TRaSH Guides for additional custom formats: https://trash-guides.info/

Anime Configuration

Both Radarr and Sonarr include a dedicated "Remux-1080p - Anime" quality profile for anime content.

Key Anime Settings:

• Quality groups merged per TRaSH Guides (Remux + Bluray + WEB + HDTV in combined groups)
• Anime BD Tiers 01-08: Scored 1300-1400 (SeaDex muxers, remuxes, fansubs, P2P, mini encodes)
• Anime WEB Tiers 01-06: Scored 150-350 (muxers, top fansubs, official subs)
• Dual Audio preferred: +101 score for releases with both Japanese and English audio
• Unwanted blocked: Same as standard profile (BR-DISK, LQ, x265 HD, AV1, Extras)

Scoring Differences from Standard Profile:

• Anime Web Tier 01 scores 350 (vs 1600 for standard WEB Tier 01)
• Emphasizes BD quality over WEB for anime (BD Tier 01 = 1400)
• Merged quality groups allow HDTV to be considered alongside WEB for anime releases

To use anime profile:

1. In Radarr/Sonarr, edit a movie or series
2. Change quality profile to "Remux-1080p - Anime"
3. Recyclarr will automatically manage custom format scores

Inventory Update

Added to cluster inventory:

• VMID: 122
• Name: recyclarr
• Node: pm2
• IP: 10.4.2.25
• CPU: 1 core
• Memory: 512MB
• Disk: 2GB (KavNas)
• Purpose: TRaSH Guides automation for Radarr/Sonarr
• Tags: arr, community-script