Initial commit: KavCorp infrastructure documentation
- CLAUDE.md: Project configuration for Claude Code - docs/: Infrastructure documentation - INFRASTRUCTURE.md: Service map, storage, network - CONFIGURATIONS.md: Service configs and credentials - CHANGELOG.md: Change history - DECISIONS.md: Architecture decisions - TASKS.md: Task tracking - scripts/: Automation scripts 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
178
docs/recyclarr-setup.md
Normal file
178
docs/recyclarr-setup.md
Normal file
@@ -0,0 +1,178 @@
|
||||
# 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:
|
||||
```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.15: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
|
||||
Reference in New Issue
Block a user