UmlautAdaptarr

UmlautAdaptarr is a proxy tool designed to resolve issues that Sonarr, Radarr, Lidarr, and Readarr have with foreign language releases (specifically German/Umlaut characters).

It acts as a middleman between your *arr applications and your actual Indexers. It intercepts search queries and results, then modifies them so that the *arr applications can correctly identify, match, and import releases.

Key capabilities include:

• Correcting searches for titles containing Umlauts.
• Mapping German titles or TVDB/TMDB aliases back to the English titles expected by *arr applications.
• Renaming releases with poor naming conventions (e.g., missing 'GERMAN' tags) so they are recognized correctly.
• Supporting both Usenet (newznab) and Torrent (torznab) protocols.

If you do not use Prowlarr, or if you only have 1-3 indexers, you can configure the proxy directly on the indexer settings within Sonarr, Radarr, etc.

1. Set Environment Variables: Configure the required Docker environment variables.
2. Modify Indexer URL:
   • Edit the indexer you want to use.
   • Change the API URL to follow this pattern: http://localhost:5005/_/ORIGINAL_URL.
   • Example: If the original URL is https://scenenzbs.com, change it to http://localhost:5005/_/scenenzbs.com.
   • Ensure you provide the correct API Key for the original indexer.

UmlautAdaptarr can be installed using several methods:

• Docker: Use the official image on Docker Hub.
• Unraid: Search for umlautadaptarr in the Unraid app store.
• Proxmox LXC: Available via unofficial community scripts (requires manual appsettings.json configuration after installation).
• Seedbox/Binary: Use the provided shell script for manual installation.

Note: You can remove environment variables for services you are not using (e.g., if you don't use Lidarr or Readarr).

UmlautAdaptarr can be deployed using Docker Compose. The service exposes ports 5005 (main HTTP port) and 5006 (proxy port). If you follow the recommended Prowlarr + Proxy configuration, the port mappings can be removed. Configuration is handled via environment variables.

version: '3.8'
services:
  umlautadaptarr:
    build: https://github.com/PCJones/UmlautAdaptarr.git#master
    image: umlautadaptarr
    restart: unless-stopped
    ports:
      - "5005:5005"
      - "5006:5006"
    environment:
      - TZ=Europe/Berlin
      - SONARR__ENABLED=false
      - SONARR__HOST=http://localhost:8989
      - SONARR__APIKEY=APIKEY
      # ... other env vars

UmlautAdaptarr connects to various 'Arr' services (Sonarr, Radarr, Readarr, Lidarr). For each service, you can enable the integration and provide the host URL and API key.

To support multiple instances of the same service type, use indexed environment variables (e.g., SONARR__0__NAME, SONARR__1__HOST).

    environment:
      # Single instance configuration
      - SONARR__ENABLED=true
      - SONARR__HOST=http://localhost:8989
      - SONARR__APIKEY=APIKEY

      # Multiple instances configuration
      - SONARR__0__NAME=NAME 1
      - SONARR__0__ENABLED=true
      - SONARR__0__HOST=http://localhost:8989
      - SONARR__0__APIKEY=APIKEY
      - SONARR__1__NAME=NAME 2
      - SONARR__1__ENABLED=true
      - SONARR__1__HOST=http://localhost:8989
      - SONARR__1__APIKEY=APIKEY