Files
UmlautAdaptarr/README.md

142 lines
9.7 KiB
Markdown
Raw Normal View History

2024-02-07 04:58:04 +01:00
# UmlautAdaptarr
2024-10-11 19:24:41 +02:00
A tool to work around Sonarr, Radarr, Lidarr and Readarrs problems with foreign languages.
2024-02-12 05:10:10 +01:00
2024-10-11 19:24:41 +02:00
## Detailed English description coming soon
2024-02-07 04:58:04 +01:00
2024-10-11 19:24:41 +02:00
## Beschreibung
2024-02-12 03:46:59 +01:00
UmlautAdaptarr löst mehrere Probleme:
2024-10-11 19:24:41 +02:00
- Releases mit Umlauten werden grundsätzlich nicht korrekt von den *arrs importiert
- Releases mit Umlauten werden oft nicht korrekt gefunden (*arrs suchen nach "o" statt "ö" & es fehlt häufig die korrekte Zuordnung zur Serie/zum Film beim Indexer)
2024-02-12 04:17:00 +01:00
- Sonarr & Radarr erwarten immer den englischen Titel von https://thetvdb.com/ bzw. https://www.themoviedb.org/. Das führt bei deutschen Produktionen oder deutschen Übersetzungen oft zu Problemen - falls die *arrs schon mal etwas mit der Meldung `Found matching series/movie via grab history, but release was matched to series by ID. Automatic import is not possible/` nicht importiert haben, dann war das der Grund.
2024-09-04 18:31:03 +02:00
- Releases mit schlechtem Naming (z.B. von der Group TvR die kein "GERMAN" in den Releasename tun) werden korrigiert, so dass Sonarr&Radarr diese korrekt erkennen (optional)
2024-04-22 14:33:50 +02:00
- Zusätzlich werden einige andere Fehler behoben, die häufig dazu führen, dass Titel nicht erfolgreich gefunden, geladen oder importiert werden.
2024-02-12 03:46:59 +01:00
2024-04-22 14:33:50 +02:00
## Wie macht UmlautAdaptarr das?
2024-02-12 05:33:34 +01:00
UmlautAdaptarr tut so, als wäre es ein Indexer. In Wahrheit schaltet sich UmlautAdaptarr aber nur zwischen die *arrs und den echten Indexer und kann somit die Suchen sowie die Ergebnisse abfangen und bearbeiten.
2024-02-26 21:23:00 +01:00
Am Ende werden die gefundenen Releases immer so umbenannt, dass die Arrs sie einwandfrei erkennen.
2024-05-12 13:33:04 +02:00
Einige Beispiele finden sich [weiter unten](https://github.com/PCJones/UmlautAdaptarr?tab=readme-ov-file#beispiel-funktionalit%C3%A4t).
2024-02-12 03:46:59 +01:00
## Features
| Feature | Status |
|-------------------------------------------------------------------|---------------|
2024-10-11 19:24:41 +02:00
| Prowlarr & NZB Hydra Support |✓ |
| Sonarr Support |✓ |
| Lidarr Support |✓ |
| Readarr Support |✓ |
| Releases mit deutschem Titel werden erkannt |✓ |
| Releases mit TVDB-Alias Titel werden erkannt |✓ |
| Korrekte Suche und Erkennung von Titel mit Umlauten |✓ |
| Anfragen-Caching für 12 Minuten zur Reduzierung der API-Zugriff |✓ |
| Usenet (newznab) Support |✓ |
| Torrent (torznab) Support |✓ |
| Support von mehreren *arr-Instanzen des gleichen Typs (z.B. 2x Sonarr)|✓ |
| Releases mit mit schlechtem Naming werden korrekt umbenannt (optional) | in Arbeit|
| Radarr Support | in Arbeit |
| Webinterface | Geplant |
2024-02-12 03:46:59 +01:00
| Unterstützung weiterer Sprachen neben Deutsch | Geplant |
| Wünsche? | Vorschläge? |
2024-04-22 14:33:50 +02:00
## Installation
2025-04-14 15:30:04 +02:00
- [Docker](https://hub.docker.com/r/pcjones/umlautadaptarr)
- Unraid: nach `umlautadaptarr` suchen
2025-04-14 15:31:29 +02:00
- [Proxmox LXC (unofficial)](https://github.com/elvito/ProxmoxVE/blob/main/ct/umlautadaptarr.sh) - appsettings.json muss nach Installation konfiguriert werden
2025-04-14 15:31:56 +02:00
- [Seedbox/Binary](https://github.com/PCJones/UmlautAdaptarr/blob/master/run_on_seedbox.sh)
2024-04-22 14:33:50 +02:00
2024-10-11 19:24:41 +02:00
Nicht benötigte Umgebungsvariablen, z.B. falls Readarr oder Lidarr nicht genutzt werden, können entfernt werden.
2024-04-22 14:33:50 +02:00
2024-04-23 14:42:43 +02:00
### Konfiguration in Prowlarr (**empfohlen**)
Das ist die **empfohlene** Methode um den UmlautAdaptarr einzurichten. Sie hat den Vorteil, dass es, sofern man mehrere Indexer nutzt, keinen Geschwindigkeitsverlust bei der Suche geben sollte.
2024-04-22 14:33:50 +02:00
2024-10-11 19:24:41 +02:00
1) Setze die benötigten [Docker Umgebungsvariablen](https://hub.docker.com/r/pcjones/umlautadaptarr) in deiner docker-compose Datei bzw. in deinem docker run Befehl
2) In Prowlarr: Settings>Indexers bzw. Einstellungen>Indexer öffnen
3) Lege einen neuen HTTP-Proxy an:
2024-04-22 14:33:50 +02:00
![Image](https://github.com/PCJones/UmlautAdaptarr/assets/377223/b97418d8-d972-4e3c-9d2f-3a830a5ac0a3)
2024-04-23 17:12:14 +02:00
- Name: UmlautAdaptarr HTTP Proxy (Beispiel)
2024-04-23 14:42:43 +02:00
- Port: `5006` (Port beachten!)
2024-04-22 14:33:50 +02:00
- Tag: `umlautadaptarr`
2024-04-23 14:42:43 +02:00
- Host: Je nachdem, wie deine Docker-Konfiguration ist, kann es sein, dass du entweder `umlautadaptarr` oder `localhost`, oder ggf. die IP des Host setzen musst. Probiere es sonst einfach aus, indem du auf Test klickst.
2024-04-22 14:33:50 +02:00
- Die Username- und Passwort-Felder können leergelassen werden.
2024-10-11 19:24:41 +02:00
4) Gehe zur Indexer-Übersichtsseite
5) Für alle Indexer/Tracker, die den UmlautAdaptarr nutzen sollen:
2024-04-22 14:33:50 +02:00
![grafik](https://github.com/PCJones/UmlautAdaptarr/assets/377223/3daea3f1-7c7b-4982-84e2-ea6a42d90fba)
- Füge den `umlautadaptarr` Tag hinzu
2024-04-23 14:42:43 +02:00
- **Wichtig:** Ändere die URL von `https` zu `http`. (Dies ist erforderlich, damit der UmlautAdaptarr die Anfragen **lokal** abfangen kann. **Ausgehende** Anfragen an den Indexer verwenden natürlich weiterhin https).
2024-10-11 19:24:41 +02:00
6) Klicke danach auf `Test All Indexers` bzw `Alle Indexer Testen`. Falls du irgendwo noch `https` statt `http` stehen hast, sollte in den UmlautAdaptarr logs eine Warnung auftauchen. Mindestens solltest du aber noch ein zweites Mal alle Indexer durchgehen und überprüfen, ob überall `http` eingestellt ist - Indexer, bei denen noch `https` steht, werden nämlich einwandfrei funktionieren - allerdings ohne, dass der UmlautAdaptarr bei diesen wirken kann.
2024-04-22 14:33:50 +02:00
### Konfiguration in Sonarr/Radarr oder Prowlarr ohne Proxy
Falls du kein Prowlarr nutzt oder nur 1-3 Indexer nutzt, kannst du diese alternative Konfigurationsmöglichkeit nutzen.
2024-10-11 19:24:41 +02:00
1) Setze die benötigten [Docker Umgebungsvariablen](https://hub.docker.com/r/pcjones/umlautadaptarr) in deiner docker-compose Datei bzw. in deinem docker run Befehl
2) Bearbeite alle Indexer, bei denen der UmlautAdaptarr greifen soll, wie folgt:
2024-04-22 14:33:50 +02:00
Am Beispiel von sceneNZBs:
![grafik](https://github.com/PCJones/UmlautAdaptarr/assets/377223/07c7ca45-e0e5-4a82-af63-365bb23c55c9)
Also alles wie immer, nur dass als API-URL nicht direkt z.B. `https://scenenzbs.com` gesetzt wird, sondern
`http://localhost:5005/_/scenenzbs.com`
2024-04-23 21:38:13 +02:00
Der API-Key muss natürlich auch ganz normal gesetzt werden.
2024-04-22 14:33:50 +02:00
2024-02-12 03:46:59 +01:00
## Beispiel-Funktionalität
2024-02-07 04:58:04 +01:00
In den Klammern am Ende des Releasenamens (Bild 2 & 4) steht zu Anschauungszwecken der deutsche Titel der vorher nicht gefunden bzw. akzeptiert wurde. Das bleibt natürlich nicht so ;)
2024-02-12 13:54:16 +01:00
**Vorher:** Release wird zwar gefunden, kann aber kann nicht zu geordnet werden.
2024-02-13 22:34:49 +01:00
![Vorherige Suche ohne deutsche Titel](https://github.com/PCJones/UmlautAdaptarr/assets/377223/1fce2909-a36c-4f1b-8497-85903357fee3)
2024-02-07 04:58:04 +01:00
2024-02-12 13:54:16 +01:00
**Jetzt:** 2-3 weitere Releases werden gefunden, außerdem meckert Sonarr nicht mehr über den Namen und würde es bei einer automatischen Suche ohne Probleme importieren.
2024-02-13 22:34:49 +01:00
![Jetzige Suche mit deutschen Titeln](https://github.com/PCJones/UmlautAdaptarr/assets/377223/0edf43ba-2beb-4f22-aaf4-30f9a619dbd6)
2024-02-07 04:58:04 +01:00
2024-02-12 13:54:16 +01:00
**Vorher:** Es werden nur Releases mit dem englischen Titel der Serie gefunden
2024-02-13 22:34:49 +01:00
![Vorherige Suche, englische Titel](https://github.com/PCJones/UmlautAdaptarr/assets/377223/ed7ca0fa-ac36-4584-87ac-b29f32dd9ace)
2024-02-07 04:58:04 +01:00
2024-04-22 14:33:50 +02:00
**Jetzt:** Es werden auch Titel mit dem deutschen Namen gefunden :D
2024-02-13 22:34:49 +01:00
![Jetzige Suche, deutsche und englische Titel](https://github.com/PCJones/UmlautAdaptarr/assets/377223/1c2dbe1a-5943-4fc4-91ef-29708082900e)
2024-02-07 05:19:38 +01:00
2024-02-12 13:54:16 +01:00
**Vorher:** Die deutsche Produktion `Alone - Überlebe die Wildnis` hat auf [TheTVDB](https://thetvdb.com/series/alone-uberlebe-die-wildnis) den Englischen Namen `Alone Germany`.
2024-02-12 03:46:59 +01:00
Sonarr erwartet immer den Englischen Namen, der hier natürlich nicht gegeben ist.
2024-02-12 13:54:16 +01:00
![grafik](https://github.com/PCJones/UmlautAdaptarr/assets/377223/62158f77-ecc2-4747-af85-4b8f94f51ab4)
2024-02-12 03:46:59 +01:00
2024-02-12 13:54:16 +01:00
**Jetzt:** UmlautAdaptarr hat die Releases in `Alone Germany` umbenannt und Sonarr hat keine Probleme mehr
2024-02-12 03:46:59 +01:00
![grafik](https://github.com/PCJones/UmlautAdaptarr/assets/377223/57539ffc-b8a6-4255-a7f8-03079c10b1e8)
2024-02-12 13:54:16 +01:00
**Vorher:** Hier wird der komplette deutsche Titel im Release angegeben (also mit `- Das Lied von Eis und Feuer`) - glücklicherweise stellt uns [TheTVDB](https://thetvdb.com/series/game-of-thrones) aber diesen längeren Titel als Alias zur Verfügung - nur nutzt Sonarr diese Informationen (bisher) einfach nicht.
2024-02-12 03:46:59 +01:00
![grafik](https://github.com/PCJones/UmlautAdaptarr/assets/377223/8f3297bd-ebe4-42de-b4e6-952882c8b902)
2024-02-12 13:54:16 +01:00
**Jetzt:** UmlautAdapatarr erkennt alle auf TheTVDB angegebenen Aliase und benennt das Release in den Englischen Titel um
2024-02-12 03:46:59 +01:00
![grafik](https://github.com/PCJones/UmlautAdaptarr/assets/377223/52f0caf5-6e9d-442e-9018-ba29f954a890)
2024-02-12 04:37:56 +01:00
## Kontakt & Support
- Öffne gerne ein Issue auf GitHub falls du Unterstützung benötigst.
- [Telegram](https://t.me/pc_jones)
2025-04-28 00:01:53 +02:00
- [UsenetDE Discord Server](https://discord.gg/src6zcH4rr) -> #umlautadaptarr
2024-02-12 03:46:59 +01:00
2024-02-20 15:16:19 +01:00
## Spenden
Über eine Spende freue ich mich natürlich immer :D
2025-01-22 19:45:22 +01:00
<a href="https://www.buymeacoffee.com/pcjones" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="60px" width="217px" ></a>
<a href="https://coindrop.to/pcjones" target="_blank"><img src="https://coindrop.to/embed-button.png" style="border-radius: 10px; height: 57px !important;width: 229px !important;" alt="Coindrop.to me"></img></a>
2024-02-20 15:16:19 +01:00
Für andere Spendenmöglichkeiten gerne auf Discord oder Telegram melden - danke!
2024-02-12 03:46:59 +01:00
### Licenses & Metadata source
- TV Metadata source: https://thetvdb.com
- Movie Metadata source: https://themoviedb.org
- Licenses: TODO
2024-10-11 18:36:17 +02:00
## Star History
[![Star History Chart](https://api.star-history.com/svg?repos=pcjones/umlautadaptarr&type=Date)](https://star-history.com/#pcjones/umlautadaptarr&Date)