Jellyseerr
@EricRosenberg
npx machina-cli add skill @EricRosenberg/jellyseerr --openclawJellyseerr
Request movies and TV shows through your Jellyseerr server for automated downloading to Plex/Jellyfin.
Setup
Configure your Jellyseerr server:
scripts/setup.sh
You'll need:
- Jellyseerr server URL
- API key (from Jellyseerr Settings > General)
Usage
Request a movie:
scripts/request_movie.py "Movie Name"
Request a TV show:
scripts/request_tv.py "TV Show Name"
Search for content:
scripts/search.py "Content Name"
Examples
Request a movie:
scripts/request_movie.py "The Matrix"
Request a TV show (entire series):
scripts/request_tv.py "Breaking Bad"
Request specific TV season:
scripts/request_tv.py "Breaking Bad" --season 1
Automatic Availability Notifications
Get notified when your requested content becomes available.
Webhooks (Recommended)
For instant notifications, set up webhook integration. See references/WEBHOOK_SETUP.md for the complete guide.
Quick setup:
scripts/install_service.sh # Run with sudo
Then configure Jellyseerr to send webhooks to http://YOUR_IP:8384/
Polling (Alternative)
For environments where webhooks aren't available, use cron-based polling:
crontab -l > /tmp/cron_backup.txt
echo "* * * * * $(pwd)/scripts/auto_monitor.sh" >> /tmp/cron_backup.txt
crontab /tmp/cron_backup.txt
Check pending requests:
scripts/track_requests.py
Configuration
Edit ~/.config/jellyseerr/config.json:
{
"server_url": "https://jellyseerr.yourdomain.com",
"api_key": "your-api-key",
"auto_approve": true
}
API Reference
See references/api.md for Jellyseerr API documentation.
Overview
Jellyseerr lets you request movies and TV shows to your Jellyseerr server for automated downloading to Plex or Jellyfin. It supports searching for content availability and managing media requests, so you can keep your libraries up to date without manual digging.
How This Skill Works
Configure your Jellyseerr server with the URL and API key, then use small scripts to submit requests or search for content. The system supports automatic availability notifications via webhooks or polling to keep you informed about when your requests become available.
When to Use It
- Add a movie to your Plex/Jellyfin library via Jellyseerr
- Search for content availability across your Jellyseerr setup
- Request a TV show or an entire series
- Request a specific TV season (e.g., Breaking Bad season 1)
- Monitor and get notified when your requests become available
Quick Start
- Step 1: Run setup to configure Jellyseerr: scripts/setup.sh
- Step 2: Submit a request for media: scripts/request_movie.py 'Movie Name' or scripts/request_tv.py 'TV Show Name'
- Step 3: Enable webhooks or set up polling to receive availability notifications
Best Practices
- Keep your Jellyseerr server URL and API key secure
- Use exact titles for accurate matching
- Enable auto_approve only when you're ready to automatically approve requests
- Prefer webhooks for instant availability notifications
- Test requests with known titles before placing larger orders
Example Use Cases
- Request a movie: 'The Matrix'
- Request a TV show: 'Breaking Bad' (entire series)
- Request a TV season: 'Breaking Bad' --season 1
- Search for content: scripts/search.py 'The Matrix'
- Check pending requests: scripts/track_requests.py
