TRaSH Guides Integration

📚 TRaSH Guides Integration

easiarr integrates with TRaSH Guides to provide optimal quality profiles and best practices for your media stack.

---

What is TRaSH Guides?

TRaSH Guides is a comprehensive collection of guides for *arr applications, providing:

• Quality profiles - Optimal release preferences
• Custom formats - Fine-grained quality selection
• Best practices - Configuration recommendations
• Folder structure - Hardlink-compatible setups

---

🎯 easiarr TRaSH Integration

Automatic Configuration

easiarr implements TRaSH recommendations automatically:

Feature	Implementation
Folder Structure	TRaSH-compliant /data layout
Hardlinks	Same filesystem for downloads and media
Permissions	PUID/PGID groups (13000)
Network	Optimized container networking
Profile Sync	Recyclarr or Profilarr integration

---

🔄 Profile Sync Options

easiarr supports two methods for syncing TRaSH Guides profiles to your *arr apps:

Recyclarr (CLI-based)

Recyclarr is a command-line tool that syncs quality profiles and custom formats.

• Type: CLI application (runs on schedule or manually)
• Configuration: YAML file (recyclarr.yml)
• Setup: Main Menu → Recyclarr Setup

Features:

• 📋 Profile selection from TRaSH Guides presets
• ⏰ Scheduled sync via cron
• 🔧 Full customization via YAML

Profilarr (Web UI)

Profilarr provides a web interface for managing TRaSH Guides profiles.

• Type: Web application
• Port: 6868
• Setup: Auto-configured during Full Auto Setup

Features:

• 🌐 Web-based UI for profile management
• 🔗 Direct *arr app connections
• 📊 Visual profile comparison
• 🔄 One-click sync

Comparison

Feature	Recyclarr	Profilarr
Interface	CLI	Web UI
Configuration	YAML file	Web forms
Auto-setup	✅ Yes	✅ Yes
Scheduled sync	✅ Cron-based	✅ Built-in
Custom formats	✅ Full support	✅ Full support

---

Quality Profiles

/your/media/root/
├── config/                    # Application configs
│   ├── radarr/
│   ├── sonarr/
│   ├── prowlarr/
│   ├── qbittorrent/
│   └── ...
└── data/
    ├── torrents/              # Download client downloads
    │   ├── movies/            # Radarr torrents
    │   ├── tv/                # Sonarr torrents
    │   ├── music/             # Lidarr torrents
    │   └── ...
    ├── usenet/                # Usenet downloads
    │   ├── incomplete/
    │   └── complete/
    │       ├── movies/
    │       ├── tv/
    │       └── ...
    └── media/                 # Organized library
        ├── movies/            # Hardlinked from torrents/movies
        ├── tv/                # Hardlinked from torrents/tv
        ├── music/
        ├── books/
        └── ...

Why This Structure?

1. Hardlinks work - Downloads and media on same filesystem
2. No file duplication - Same file, two locations
3. Instant imports - No file copying needed
4. Consistent paths - Same paths across all containers

---

🔗 Hardlinks Explained

What Are Hardlinks?

A hardlink is a directory entry that points to the same data as another file:

torrents/movies/Movie.mkv  ──┐
                              ├──► [Same data on disk]
media/movies/Movie.mkv     ──┘

Benefits

Benefit	Description
No duplication	File exists once, appears in two places
Instant	No copy time, immediate availability
Space efficient	Only one copy on disk
Seeding continues	Original in torrents folder keeps seeding

Requirements

For hardlinks to work:

1. ✅ Same filesystem for downloads and media
2. ✅ Same mount point in all containers
3. ✅ Using the /data root structure

Verifying Hardlinks

Check if hardlinks are working:

# Check inode numbers (same inode = hardlink)
ls -li /path/to/torrents/movies/Movie.mkv
ls -li /path/to/media/movies/Movie.mkv
# If inode numbers match, hardlink is working!

---

📊 Quality Profiles

Radarr Profiles

Profile	Use Case
HD Bluray + WEB	1080p, most compatible
UHD Bluray + WEB	4K content
Remux + WEB	Maximum quality

Sonarr Profiles

Profile	Use Case
WEB-DL	Streaming quality
Bluray	Physical media quality
Anime	Anime-optimized

Custom Formats

Custom formats provide fine-grained control:

• Release Group preferences
• Audio codec requirements
• HDR format handling
• Unwanted content filtering

---

🔧 Download Client Configuration

qBittorrent

TRaSH-recommended settings:

1. Downloads → Default Save Path

   /data/torrents
   

2. Categories - Create per-app categories:

   Category	Path
   radarr	/data/torrents/movies
   sonarr	/data/torrents/tv
   lidarr	/data/torrents/music

3. BitTorrent → Seeding Goals

   • Configure ratio/time limits as desired

📖 TRaSH - qBittorrent Settings

SABnzbd

1. Folders → Completed Download Folder

   /data/usenet/complete
   

2. Categories - Create per-app:

   Category	Path
   movies	/data/usenet/complete/movies
   tv	/data/usenet/complete/tv

📖 TRaSH - SABnzbd Settings

---

🎬 *Arr Application Settings

Root Folders

Configure root folders in each *arr app:

App	Root Folder
Radarr	/data/media/movies
Sonarr	/data/media/tv
Lidarr	/data/media/music
Readarr	/data/media/books

Download Client Settings

When adding download clients:

• Host: Container name (e.g., qbittorrent)
• Port: Internal port (e.g., 8080)
• Category: App-specific (e.g., radarr)
• Remote Path Mapping: Usually not needed with same mounts

Media Management

Recommended settings:

• Rename Movies/Episodes: ✅ Enabled
• Replace Illegal Characters: ✅ Enabled
• Standard Movie/Episode Format: TRaSH-recommended naming

---

🌐 Prowlarr Sync

Prowlarr syncs indexers to all connected *arr apps:

1. Settings → Apps - Add your *arr applications
2. Set sync level to Add and Remove Sync
3. Indexers automatically sync with correct category mappings

Category Mappings

*Arr App	Prowlarr Category IDs
Radarr	2000 (Movies)
Sonarr	5000 (TV)
Lidarr	3000 (Audio)
Readarr	7000 (Books)
Mylar3	7030 (Comics)
Whisparr	6000 (XXX)

---

📖 TRaSH Guides Resources

Guide	URL
Radarr	trash-guides.info/Radarr
Sonarr	trash-guides.info/Sonarr
Prowlarr	trash-guides.info/Prowlarr
Bazarr	trash-guides.info/Bazarr
qBittorrent	trash-guides.info/Downloaders/qBittorrent
SABnzbd	trash-guides.info/Downloaders/SABnzbd
Plex	trash-guides.info/Plex
Hardlinks	trash-guides.info/Hardlinks

---

🔗 Related

• Servarr-Apps - *Arr application configuration
• Download-Clients - Download client setup
• Configuration - easiarr configuration options