What is UmlautAdaptarr?

UmlautAdaptarr is a self-hosted proxy tool that works around Sonarr, Radarr, Lidarr, and Readarr's problems with foreign languages, particularly German umlauts. It acts as a fake indexer that intercepts search requests and results between the *arr applications and real indexers (via Prowlarr or NZB Hydra), then renames releases so the *arr apps can properly recognize and import them. Key capabilities include: correcting releases with German titles and umlauts, recognizing TVDB alias titles, fixing poorly named releases (optional), caching indexer requests for 12 minutes, supporting both Usenet (newznab) and torrent (torznab) indexers, and handling multiple *arr instances of the same type. It runs as a Docker container (ports 5005 for API, 5006 for proxy) or as a standalone .NET binary on seedboxes. Configuration is done via environment variables for each *arr instance. Radarr support and a web interface are still in development.

Should you self-host UmlautAdaptarr?

UmlautAdaptarr scores 40/100 on selfhost.directory (how scoring works) and ranks #120 of 142 in Media Management. It has 309 GitHub stars.

It shipped 3 stable releases in the past year. The latest, v0.7.6, came out on 5 August 2026. New versions land roughly every 4 months.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is written mostly in C.

Its closest alternative on selfhost.directory is Sonarr (81/100, 17 475 stars). It scores higher overall, so compare the two before you pick. See UmlautAdaptarr vs Sonarr side by side.

Features

German title recognition
German umlaut correction
Indexer request caching
Multi-language SupportPlanned
Multiple *arr instances
Poor release naming correctionIn development
Radarr SupportIn development
Torrent (torznab) support
TVDB alias title support
Usenet (newznab) support
Web InterfacePlanned

How to install UmlautAdaptarr

Install UmlautAdaptarr with Docker

docker run -d
--name umlautadaptarr
--restart unless-stopped
-p 5005:5005
-p 5006:5006
-e TZ=Europe/Berlin
-e SONARR__ENABLED=false
-e SONARR__HOST=http://localhost:8989
-e SONARR__APIKEY=APIKEY
-e RADARR__ENABLED=false
-e RADARR__HOST=http://localhost:7878
-e RADARR__APIKEY=APIKEY
-e READARR__ENABLED=false
-e READARR__HOST=http://localhost:8787
-e READARR__APIKEY=APIKEY
-e LIDARR__ENABLED=false
-e LIDARR__HOST=http://localhost:8686
-e LIDARR__APIKEY=APIKEY
pcjones/umlautadaptarr:latest

Main Docker installation method

Install UmlautAdaptarr with Docker Compose

services: umlautadaptarr: image: pcjones/umlautadaptarr:latest restart: unless-stopped ports: - "5005:5005" # can be removed if you use the recommended prowlarr+proxy configuration - "5006:5006" # can be removed if you use the alternative, non-proxy configuration environment: - TZ=Europe/Berlin - SONARR__ENABLED=false - SONARR__HOST=http://localhost:8989 - SONARR__APIKEY=APIKEY - RADARR__ENABLED=false - RADARR__HOST=http://localhost:7878 - RADARR__APIKEY=APIKEY - READARR__ENABLED=false - READARR__HOST=http://localhost:8787 - READARR__APIKEY=APIKEY - LIDARR__ENABLED=false - LIDARR__HOST=http://localhost:8686 - LIDARR__APIKEY=APIKEY

Docker Compose installation method

Install UmlautAdaptarr with Linux

Environment variables

TZ, SONARR__ENABLED, SONARR__HOST, SONARR__APIKEY, RADARR__ENABLED, RADARR__HOST, RADARR__APIKEY, READARR__ENABLED, READARR__HOST, READARR__APIKEY, LIDARR__ENABLED, LIDARR__HOST, LIDARR__APIKEY, SETTINGS__ApiKey, SETTINGS__ProxyPort, SETTINGS__IndexerRequestsCacheDurationInMinutes, ASPNETCORE_CONTENTROOT, Kestrel__Endpoints__Http__Url

#!/bin/bash

Download linux binary from https://github.com/PCJones/UmlautAdaptarr/releases

script by schumi4 - THX!

#seedbox fix export DOTNET_GCHeapHardLimit=20000000

Basic Configuration

export TZ=Europe/Berlin

Sonarr Configuration

export SONARR__ENABLED=true export SONARR__HOST=https://name.server.usbx.me/sonarr/ export SONARR__APIKEY=APIKEY

Radarr Configuration

export RADARR__ENABLED=false export RADARR__HOST=http://localhost:7878 export RADARR__APIKEY=APIKEY

Readarr Configuration

export READARR__ENABLED=false export READARR__HOST=http://localhost:8787 export READARR__APIKEY=APIKEY

Lidarr Configuration

export LIDARR__ENABLED=false export LIDARR__HOST=http://localhost:8686 export LIDARR__APIKEY=APIKEY

Multiple Sonarr Instances (commented out by default)

#export SONARR__0__NAME="NAME 1" #export SONARR__0__ENABLED=false #export SONARR__0__HOST=http://localhost:8989 #export SONARR__0__APIKEY=APIKEY #export SONARR__1__NAME="NAME 2" #export SONARR__1__ENABLED=false #export SONARR__1__HOST=http://localhost:8989 #export SONARR__1__APIKEY=APIKEY

Advanced Options

#export IpLeakTest__Enabled=false #export SETTINGS__IndexerRequestsCacheDurationInMinutes=12 export ASPNETCORE_CONTENTROOT="./publish" export SETTINGS__ApiKey="apikey" # Change to something unique! Then in Prowlarr, in the proxy settings set any username and use this ApiKey as password. export SETTINGS__ProxyPort=1234 # Port for Proxy export Kestrel__Endpoints__Http__Url="http://[::]:1235" # Port for UmlautAdaptarr API

chmod +x ./publish/UmlautAdaptarr

./publish/UmlautAdaptarr

Run as standalone binary on seedboxes

How to configure UmlautAdaptarr

ASPNETCORE_CONTENTROOT./publishContent root path for the application
Content root path for the application
values: Any valid path
DOTNET_GCHeapHardLimit20000000GC heap hard limit for seedbox environments
GC heap hard limit for seedbox environments
values: Any positive integer
IpLeakTest__EnabledfalseEnable IP leak test
Enable IP leak test
values: true, false
Kestrel__Endpoints__Http__Urlhttp://[::]:1235Kestrel HTTP endpoint URL
Kestrel HTTP endpoint URL
values: Any valid URL
LIDARR__APIKEYAPIKEYLidarr API key
Lidarr API key
values: Your Lidarr API key
LIDARR__ENABLEDfalseEnable Lidarr integration
Enable Lidarr integration
values: true, false
LIDARR__HOSThttp://localhost:8686Lidarr host URL
Lidarr host URL
values: Any valid URL
RADARR__APIKEYAPIKEYRadarr API key
Radarr API key
values: Your Radarr API key
RADARR__ENABLEDfalseEnable Radarr integration
Enable Radarr integration
values: true, false
RADARR__HOSThttp://localhost:7878Radarr host URL
Radarr host URL
values: Any valid URL
READARR__APIKEYAPIKEYReadarr API key
Readarr API key
values: Your Readarr API key
READARR__ENABLEDfalseEnable Readarr integration
Enable Readarr integration
values: true, false
READARR__HOSThttp://localhost:8787Readarr host URL
Readarr host URL
values: Any valid URL
SETTINGS__ApiKeyapikeyAPI key for Prowlarr proxy authentication
API key for Prowlarr proxy authentication
values: Any unique string
SETTINGS__IndexerRequestsCacheDurationInMinutes12Cache duration for indexer requests in minutes
Cache duration for indexer requests in minutes
values: Any positive integer
SETTINGS__ProxyPort1234Port for the HTTP proxy
Port for the HTTP proxy
values: Any valid port number
SONARR__APIKEYAPIKEYSonarr API key
Sonarr API key
values: Your Sonarr API key
SONARR__ENABLEDfalseEnable Sonarr integration
Enable Sonarr integration
values: true, false
SONARR__HOSThttp://localhost:8989Sonarr host URL
Sonarr host URL
values: Any valid URL
TZEurope/BerlinTimezone for the container
Timezone for the container
values: Any valid IANA timezone