Skip to content

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 ​

StrategieVerwende wenn...Beispielsendungen
seasonAndEpisodeNumberTitel Staffel- und Episodennummern enthalten, auch in nicht-standardmäßigen FormatenSendungen mit „Staffel 3 Folge 12" oder „S03E12" im Titel
byAbsoluteEpisodeNumberEpisoden eine einzelne fortlaufende Nummer ohne Staffeln verwendenSchloss Einstein (1000+ Episoden), Daily Soaps
itemTitleExactEpisodentitel einzigartig sind und exakt übereinstimmen müssenAnthologie-Serien mit eigenständigen Titeln pro Episode
itemTitleIncludesEpisodentitel in einem längeren String eingebettet sindTatort („Tatort: Borowski und die Kinder")
itemTitleEqualsAirdateEpisoden durch ihr Ausstrahlungsdatum identifiziert werdenheute-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 Episodennummer
  • seasonRegex (optional) - Muster zur Extraktion der Staffelnummer; ohne Angabe wird nur eine Episodennummer extrahiert
  • captureGroup (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)":

json
{
  "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 Episodennummer
  • captureGroup (optional) - Standard: die letzte Capture Group des Musters

Beispiel: Schloss Einstein

Mediathek-Titel: „Schloss Einstein (1042)", „Schloss Einstein (Folge 1043)"

json
{
  "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:

json
{
  "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:

json
{
  "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"

json
{
  "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:

  1. Der Regex-Teil extrahiert alles nach „Tatort: " aus dem Mediathek-Titel
  2. Ergebnis: "Borowski und die Kinder"
  3. Der Mediathek-Titel „Tatort: Borowski und die Kinder" enthält diesen String, die Regel trifft zu
  4. 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)

json
{
  "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"

json
{
  "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"

json
{
  "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:

  1. field - welches Mediathek-Feld durchsucht wird (normalerweise title)
  2. pattern - der auszuführende Regex
  3. captureGroup - 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:

json
"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.