Overr-Syncerr

Overr-Syncerr is a PowerShell-based webhook handler that automates subtitle synchronization and user audio/subtitle preference application for media libraries. It listens to issue reports from Overseerr or Jellyseerr and coordinates actions across Sonarr, Radarr and Bazarr to fetch, translate or adjust subtitles and apply audio/subtitle preferences.

Key Features

• Integrates with Overseerr and Jellyseerr webhooks to process subtitle/audio requests
• Direct Sonarr and Radarr integration to fetch series and movie metadata
• Bazarr integration to submit sync, translate, and manual subtitle requests (including 4K and HI subtitle support)
• Language keyword mapping to detect requested subtitle languages from webhook messages
• Automatic reply and issue resolution in Overseerr/Jellyseerr after subtitles are synchronized
• Batch operations such as "sync all episodes in a season" for a given language
• Per-user automatic audio preference selection (language, codec, channel count) when media appears
• Per-user automatic subtitle preference selection (language, codec, forced/hearing-impaired flags)
• Optional subtitle translation using GPT (requires valid OpenAI API key)
• Optional Plex auto-labelling of requested media with requester username

Use Cases

• Automatically synchronize missing or out-of-sync subtitles reported by users to reduce manual intervention
• Apply individual users' audio and subtitle preferences when requested media becomes available to minimize transcoding and improve playback
• Translate subtitles into custom languages using an LLM backend for localized playback when native translations are unavailable

Limitations and Considerations

• Requires functioning instances of Overseerr/Jellyseerr, Sonarr, Radarr and Bazarr; coordination depends on those APIs and webhooks
• Optional GPT-based translation requires an external API key and may incur usage costs
• Primary implementation is PowerShell; running on non-Windows hosts may require PowerShell Core and Docker for easier deployment
• No built-in graphical management UI; configuration and troubleshooting are done via configuration files and logs

Overr-Syncerr is suitable for media server operators who want automated subtitle handling and per-user audio/subtitle preferences. It reduces manual work by chaining request tracking and subtitle/audio handling across common media tooling.