Skip to content

Latest commit

Β 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎬 ClawARR Suite

Unified deep-integration control for self-hosted media automation stacks.

ClawARR Suite is an OpenClaw agent skill that gives your AI assistant full operational control over your entire *arr media stack β€” from library analytics to download management to Plex collection automation.

24 scripts Β· 8,500+ lines Β· 180+ subcommands Β· 8 reference docs


✨ What Can It Do?

Category Capabilities
πŸ“Š Library Analytics Stats, quality profiles, missing content, disk usage, genre/year distributions
πŸ‘€ Viewing Analytics Current streams, watch history, most watched, peak hours, user stats
🎬 Content Management Add/remove movies & series, calendars, wanted lists, history
πŸ“ Request Handling Overseerr approval workflows, stats, bulk actions
πŸ’¬ Subtitles Bazarr wanted/search/history/languages
πŸ” Indexer Management Prowlarr indexer control, testing, cross-app sync
⬇️ Downloads SABnzbd active/speed/queue/pause/resume
🎯 Quality Profiles Recyclarr TRaSH Guides sync, diff preview
🧹 Library Cleanup Maintainerr rules, collections, exclusions
πŸ”” Notifications Notifiarr status, triggers, service health
πŸ–ΌοΈ Collections & Overlays Kometa/PMM automation for Plex
πŸ“¦ Archive Extraction Unpackerr monitoring and error tracking
πŸ“‘ Media Tracking Trakt.tv, Letterboxd, Simkl β€” sync, export, discovery
πŸ“ˆ Dashboards Self-contained HTML dashboard generation
πŸ”§ Setup & Diagnostics Auto-discovery, guided setup, troubleshooting

πŸ“¦ Install

From ClawHub (recommended)

clawhub install clawarr-suite

⚠️ Note: This skill is currently flagged for review by ClawHub's automated security scanner. The flag is a false positive β€” the scanner detected standard patterns (bash eval for env vars, WebRTC for LAN discovery, Docker commands, API key handling) that are inherent to media server management. We've submitted a review request and are waiting for the flag to be lifted.

View on ClawHub Β· Review request β†’

From GitHub

git clone https://github.com/omiron33/clawarr-suite.git ~/.openclaw/skills/clawarr-suite

Manual

Copy the clawarr-suite folder into your OpenClaw skills directory:

~/.openclaw/skills/clawarr-suite/
β”œβ”€β”€ SKILL.md          # Agent documentation (OpenClaw reads this)
β”œβ”€β”€ scripts/          # 24 bash scripts
└── references/       # 8 reference docs

2. Run setup

Tell your agent:

"Set up ClawARR for my media server at 192.168.1.100"

Or run manually:

scripts/setup.sh 192.168.1.100

This auto-discovers services, extracts API keys, verifies connections, and outputs your config.

3. Start using it

Just talk to your agent naturally:

  • "Show me what's downloading right now"
  • "What movies were added this week?"
  • "Generate a dashboard of my media library"
  • "Sync my Plex watch history to Trakt"
  • "What are the most watched shows this month?"
  • "Run Kometa to update my Plex collections"
  • "Show cleanup rules and what's flagged for deletion"

πŸ› οΈ Supported Services

Core Stack

Service Port Script
Sonarr 8989 library.sh, manage.sh, search.sh
Radarr 7878 library.sh, manage.sh, search.sh
Lidarr 8686 library.sh
Readarr 8787 library.sh
Prowlarr 9696 prowlarr.sh
Bazarr 6767 subtitles.sh
Overseerr 5055 requests.sh
Plex 32400 analytics.sh
Tautulli 8181 analytics.sh
SABnzbd 38080 downloads.sh

Companion Services

Service Port Script Purpose
Recyclarr β€” recyclarr.sh TRaSH Guides quality profile sync
Unpackerr β€” unpackerr.sh Auto-extract archives from downloads
Notifiarr 5454 notifiarr.sh Unified notification routing
Maintainerr 6246 maintainerr.sh Automated library cleanup
Kometa β€” kometa.sh Plex collections & overlays
FlareSolverr 8191 β€” Cloudflare bypass for indexers

Media Trackers

Service Script Features
Trakt.tv trakt.sh Auth, history, ratings, watchlists, scrobbling, discovery, sync
Letterboxd letterboxd.sh CSV export/import, profile stats
Simkl simkl.sh Auth, sync, watchlist, stats
Traktarr trakt.sh Auto-add from Trakt lists β†’ Radarr/Sonarr
Retraktarr trakt.sh Sync library β†’ Trakt lists

βš™οΈ Configuration

Set environment variables or use setup.sh to generate them:

# Required β€” your server's IP or hostname
export CLAWARR_HOST=192.168.1.100

# Core services (setup.sh auto-discovers these)
export SONARR_KEY=your_api_key
export RADARR_KEY=your_api_key
export PLEX_TOKEN=your_plex_token
export TAUTULLI_KEY=your_api_key
export SABNZBD_KEY=your_api_key

# Optional services
export PROWLARR_KEY=your_api_key
export BAZARR_KEY=your_api_key
export OVERSEERR_KEY=your_api_key
export NOTIFIARR_KEY=your_api_key

# Docker-based companions (SSH access to your server)
export RECYCLARR_SSH=mynas
export KOMETA_SSH=mynas
export UNPACKERR_SSH=mynas
export DOCKER_CONFIG_BASE=/opt/docker   # Default: /volume1/docker (Synology)

# Media trackers (register your own apps)
# Trakt: https://trakt.tv/oauth/applications/new
export TRAKT_CLIENT_ID=your_client_id
export TRAKT_CLIENT_SECRET=your_client_secret

# Simkl: https://simkl.com/settings/developer
export SIMKL_CLIENT_ID=your_client_id
export SIMKL_CLIENT_SECRET=your_client_secret

πŸ“– Documentation

Document Description
SKILL.md Full agent documentation β€” every command, workflow, and example. This is what OpenClaw reads.
references/api-endpoints.md Complete API reference for all services
references/setup-guide.md Platform-specific installation (Docker, Synology, Unraid, Linux)
references/common-issues.md Troubleshooting guide with solutions
references/companion-services.md Prowlarr, Recyclarr, FlareSolverr, Unpackerr, Notifiarr, Maintainerr, Kometa
references/tracker-apis.md Media tracker API documentation
references/traktarr-retraktarr.md Traktarr & Retraktarr automation guide
references/prompts.md 50+ example natural-language prompts
references/dashboard-templates.md HTML/CSS templates for dashboards

For AI agents: Read SKILL.md β€” it contains complete command references, environment variable documentation, workflows, and example prompts optimized for agent consumption.


πŸ“‹ Requirements

  • bash 3.2+ (macOS default is fine)
  • curl, jq, bc, sed β€” standard on macOS and Linux
  • SSH access for Docker-based companion services
  • No Node.js, Python, or other runtimes required

πŸ—οΈ Supported Platforms

  • Docker β€” any host
  • Synology NAS β€” DSM 7+
  • Unraid β€” Community Applications
  • Linux β€” bare metal or VM
  • macOS β€” client-side scripts (server runs elsewhere)

πŸ—ΊοΈ Roadmap

  • Torrent client support (qBittorrent, Transmission, Deluge)
  • Jellyfin / Emby analytics
  • Backup & restore workflows
  • Native OpenClaw plugin (TypeScript, in progress)

πŸ“„ License

MIT β€” see LICENSE for details.


Built for OpenClaw Β· Community Β· More Skills

About

🎬 Unified deep-integration control for self-hosted media stacks (Sonarr, Radarr, Prowlarr, Plex, Tautulli, and 10+ more). An OpenClaw agent skill.

Topics

Resources

Stars

11 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages