https://github.com/varthe/Redirecter
Filter and redirect media requests based on requester, keywords, age ratings, and more. Supports routing to multiple instances simultaneously.
https://github.com/varthe/Redirecter
arrs filter filtering filters jellyfin jellyseerr media mediaserver overseerr plex plex-media-server radarr sonarr
Last synced: 3 months ago
JSON representation
Filter and redirect media requests based on requester, keywords, age ratings, and more. Supports routing to multiple instances simultaneously.
- Host: GitHub
- URL: https://github.com/varthe/Redirecter
- Owner: varthe
- Created: 2024-11-17T15:12:47.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-15T12:47:46.000Z (3 months ago)
- Last Synced: 2025-07-16T04:44:24.017Z (3 months ago)
- Topics: arrs, filter, filtering, filters, jellyfin, jellyseerr, media, mediaserver, overseerr, plex, plex-media-server, radarr, sonarr
- Language: TypeScript
- Homepage:
- Size: 153 KB
- Stars: 84
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Redirecter
## Docker Compose
```yaml
services:
redirecterr:
image: varthe/redirecterr:latest
container_name: redirecterr
hostname: redirecterr
ports:
- 8481:8481
volumes:
- /path/to/config.yaml:/app/config.yaml
- /path/to/logs:/logs
environment:
- LOG_LEVEL=info
```
## Webhook setup
> [!IMPORTANT]
> Disable automatic request approval for your users
In Overseerr go to **Settings -> Notifications -> Webhook** and configure the following:
- **Enable Agent**: Enabled
- **Webhook URL**: `http://redirecterr:8481/webhook`
- **Notification Types**: Select **Request Pending Approval**
- **JSON Payload**:
```json
{
"notification_type": "{{notification_type}}",
"media": {
"media_type": "{{media_type}}",
"tmdbId": "{{media_tmdbid}}",
"status": "{{media_status}}",
"status4k": "{{media_status4k}}"
},
"request": {
"request_id": "{{request_id}}",
"requestedBy_email": "{{requestedBy_email}}",
"requestedBy_username": "{{requestedBy_username}}",
},
"{{extra}}": []
}
```
## Config
Create a `config.yaml` file with the following sections:
### Overseerr settings
```yaml
overseerr_url: ""
overseerr_api_token: ""
approve_on_no_match: true # Auto-approve if no filters match
```
### Instances
Define your Radarr/Sonarr instances
```yaml
instances:
radarr:
server_id: 0 # Match the order in Overseerr > Settings > Services (example below)
root_folder: /mnt/movies
# quality_profile_id: 1 # Optional
# approve: false # Optional (default is true)
```
- `server_id`: Starts at 0, increases left to right in Overseerr UI. [Visual example](https://github.com/user-attachments/assets/a7a60d91-0f24-42a9-bbe1-ea4f1c945e6a)
- `quality_profile_id` (Optional): Override Overseerr default. Get IDs from:
```
http:///api/v3/qualityProfile?apiKey=
```
- `approve`: Set to false to disable auto-approval.
### Filters
Filters route requests based on conditions.
```yaml
filters:
- media_type: movie
# is_4k: true # Optional
conditions:
keywords:
include: ["anime", "animation"]
contentRatings:
exclude: [12, 16]
requestedBy_username: user
max_seasons: 2
apply: radarr_anime
```
#### Fields
- `media_type`: `movie` or `tv`
- `is_4k` (Optional): Set to `true` to only match 4K requests. Set to `false` to only match non-4k requests. Leave empty to match both.
- `conditions`:
- `field`:
- `require`: All values must match
- `exclude`: None of the values must match
- `include`: At least one value matches
- `apply`: One or more instance names
> [!TIP]
> For a list of possible condition fields see [fields.md](https://github.com/varthe/Redirecterr/blob/main/fields.md)
### Sample config
```yaml
overseerr_url: ""
overseerr_api_token: ""
approve_on_no_match: true
instances:
sonarr:
server_id: 0
root_folder: "/mnt/plex/Shows"
sonarr_4k:
server_id: 1
root_folder: "/mnt/plex/Shows - 4K"
sonarr_anime:
server_id: 2
root_folder: "/mnt/plex/Anime"
filters:
# Send anime to sonarr_anime
- media_type: tv
conditions:
keywords: anime
apply: sonarr_anime
# Send everything else to sonarr and sonarr_4k instances
- media_type: tv
apply: ["sonarr", "sonarr_4k"]
```