Introduction
# Jellyseerr
Request movies and TV shows through your Jellyseerr server for automated downloading to Plex/Jellyfin.
## Setup
Configure your Jellyseerr server:
```bash scripts/setup.sh ```
You'll need: - Jellyseerr server URL - API key (from Jellyseerr Settings > General)
## Usage
Request a movie: ```bash scripts/request_movie.py "Movie Name" ```
Request a TV show: ```bash scripts/request_tv.py "TV Show Name" ```
Search for content: ```bash scripts/search.py "Content Name" ```
## Examples
Request a movie: ```bash scripts/request_movie.py "The Matrix" ```
Request a TV show (entire series): ```bash scripts/request_tv.py "Breaking Bad" ```
Request specific TV season: ```bash 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](references/WEBHOOK_SETUP.md) for the complete guide.
Quick setup: ```bash 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:
```bash crontab -l > /tmp/cron_backup.txt echo "* * * * * $(pwd)/scripts/auto_monitor.sh" >> /tmp/cron_backup.txt crontab /tmp/cron_backup.txt ```
Check pending requests: ```bash scripts/track_requests.py ```
## Configuration
Edit `~/.config/jellyseerr/config.json`: ```json { "server_url": "https://jellyseerr.yourdomain.com", "api_key": "your-api-key", "auto_approve": true } ```
## API Reference
See [references/api.md](references/api.md) for Jellyseerr API documentation.