assemblrr/docs/trash-guides.md
soulis-1256 692d535418
fix(bazarr): lower min scores for non-English subtitle languages
TRaSH 90/80 skips OpenSubtitles.com results that miss hash and source.
Use 70/50 when any selected language is not English, enable greeksubs
for Greek, and search wanted after wiring.
2026-08-23 23:41:05 +03:00

47 lines
4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Quality Profiles & TRaSH Guides
assemblrr uses [Recyclarr](https://recyclarr.dev/) to sync [TRaSH Guides](https://trash-guides.info/) quality profiles and custom formats into Radarr and Sonarr.
**Subtitles:** Bazarr is wired separately (not via Recyclarr). On first install and every `assemblrr upgrade`, assemblrr applies [TRaSH Bazarr suggested scoring](https://trash-guides.info/Bazarr/Bazarr-suggested-scoring/) (series min 90, movies 80, auto-sync 96/86). If any selected subtitle language is not English, those minimum scores drop to 70/50: OpenSubtitles.com rarely hash-matches non-English WEB-DL releases, and TRaSH 90/80 would skip them. Subsync still retimes anything below the sync thresholds. Subtitle languages are a two-step fzf: multi-select what to download, then (if more than one) which Jellyfin should prefer. Providers are chosen interactively from the running Bazarr image (fzf multi-select; nothing enabled unless you pick it). OpenSubtitles.com is enabled only when you saved credentials during setup. Greek also enables the `greeksubs` provider unless you confirmed a provider list without it.
**Both resolutions and both movie sources are always installed** as assemblrr-named profiles:
- Movies: **assemblrr 1080p Bluray + WEB**, **assemblrr 4K Bluray + WEB**, **assemblrr 1080p WEB**, **assemblrr 4K WEB**
- TV: **assemblrr 1080p WEB**, **assemblrr 4K WEB**
TRaSH has no first-class WEB-only Radarr profile. Movie WEB packs reuse the 1080p/4K Bluray + WEB trash IDs as Recyclarr variants, with qualities overridden so Blu-ray is disabled and cutoff is WEB. All four stay in the Radarr/Seerr dropdown; setup only picks the default.
Setup and `config edit` ask once for resolution, then (unless you chose Any) for movie source. That pair is the default for **Radarr, Sonarr, and Seerr**:
- **4K + Bluray + WEB:** movies → 4K Bluray + WEB, TV → 4K WEB
- **4K + WEB:** movies → 4K WEB, TV → 4K WEB
- **1080p + Bluray + WEB:** movies → 1080p Bluray + WEB, TV → 1080p WEB
- **1080p + WEB:** movies → 1080p WEB, TV → 1080p WEB
- **Any:** stock *arr Any (movie source is ignored)
Missing `QUALITY_SOURCE` on an older install means **bluray** (the previous default). TV is always WEB; TRaSHs English Sonarr defaults are WEB-only.
The chosen profile is written over *arrs stock **Any** slot (id 1) so Add Movie / Add Series opens on it. The other assemblrr profiles stay in the dropdown. Titles already in the library keep whatever profile they have. Stock *arr profiles (HD-1080p, …) still appear; that is normal.
assemblrr deliberately **does not** apply TRaSH quality min-size limits (they can reject smaller legitimate releases), and softens hard-block custom formats (LQ / x265 / 3D scores set to 0). Tier preferences from the guides still apply when better releases exist.
**Those guides change over time.** Trash IDs, profile names, and Recyclarr YAML schema can all break without warning. When that happens you may see:
- Recyclarr sync errors (`Invalid quality profile trash_id`, `YAML error`, etc.)
- Seerr defaulting to **Any** instead of your chosen quality
- Missing Recyclarr profiles in Radarr/Sonarr (only stock profiles like Any / HD-1080p)
That is expected community-guide churn — not a VPN or Docker failure.
## What to do when it breaks
1. Check Recyclarr: `docker logs recyclarr` and/or `docker exec recyclarr recyclarr sync`
2. List current guide IDs from inside the container:
```bash
docker exec recyclarr recyclarr list quality-profiles radarr
docker exec recyclarr recyclarr list quality-profiles sonarr
```
3. Update the relevant pack under `templates/recyclarr/includes/` (or the live copies in your installs `config/recyclarr/includes/`) with the new trash IDs. Root config is `templates/recyclarr/recyclarr.yml`.
4. Re-run Recyclarr, then refresh the install (wiring included): `assemblrr upgrade`
We try to keep templates current, but **plan on occasional manual updates** if you rely on TRaSH-backed profiles long-term. Official docs: [Recyclarr](https://recyclarr.dev/) · [TRaSH Guides](https://trash-guides.info/).