This source did not publish a separate summary. Review SKILL.md before using the skill.
SKILL.md
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:
scripts/status.sh # Health check all services
scripts/library.sh stats all # Library statistics
scripts/analytics.sh activity # Current Plex streams
scripts/dashboard.sh # Generate HTML dashboard
scripts/manage.sh wanted all # Show missing content
scripts/requests.sh list # Overseerr requests
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:
library.sh stats [app] # Overall library stats
library.sh quality [app] # Quality profile breakdown
library.sh missing [app] # Missing/wanted content
library.sh unmonitored [app] # Unmonitored items
library.sh recent [app] [days] # Recently added (default: 7)
library.sh genres [app] # Genre distribution
library.sh years [app] # Year distribution
library.sh studios [app] # Studio/network breakdown
library.sh nofiles [app] # Monitored but no files
library.sh disk [app] # Disk usage by root folder
Analytics (analytics.sh)
Rich viewing analytics from Tautulli/Plex:
analytics.sh activity # Currently watching
analytics.sh history [count] # Watch history
analytics.sh most-watched [period] # Most watched (week/month/year)
analytics.sh popular-genres [period] # Popular genres
analytics.sh peak-hours # Peak watching hours
analytics.sh user-stats [user] # User activity
analytics.sh library-stats # Plex library stats
analytics.sh recent-added [count] # Recently added to Plex
analytics.sh play-totals # Total play statistics
trakt.sh watching # Currently watching
trakt.sh history [movies|shows|episodes] [limit]
trakt.sh sync-history export file.json
trakt.sh sync-history import file.json
Scrobbling:
trakt.sh scrobble start movie 12345
trakt.sh scrobble stop movie 12345 100
trakt.sh checkin movie "Inception"
Lists & Collections:
trakt.sh watchlist [movies|shows]
trakt.sh watchlist-add movie "Dune Part Two"
trakt.sh collection movies
trakt.sh collection-add movie 12345
trakt.sh lists # Custom lists
trakt.sh list-items my-favorites
Ratings:
trakt.sh ratings movies 8 # Movies rated 8+
trakt.sh rate movie "Inception" 10
Discovery:
trakt.sh recommendations movies
trakt.sh trending shows
trakt.sh popular movies
trakt.sh calendar all 7 # Next 7 days
Search:
trakt.sh search "Breaking Bad" show
Sync:
trakt.sh sync-plex # Sync Plex watch history to Trakt
Letterboxd Integration (letterboxd.sh):
letterboxd.sh export # Export from Plex as Letterboxd CSV
letterboxd.sh import diary.csv # Import Letterboxd diary
letterboxd.sh profile username # View public profile
letterboxd.sh diary username 2024
Simkl Integration (simkl.sh):
simkl.sh auth # OAuth authentication
simkl.sh profile # Show profile
simkl.sh stats # Viewing statistics
simkl.sh history movies # Watch history
simkl.sh watchlist all # View watchlist
simkl.sh sync # Sync with Plex
Traktarr & Retraktarr Integration
Automate content discovery and library syncing with Trakt lists.
Traktarr (Trakt → Radarr/Sonarr):
# Status and configuration
trakt.sh traktarr-status # Check if installed
trakt.sh traktarr-config # Configure Traktarr
# Add content from Trakt lists
trakt.sh traktarr-add movies trending 10
trakt.sh traktarr-add movies anticipated 15
trakt.sh traktarr-add movies popular 5
trakt.sh traktarr-add shows trending 5
trakt.sh traktarr-add movies watchlist 50
Retraktarr (Radarr/Sonarr → Trakt):
# Status and configuration
trakt.sh retraktarr-status # Check if installed
trakt.sh retraktarr-config # Configure Retraktarr
# Sync library to Trakt lists
trakt.sh retraktarr-sync all # Sync movies and shows
trakt.sh retraktarr-sync movies
trakt.sh retraktarr-sync shows
Installation via Setup Wizard:
trackers.sh setup
# Choose option 5 for Traktarr
# Choose option 6 for Retraktarr
# Offers to install via pip if not found
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:
prowlarr.sh indexers # List all indexers
prowlarr.sh test [id] # Test indexer(s)
prowlarr.sh stats # Indexer & app sync statistics
prowlarr.sh search <query> [type] # Search across all indexers (type: movie|tv|audio|book)
prowlarr.sh apps # List sync targets (Sonarr/Radarr/etc)
prowlarr.sh add-app <type> <url> <key> # Add app sync target
prowlarr.sh sync # Trigger sync to all apps
prowlarr.sh status # Health check
prowlarr.sh logs [count] # Recent logs
Recyclarr Quality Profiles (recyclarr.sh)
Sync TRaSH Guides quality profiles to Sonarr/Radarr:
recyclarr.sh status # Check status & config
recyclarr.sh sync [instance] # Sync profiles (all or specific)
recyclarr.sh diff [instance] # Preview changes without applying
recyclarr.sh profiles # List available TRaSH profiles
recyclarr.sh qualities [app] # List quality definitions
recyclarr.sh config # Show current config
recyclarr.sh create-config # Generate config template
recyclarr.sh logs [count] # View recent logs
Maintainerr Library Cleanup (maintainerr.sh)
Automated library cleanup based on rules:
maintainerr.sh status # Check status
maintainerr.sh rules # List cleanup rules
maintainerr.sh collections # List managed collections
maintainerr.sh run [rule_id] # Trigger rules (all or specific)
maintainerr.sh media <rule_id> # Show media matched by a rule
maintainerr.sh exclude <media_id> <rule_id> # Exclude media from rule
maintainerr.sh logs # View activity log
Notifiarr Notifications (notifiarr.sh)
Unified notification management across *arr services:
notifiarr.sh status # Check status & integrations
notifiarr.sh triggers # List notification triggers
notifiarr.sh services # Show connected services
notifiarr.sh test [channel] # Send test notification
notifiarr.sh config # Configuration summary
notifiarr.sh logs # Recent notification log
Kometa Collection Manager (kometa.sh)
Plex collection, overlay, and metadata automation:
kometa.sh status # Check container status
kometa.sh run [library] # Run Kometa (all or specific library)
kometa.sh collections # Show Plex collections
kometa.sh overlays # Check overlay config
kometa.sh config # Show Kometa config
kometa.sh templates # List available default collections/overlays
kometa.sh logs [count] # View recent logs
Unpackerr Archive Extraction (unpackerr.sh)
Automatic archive extraction for download clients:
# Get complete library overview
scripts/library.sh stats all
# Find quality upgrade candidates
scripts/library.sh quality radarr
# Show missing content
scripts/library.sh missing all
# Check disk usage
scripts/library.sh disk all
Viewing Analytics
# Current activity
scripts/analytics.sh activity
# Most watched this month
scripts/analytics.sh most-watched month
# User statistics
scripts/analytics.sh user-stats
# Peak hours
scripts/analytics.sh peak-hours
Request Management
# Show pending requests
scripts/requests.sh list pending
# Approve request
scripts/requests.sh approve 123
# Request statistics
scripts/requests.sh stats
Content Management
# Add movie
scripts/manage.sh add-movie "Dune Part Two"
# Show calendar
scripts/manage.sh calendar all 7
# View history
scripts/manage.sh history radarr 30
# Show wanted/missing
scripts/manage.sh wanted all
Indexer Management (Prowlarr)
# List and test all indexers
scripts/prowlarr.sh indexers
scripts/prowlarr.sh test
# Search across all indexers
scripts/prowlarr.sh search "Dune" movie
# Add Sonarr/Radarr as sync targets
scripts/prowlarr.sh add-app sonarr http://host:8989 <sonarr_key>
scripts/prowlarr.sh add-app radarr http://host:7878 <radarr_key>
# Trigger indexer sync to all apps
scripts/prowlarr.sh sync
Quality Profiles (Recyclarr)
# Preview changes
scripts/recyclarr.sh diff
# Sync TRaSH Guides profiles
scripts/recyclarr.sh sync
# Check status
scripts/recyclarr.sh status
Library Cleanup (Maintainerr)
# View rules and matched media
scripts/maintainerr.sh rules
scripts/maintainerr.sh media 1
# Run cleanup
scripts/maintainerr.sh run
# Exclude something from cleanup
scripts/maintainerr.sh exclude 12345 1
Collections & Overlays (Kometa)
# Run collection/overlay generation
scripts/kometa.sh run
# View existing collections
scripts/kometa.sh collections
# See available templates
scripts/kometa.sh templates
Dashboard
# Generate dashboard
scripts/dashboard.sh my-dashboard.html
# Open in browser
open my-dashboard.html
Media Tracking Workflows
Initial Setup:
# Set up Trakt.tv
scripts/trackers.sh setup
# Select option 1 (Trakt.tv)
# Follow device auth flow
# Check status
scripts/trackers.sh status
Sync Plex to Trakt:
# One-time sync of watch history
scripts/trakt.sh sync-plex
# Or use unified interface
scripts/trackers.sh sync plex trakt
Export for Letterboxd:
# Generate Letterboxd-compatible CSV
scripts/letterboxd.sh export
# Upload at letterboxd.com/import/
Cross-Tracker Sync:
# Export from Trakt, convert for Letterboxd
scripts/trackers.sh sync trakt letterboxd
# Compare two services
scripts/trackers.sh compare trakt simkl
Discovery & Recommendations:
# Get personalized recommendations
scripts/trakt.sh recommendations movies
# See what's trending
scripts/trakt.sh trending shows
# Check upcoming releases
scripts/trakt.sh calendar all 7
Track Viewing:
# See what you're currently watching
scripts/trakt.sh watching
# View watch history
scripts/trakt.sh history movies 50
# Rate something you watched
scripts/trakt.sh rate movie "Inception" 10
Automation with Traktarr/Retraktarr:
# Set up Traktarr (Trakt → Arr)
scripts/trackers.sh setup # Option 5
# Add trending movies to Radarr
scripts/trakt.sh traktarr-add movies trending 10
# Add anticipated shows to Sonarr
scripts/trakt.sh traktarr-add shows anticipated 5
# Set up Retraktarr (Arr → Trakt)
scripts/trackers.sh setup # Option 6
# Sync library to Trakt lists
scripts/trakt.sh retraktarr-sync all
# Schedule automation (cron):
# Traktarr every 6 hours: 0 */6 * * * traktarr run
# Retraktarr daily at 3am: 0 3 * * * retraktarr sync
Troubleshooting
No Files Eligible for Import
Diagnosis:
scripts/diagnose.sh
Common causes:
Stale Docker mounts — Container restarted but host didn't
Path mapping — Download client and *arr app see different paths
