Matching-Strategien
Jede Regel hat eine Strategie, die bestimmt, wie FunkArr Staffel-/Episodeninformationen aus einem Mediathek-Eintrag extrahiert. Die Wahl der richtigen Strategie hängt davon ab, wie die Titel der Sendung strukturiert sind.
Strategieauswahl
| Strategie | Verwende wenn... | Beispielsendungen |
|---|---|---|
seasonAndEpisodeNumber | Titel Staffel- und Episodennummern enthalten, auch in nicht-standardmäßigen Formaten | Sendungen mit „Staffel 3 Folge 12" oder „S03E12" im Titel |
byAbsoluteEpisodeNumber | Episoden eine einzelne fortlaufende Nummer ohne Staffeln verwenden | Schloss Einstein (1000+ Episoden), Daily Soaps |
itemTitleExact | Episodentitel einzigartig sind und exakt übereinstimmen müssen | Anthologie-Serien mit eigenständigen Titeln pro Episode |
itemTitleIncludes | Episodentitel in einem längeren String eingebettet sind | Tatort („Tatort: Borowski und die Kinder") |
itemTitleEqualsAirdate | Episoden durch ihr Ausstrahlungsdatum identifiziert werden | heute-show, Die Sendung mit der Maus, Talkshows |
seasonAndEpisodeNumber
Extrahiert eine Staffel- und Episodennummer aus dem Mediathek-Titel mittels Regex-Mustern.
Wann verwenden: Der Titel enthält Staffel- und Episodeninformationen in beliebigem Format - deutsch („Staffel 3 Folge 12"), abgekürzt („S03/E12") oder in Klammern eingebettet.
Benötigte Felder:
episodeRegex- Muster zur Extraktion der EpisodennummerseasonRegex(optional) - Muster zur Extraktion der Staffelnummer; ohne Angabe wird nur eine Episodennummer extrahiertcaptureGroup(optional) - welche Capture Group verwendet wird; gilt für beide Regex (Standard: die letzte Capture Group des Musters)
Beispiel:
Für eine Sendung mit Titeln wie „Feuer und Flamme (S03/E05)":
{
"id": "regex-se",
"priority": 0,
"strategy": "seasonAndEpisodeNumber",
"seasonRegex": "S(\\d{2})",
"episodeRegex": "E(\\d{2})",
"filters": {
"all": [
{ "field": "duration", "op": "greaterThan", "value": "20" }
]
}
}Der seasonRegex erfasst 03 aus „S03", und der episodeRegex erfasst 05 aus „E05".
TIP
Der Regex sollte eine Capture Group () enthalten. Ohne captureGroup extrahiert FunkArr den Inhalt der letzten Capture Group des Musters (ohne Gruppe: den ganzen Match). Verwende captureGroup, um eine bestimmte Gruppe auszuwählen (0 = vollständiger Match). Matcht der Regex nicht oder ist die Gruppe leer, scheitert die Regel. Alle Regex haben ein Timeout von 100 ms.
byAbsoluteEpisodeNumber
Extrahiert eine einzelne absolute Episodennummer ohne Staffel. Sonarr ordnet sie intern über seinen Episodenguide der richtigen Staffel zu.
Wann verwenden: Langlaufende Sendungen, die einen einzelnen fortlaufenden Episodenzähler verwenden. Häufig bei deutschen Kindersendungen und täglichen Serien.
Benötigte Felder:
episodeRegex- Muster zur Extraktion der EpisodennummercaptureGroup(optional) - Standard: die letzte Capture Group des Musters
Beispiel: Schloss Einstein
Mediathek-Titel: „Schloss Einstein (1042)", „Schloss Einstein (Folge 1043)"
{
"id": "absolute-episode",
"priority": 0,
"filters": {
"all": [
{ "field": "duration", "op": "greaterThan", "value": "15" }
]
},
"strategy": "byAbsoluteEpisodeNumber",
"episodeRegex": "\\((\\d{3,5})\\)"
}Der Regex \((\d{3,5})\) matcht eine 3-bis-5-stellige Zahl in Klammern und extrahiert sie. Für „Schloss Einstein (1042)" ist die extrahierte Episodennummer 1042.
Eine zweite Regel mit niedrigerer Priorität behandelt die „Folge"-Variante:
{
"id": "absolute-episode-p1",
"priority": 1,
"strategy": "byAbsoluteEpisodeNumber",
"episodeRegex": "\\(Folge (\\d{3,5})\\)"
}itemTitleExact
Konstruiert einen Titel-String aus Teilen und gleicht ihn exakt mit dem Mediathek-Titel ab (Groß-/Kleinschreibung wird ignoriert). Der konstruierte Titel muss dem vollständigen Mediathek-Titel entsprechen. Anschließend wird er als Episodentitel für das Matching mit Sonarr/Radarr und die Metadaten-Anreicherung verwendet.
Wann verwenden: Episodentitel sind einzigartig und vorhersagbar. Der Mediathek-Titel enthält den Episodentitel wörtlich oder er kann sauber extrahiert werden.
Benötigte Felder:
titleRules- Array von Titelteilen (fester Text und/oder Regex-Extraktionen)
Beispiel:
Für eine Sendung, bei der der Mediathek-Titel exakt dem Episodentitel entspricht:
{
"id": "title-exact",
"priority": 0,
"strategy": "itemTitleExact",
"titleRules": [
{ "type": "regex", "field": "title", "pattern": "^(.+)$" }
]
}itemTitleIncludes
Konstruiert einen Titel-String aus Teilen und prüft, ob der Mediathek-Titel ihn als Substring enthält (Groß-/Kleinschreibung wird ignoriert, Umlaute werden normalisiert: ä = ae, ö = oe, ü = ue, ß = ss). Nachsichtiger als exaktes Matching.
Wann verwenden: Episodentitel sind im Mediathek-Titel mit zusätzlicher Formatierung eingebettet, oder wenn exaktes Matching zu fragil ist.
Benötigte Felder:
titleRules- Array von Titelteilen
Beispiel: Tatort
Mediathek-Titel: „Tatort: Borowski und die Kinder", „Tatort: Der letzte Schrei"
{
"id": "title-includes",
"priority": 0,
"filters": {
"all": [
{ "field": "duration", "op": "greaterThan", "value": "35" }
]
},
"strategy": "itemTitleIncludes",
"titleRules": [
{
"type": "regex",
"field": "title",
"pattern": "(?<=Tatort:\\s*)\\S.*"
}
]
}So funktioniert es:
- Der Regex-Teil extrahiert alles nach „Tatort: " aus dem Mediathek-Titel
- Ergebnis:
"Borowski und die Kinder" - Der Mediathek-Titel „Tatort: Borowski und die Kinder" enthält diesen String, die Regel trifft zu
- Der konstruierte Titel dient danach als Episodentitel für das Matching in Sonarr
Das Tatort-Regelwerk enthält eine zweite Regel mit Priorität 1 und einem toleranteren Regex für Sonderfälle, in denen das Titelformat abweicht.
Beispiel: Film-Matching (Apocalypse Now)
{
"id": "title-match",
"priority": 0,
"filters": {
"all": [
{ "field": "topic", "op": "contains", "value": "Spielfilm" }
]
},
"strategy": "itemTitleIncludes",
"titleRules": [
{ "type": "static", "value": "Apocalypse Now" }
]
}Dies matcht jeden Eintrag im „Spielfilm"-Thema, der „Apocalypse Now" im Titel enthält.
itemTitleEqualsAirdate
Extrahiert ein Ausstrahlungsdatum aus dem Mediathek-Titel. Verwendet für Sendungen, die über ihr Ausstrahlungsdatum statt Staffel-/Episodennummern identifiziert werden.
Wann verwenden: Talkshows, Nachrichtensendungen, Wochenmagazine und tägliche Sendungen, bei denen Episoden über das Ausstrahlungsdatum identifiziert werden.
Benötigte Felder: keine. Das Datum wird automatisch aus dem Titel erkannt; titleRules, seasonRegex, episodeRegex und captureGroup werden von dieser Strategie ignoriert.
Erkannte Datumsformate:
- numerisch:
15.09.2026,5.9.26(zweistellige Jahre werden als 20xx interpretiert) - ausgeschrieben:
13. September 2026
Das Datum wird im Format yyyy-MM-dd weitergegeben. Findet sich im Titel kein Datum, scheitert die Regel. Nutze filters, um die Regel auf passende Einträge einzuschränken.
Beispiel: heute-show
Mediathek-Titel: „heute-show vom 13. September 2026"
{
"id": "airdate",
"priority": 0,
"filters": {
"all": [
{ "field": "duration", "op": "greaterThan", "value": "25" }
]
},
"strategy": "itemTitleEqualsAirdate"
}FunkArr erkennt „13. September 2026" im Titel, parst es in ein Datum und ordnet es der Episode mit diesem Ausstrahlungsdatum in Sonarr zu.
Beispiel: Die Sendung mit der Maus
Mediathek-Titel verwenden ein numerisches Datumsformat: „Die Sendung mit der Maus 15.09.2026"
{
"id": "airdate",
"priority": 0,
"filters": {
"all": [
{ "field": "duration", "op": "greaterThan", "value": "21" }
]
},
"strategy": "itemTitleEqualsAirdate"
}TIP
Für datumsbasierte Sendungen setze den Serientyp in Sonarr auf Daily. Ohne dies sucht Sonarr nicht nach Episoden anhand des Datums.
Titelkonstruktion im Detail
Titelregeln (titleRules) bauen einen String auf, indem sie Teile von links nach rechts anhängen. Jeder Teil ist entweder:
- Statisch - hängt festen Text an
- Regex - führt einen Regex gegen ein Mediathek-Feld aus und hängt den Match an
Auswertungsreihenfolge
Teil 1 Teil 2 Teil 3
[statisch] → [regex] → [statisch] → fertiger Titel
"Folge: " "Borowski" "!" "Folge: Borowski!"Regex-Teile
Ein Regex-Teil hat drei Komponenten:
field- welches Mediathek-Feld durchsucht wird (normalerweisetitle)pattern- der auszuführende RegexcaptureGroup- welche Gruppe extrahiert wird (Standard: die letzte Capture Group des Musters, ohne Gruppe der vollständige Match;0= immer vollständiger Match)
Wenn der Regex nicht matcht oder das Ergebnis leer ist, scheitert die gesamte Regel bei der Identifikation. Ohne field wird title verwendet; als field sind bei Regex-Teilen title, topic, channel und description möglich.
Mehrere Regeln für Robustheit
Reale Mediathek-Titel variieren. Ein gängiges Muster ist, mehrere Regeln mit aufsteigender Priorität zu definieren - die erste behandelt den Standardfall, Fallback-Regeln behandeln Sonderfälle:
"rules": [
{
"id": "main",
"priority": 0,
"strategy": "itemTitleIncludes",
"titleRules": [{ "type": "regex", "field": "title", "pattern": "striktes-muster" }]
},
{
"id": "fallback",
"priority": 1,
"strategy": "itemTitleIncludes",
"titleRules": [{ "type": "regex", "field": "title", "pattern": "tolerantes-muster" }]
}
]Priorität 0 wird zuerst versucht. Wenn sie fehlschlägt (Regex matcht nicht oder Filter lehnt den Kandidaten ab), bekommt Priorität 1 eine Chance.