ClawARR Suite

Unified deep-integration control for self-hosted media automation stacks. This skill provides comprehensive agent-executable operations across the entire *arr ecosystem with rich analytics, dashboard generation, and advanced library exploration.

Security & Scanner Clarity

• - Local-first operations: all API calls target user-provided local hosts (typically LAN/NAS).
• No embedded secrets: API keys/tokens are sourced from environment variables or user-owned config files.
• No telemetry/exfiltration paths: scripts do not transmit credentials or library data to third-party endpoints.
• Destructive behavior is opt-in: delete/remove actions require explicit command invocation by the user/agent.
• Setup logic avoids dynamic eval and uses explicit variable mapping for scanner-friendly shell behavior.

Quick Start

First time setup (recommended):

scripts/setup.sh <host-ip-or-hostname>

Discovers services, grabs API keys, verifies connections, and outputs your config.

Common operations:
CODEBLOCK1

Scripts Overview

Core Operations

• - setup.sh — Guided setup wizard with auto-discovery
• discover.sh — Scan host for *arr services
• status.sh — Health check all configured services
• diagnose.sh — Automated troubleshooting

Library Exploration (library.sh)

Deep statistics and exploration for Radarr/Sonarr/Lidarr: CODEBLOCK2

Analytics (analytics.sh)

Rich viewing analytics from Tautulli/Plex: CODEBLOCK3

Content Management (manage.sh)

Add, remove, and manage content: CODEBLOCK4

Request Management (requests.sh)

Overseerr request handling: CODEBLOCK5

Subtitle Management (subtitles.sh)

Bazarr operations: CODEBLOCK6

Indexer Management (indexers.sh)

Prowlarr operations: CODEBLOCK7

Download Client (downloads.sh)

SABnzbd operations: CODEBLOCK8

Dashboard Generation (dashboard.sh)

Generate self-contained HTML dashboard:

dashboard.sh [output_file]

Creates beautiful dark-themed dashboard with:

• - System health
• Download activity
• Library statistics
• Recent activity
• Viewing analytics
• Disk usage

Output defaults to clawarr-dashboard.html (open in any browser).

Media Tracker Integration (trakt.sh, trackers.sh, letterboxd.sh, simkl.sh)

Track and sync what you watch across services like Trakt.tv, Letterboxd, Simkl, and more.

Unified Interface (trackers.sh):
CODEBLOCK10

Trakt.tv Integration (trakt.sh):

Authentication:
CODEBLOCK11

Profile & Stats:
CODEBLOCK12

Watching & History:
CODEBLOCK13

Scrobbling:
CODEBLOCK14

Lists & Collections:
CODEBLOCK15

Ratings:
CODEBLOCK16

Discovery:
CODEBLOCK17

Search:
CODEBLOCK18

Sync:
CODEBLOCK19

Letterboxd Integration (letterboxd.sh):
CODEBLOCK20

Simkl Integration (simkl.sh):
CODEBLOCK21

Traktarr & Retraktarr Integration

Automate content discovery and library syncing with Trakt lists.

Traktarr (Trakt → Radarr/Sonarr):
CODEBLOCK22

Retraktarr (Radarr/Sonarr → Trakt):
CODEBLOCK23

Installation via Setup Wizard:
CODEBLOCK24

What They Do:

• - Traktarr: Automatically adds content from Trakt lists (trending, anticipated, watchlist, custom) to Radarr/Sonarr for download
• Retraktarr: Syncs your Radarr/Sonarr library back to Trakt as public/private lists

See references/traktarr-retraktarr.md for complete setup, cron scheduling, and usage patterns.

Prowlarr Indexer Management (prowlarr.sh)

Centralized indexer management across all *arr apps: CODEBLOCK25

Recyclarr Quality Profiles (recyclarr.sh)

Sync TRaSH Guides quality profiles to Sonarr/Radarr: CODEBLOCK26

Maintainerr Library Cleanup (maintainerr.sh)

Automated library cleanup based on rules: CODEBLOCK27

Notifiarr Notifications (notifiarr.sh)

Unified notification management across *arr services: CODEBLOCK28

Kometa Collection Manager (kometa.sh)

Plex collection, overlay, and metadata automation: CODEBLOCK29

Unpackerr Archive Extraction (unpackerr.sh)

Automatic archive extraction for download clients: CODEBLOCK30

Legacy Scripts

• - queue.sh — View download queues (use manage.sh wanted or downloads.sh active for more detail)
• search.sh — Search content (use manage.sh add-* for full workflow)

Configuration

Environment Variables

Core Services:
CODEBLOCK31

Media Trackers (optional):
CODEBLOCK32

Token Storage:

• - Tokens are automatically saved to INLINECODE34
• Files: trakt_tokens.json, INLINECODE36
• Permissions: 600 (user read/write only)

Store in .env file and source before running scripts.

Standard Ports

• - Sonarr: 8989
• Radarr: 7878
• Lidarr: 8686
• Readarr: 8787
• Prowlarr: 9696
• Bazarr: 6767
• Overseerr: 5055
• Plex: 32400
• Tautulli: 8181
• SABnzbd: 38080
• Notifiarr: 5454
• Maintainerr: 6246
• FlareSolverr: 8191
• Homarr: 7575

API Key Discovery

Method 1: /initialize.json (Easiest)

Most *arr apps expose API key at public endpoint: CODEBLOCK33

For older versions (v3):
CODEBLOCK34

Method 2: Config Files

Docker/Unraid/Synology: /config/config.xml (inside container) CODEBLOCK35

Method 3: Web UI

Settings → General → Security → API Key

Plex Token

From Plex Web UI:

1. 1. Open any media item
2. "Get Info" → "View XML"
3. URL contains INLINECODE39

Or use:
CODEBLOCK36

Tautulli API Key

Settings → Web Interface → API → API Key

SABnzbd API Key

Config → General → Security → API Key

Common Workflows

Library Analysis

CODEBLOCK37

Viewing Analytics

CODEBLOCK38

Request Management

CODEBLOCK39

Content Management

CODEBLOCK40

Indexer Management (Prowlarr)

CODEBLOCK41

Quality Profiles (Recyclarr)

CODEBLOCK42

Library Cleanup (Maintainerr)

CODEBLOCK43

Collections & Overlays (Kometa)

CODEBLOCK44

Dashboard

CODEBLOCK45

Media Tracking Workflows

Initial Setup:
CODEBLOCK46

Sync Plex to Trakt:
CODEBLOCK47

Export for Letterboxd:
CODEBLOCK48

Cross-Tracker Sync:
CODEBLOCK49

Discovery & Recommendations:
CODEBLOCK50

Track Viewing:
CODEBLOCK51

Automation with Traktarr/Retraktarr:
CODEBLOCK52

Troubleshooting

No Files Eligible for Import

Diagnosis:
CODEBLOCK53

Common causes:

1. 1. Stale Docker mounts — Container restarted but host didn't
2. Path mapping — Download client and arr app see different paths
3. Permissions — arr app can't read download directory
4. Category mismatch — Download in wrong category

Solutions:
CODEBLOCK54

Queue Stuck

Check download client:
CODEBLOCK55

Check *arr queues:
CODEBLOCK56

Check indexers:
CODEBLOCK57

Missing Subtitles

CODEBLOCK58

Reference Documentation

• - references/api-endpoints.md — Complete API reference for all services
• references/tracker-apis.md — Media tracker API documentation (Trakt, Simkl, Letterboxd)
• references/traktarr-retraktarr.md — Complete guide to Traktarr & Retraktarr automation
• references/companion-services.md — Prowlarr, Recyclarr, FlareSolverr, Unpackerr, Notifiarr, Maintainerr, Kometa reference
• references/common-issues.md — Troubleshooting guide with solutions
• references/setup-guide.md — Platform-specific installation
• references/prompts.md — Suggested natural-language prompts for agents
• references/dashboard-templates.md — HTML/CSS templates for dashboards

Example Agent Prompts

See references/prompts.md for complete list. Examples:

Library & Downloads:

• - "Show me what's downloading right now"
• "What movies were added this week?"
• "Generate a dashboard of my media library"
• "What are the most watched shows this month?"
• "Find all 720p movies that could be upgraded to 4K"
• "Show missing episodes for all monitored shows"
• "What's coming out this week?"
• "Approve all pending Overseerr requests"
• "How much disk space am I using per library?"
• "Show my Plex viewing stats for the last 30 days"
• "What subtitles are missing?"
• "Test all my indexers"

Media Tracking:

• - "Set up Trakt tracking for my Plex library"
• "Sync my Plex watch history to Trakt"
• "What am I currently watching on Trakt?"
• "Show my Trakt watch history from this month"
• "Get movie recommendations based on my Trakt ratings"
• "What's trending on Trakt right now?"
• "Export my library for Letterboxd"
• "Compare my Trakt and Simkl watch histories"
• "Show me upcoming movie releases I'm tracking"
• "Rate Inception 10/10 on Trakt"
• "Add Dune Part Two to my Trakt watchlist"
• "Show my Letterboxd profile stats"
• "What are my top-rated movies on Trakt?"

Prowlarr & Indexers:

• - "Show all my indexers and test them"
• "Search across all indexers for Breaking Bad"
• "Sync Prowlarr indexers to Sonarr and Radarr"
• "Add Sonarr as a sync target in Prowlarr"

Quality Profiles (Recyclarr):

• - "Sync TRaSH Guides quality profiles"
• "Preview what Recyclarr would change"
• "Show available quality profiles for Radarr"
• "What quality definitions does Sonarr have?"

Library Cleanup (Maintainerr):

• - "Show my library cleanup rules"
• "What movies are flagged for deletion?"
• "Run all cleanup rules now"
• "Exclude this movie from the cleanup rule"

Collections & Overlays (Kometa):

• - "Run Kometa to update collections"
• "Show all my Plex collections"
• "What overlay templates are available?"
• "Add IMDb Top 250 collection to my movie library"

Notifications (Notifiarr):

• - "Check Notifiarr status and integrations"
• "Send a test notification"
• "Show recent notifications"

Archive Extraction (Unpackerr):

• - "Check Unpackerr status"
• "Show recent extraction activity"
• "Any extraction errors?"

Traktarr/Retraktarr Automation:

• - "Set up Traktarr to auto-add trending movies"
• "Add the top 10 anticipated movies from Trakt to Radarr"
• "Configure Traktarr to monitor my Trakt watchlist"
• "Sync my Radarr library to a public Trakt list"
• "Show Traktarr status and configuration"
• "Add trending shows to Sonarr via Traktarr"
• "Set up automatic syncing between Trakt and my *arr apps"
• "What's Retraktarr doing? Is it synced?"

Technical Notes

Bash 3.2 Compatibility

All scripts are compatible with macOS bash 3.2:

• - No associative arrays (declare -A)
• No uppercase parameter expansion (${var^^})
• Use $(echo "$var" | tr '[:lower:]' '[:upper:]') for case conversion
• No |& (pipe stderr), use 2>&1 instead

Dependencies

• - curl — HTTP requests
• jq — JSON parsing
• bc — Math calculations (for percentages, GB conversions)
• sed — Text processing

All standard on macOS/Linux.

Security

• - Never log API keys
• Confirm destructive actions (delete, remove)
• Rate limiting for bulk operations
• Use HTTPS for remote access

Performance

• - Scripts cache API responses where possible
• Dashboard generation pulls data once per run
• Bulk operations use batch APIs when available

Version Compatibility

Tested with:

• - Sonarr v4.x (API v3)
• Radarr v5.x (API v3)
• Lidarr v2.x (API v1)
• Readarr v0.3.x (API v1)
• Prowlarr v1.x (API v1)
• Bazarr v1.4.x
• Overseerr v1.33.x (API v1)
• Plex Media Server (all recent versions)
• Tautulli v2.x (API v2)
• SABnzbd v4.x
• Recyclarr v7.x
• Unpackerr v0.14.x
• Notifiarr v0.8.x
• Maintainerr v2.x
• Kometa v2.x (Plex Meta Manager successor)
• FlareSolverr v3.x

Contributing

Report issues or suggest features via GitHub. Include:

• - Script name and command run
• Error output (sanitize API keys!)
• Service versions
• Platform (Docker/Unraid/Synology/etc)

License

MIT License - See repository for details.