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.20: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:
```bash
0 6 * * * /usr/local/bin/recyclarr sync > /dev/null 2>&1
```

## Manual Sync

To manually trigger a sync:
```bash
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:
```bash
ssh pm2 "pct exec 122 -- cat /root/.config/recyclarr/logs/recyclarr.log"
```

View last sync results:
```bash
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
```bash
ssh pm2 "pct exec 122 -- /usr/local/bin/recyclarr sync --preview"
```

### Verify API connectivity
```bash
# 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.20:8989/api/v3/system/status
```

### Force resync all custom formats
```bash
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