Skip to content

Feld-Referenz ​

Alle Felder im FunkArr-Regelwerk-JSON-Format, nach Abschnitt geordnet.

Root-Felder ​

FeldTypPflichtStandardBeschreibung
topicstringJa-Anzeigename der Sendung oder des Films. Muss exakt mit dem Mediathek-Themenfeld übereinstimmen. Wird für die themenbasierte Suche verwendet, wenn Sonarr/Radarr eine Suche starten.
aliasesstring[]Nein[]Alternative Themennamen. FunkArr prüft Aliase, wenn das primäre Thema nicht passt. Nützlich, wenn eine Sendung unter verschiedenen Namen bei verschiedenen Sendern erscheint (z.B. „Tatort aus Österreich").
mediaobjectJa-Externe Metadaten-IDs und Medientyp. Siehe Media-Felder.
confidencenumberNein0Standard-Konfidenzwert (0.0-1.0), der auf Regeln angewendet wird, die keinen eigenen setzen. Höhere Werte bedeuten, dass Sonarr/Radarr dem Match mehr vertrauen. Verwende 1.0 für zuverlässige Matches, niedrigere Werte für unsichere.
rulesarrayJa-Geordnete Liste von Matching-Regeln. Siehe Regel-Felder.
standalonebooleanNeinfalseNur lokal. Wenn true, wird das lokale Regelwerk unverändert verwendet - die Community-Basis wird komplett ignoriert. Kein Zusammenführen findet statt.
disablestring[]Nein[]Nur lokal. Liste von Community-Regel-IDs, die beim Zusammenführen übersprungen werden. Die Regeln werden entfernt, bevor lokale Regeln angewendet werden. Jeder Wert muss einer Regel-id in der Community-Basis entsprechen.
enrichmentobjectNein-Steuert die Metadaten-Anreicherung (TVDB/TMDB) für dieses Regelwerk. Siehe Enrichment-Felder.

Media-Felder ​

Das media-Objekt verknüpft ein Regelwerk mit externen Metadaten-Anbietern, damit Sonarr und Radarr die Sendung oder den Film identifizieren können.

FeldTypPflichtStandardBeschreibung
namestringJa-Anzeigename für Sonarr/Radarr. Normalerweise identisch mit topic, kann aber abweichen (z.B. Topic „Checker Reportagen" → Media-Name „Checker Julian").
typestringJa"show"Entweder "show" oder "movie". Bestimmt, ob FunkArr Newznab-TV- oder Film-Kategorien generiert.
tvdbIdintegerNein-TheTVDB Serien- oder Film-ID. Sonarr verwendet sie für die Zuordnung. Nachschlagen auf thetvdb.com.
imdbIdstringNein-IMDb-ID im tt-Format (z.B. "tt0806910"); muss dem Muster tt + Ziffern entsprechen. Wird von Sonarr und Radarr verwendet.
tmdbIdintegerNein-TheMovieDB-ID. Radarr verwendet sie für die Film-Zuordnung.

TIP

Mindestens eine externe ID (tvdbId, imdbId oder tmdbId) wird dringend empfohlen. Ohne sie kann Sonarr/Radarr den Download möglicherweise nicht der richtigen Sendung oder dem richtigen Film zuordnen.

Regel-Felder ​

Jeder Eintrag im rules-Array definiert einen Matching-Versuch. Regeln werden in priority-Reihenfolge ausgewertet - der erste erfolgreiche Match gewinnt.

FeldTypPflichtStandardBeschreibung
idstringJa-Eindeutiger Bezeichner für diese Regel innerhalb des Regelwerks. Muss kebab-case sein (beginnt mit einem Kleinbuchstaben, danach Kleinbuchstaben, Ziffern, Bindestriche; mindestens 3 Zeichen). Wird für die Überschreibung verwendet, wenn lokale Regeln Community-Regeln ersetzen.
priorityintegerNein0Reihenfolge der Regelauswertung. Niedrigere Werte werden zuerst versucht. Bei gleicher Priorität gilt die Array-Reihenfolge.
strategystringJa-Identifikationsstrategie. Bestimmt, wie Staffel-/Episodeninformationen extrahiert werden. Siehe Strategien für Details.
confidencenumberNein-Überschreibt die Standard-Konfidenz des Regelwerks für diese spezifische Regel. Verwende einen niedrigeren Wert für unsichere Regeln (z.B. einen Fallback-Regex).
filtersobjectNein-Vorfilterbedingungen, die bestehen müssen, bevor die Identifikation versucht wird. Siehe Filter-Felder.
seasonRegexstringNein-Regex-Muster zur Extraktion einer Staffelnummer. Verwendet mit der seasonAndEpisodeNumber-Strategie (optional - ohne Angabe wird keine Staffel extrahiert). Sollte eine Capture Group enthalten.
episodeRegexstringNein-Regex-Muster zur Extraktion einer Episodennummer. Verwendet mit den Strategien seasonAndEpisodeNumber und byAbsoluteEpisodeNumber. Sollte eine Capture Group enthalten.
captureGroupintegerNeinletzte GruppeWelche Regex Capture Group für die Extraktion verwendet wird (0 = vollständiger Match, 1 = erste Gruppe, ...). Gilt für seasonRegex und episodeRegex. Ohne Angabe wird die letzte Capture Group des Musters verwendet (ohne Gruppe der vollständige Match).
titleRulesarrayNein-Titelkonstruktionsteile für die Strategien itemTitleExact und itemTitleIncludes (itemTitleEqualsAirdate erkennt das Datum automatisch und ignoriert titleRules). Siehe Titelregel-Felder.

Filter-Felder ​

Das filters-Objekt verwendet boolesche Logik, um einzugrenzen, welche Mediathek-Einträge in eine Regel gelangen. Filter laufen vor der Identifikation - wenn ein Filter fehlschlägt, wird die Regel übersprungen und die nächste Regel versucht.

Filtergruppe ​

FeldTypBeschreibung
allarrayUND - jede Bedingung muss zutreffen.
anyarrayODER - mindestens eine Bedingung muss zutreffen.
notarrayNICHT - keine der Bedingungen darf zutreffen.

Jedes Array enthält Filterknoten. Ein Knoten ist entweder eine Bedingung (Blatt) oder eine verschachtelte Filtergruppe (für komplexe Logik).

Filterbedingung ​

FeldTypPflichtBeschreibung
fieldstringJaDas zu prüfende Mediathek-Feld. Eines von: title, topic, channel, description, duration, timestamp.
opstringJaVergleichsoperator. Einer von: eq, contains, notContains, greaterThan, lessThan, regex.
valuestringJaDer Vergleichswert. Für numerische Operatoren (greaterThan, lessThan) wird die Zahl als String übergeben (z.B. "60").

Filter-Felder-Referenz ​

FeldTypBeschreibungBeispiel
titlestringDer Titel des Mediathek-Eintrags (z.B. „Tatort: Borowski und die Kinder")"Tatort:"
topicstringDer Themen-/Sendungsname (z.B. „Tatort")"Tatort"
channelstringDer Sender (z.B. „ARD", „ZDF", „ORF")"ARD"
descriptionstringBeschreibungstext des Eintrags"Krimi"
durationnumberDauer in Minuten"60"
timestampnumberAusstrahlungszeitpunkt (Unix-Epoche)"1726000000"

Filter-Operatoren-Referenz ​

OperatorBeschreibungBeispiel
eqExakter String-Vergleich (Groß-/Kleinschreibung wird ignoriert)channel eq "ARD"
containsSubstring-Match (Groß-/Kleinschreibung wird ignoriert)title contains "Tatort"
notContainsSubstring darf nicht enthalten sein (Groß-/Kleinschreibung wird ignoriert)title notContains "Trailer"
greaterThanNumerischer Größer-als-Vergleichduration greaterThan "25"
lessThanNumerischer Kleiner-als-Vergleichduration lessThan "120"
regexRegulärer-Ausdruck-Matchtitle regex "S\\d{2}E\\d{2}"

Siehe das Filter-Kochbuch für gängige Muster und Beispiele.

Titelregel-Felder ​

Titelregeln konstruieren oder extrahieren einen Titel-String Stück für Stück, von links nach rechts. Verwendet mit den Strategien itemTitleExact und itemTitleIncludes.

FeldTypPflichtBeschreibung
typestringJaEntweder "static" (fester Text) oder "regex" (aus einem Mediathek-Feld extrahieren).
valuestringNeinDer feste Text zum Anhängen. Verwendet wenn type gleich "static".
fieldstringNeinDas Mediathek-Feld, gegen das der Regex ausgeführt wird. Verwendet wenn type gleich "regex". Eines von: title, topic, channel, description. Standard: title.
patternstringNeinRegex-Muster zum Abgleich. Verwendet wenn type gleich "regex". Der gematchte Text (oder die angegebene Capture Group) wird an den konstruierten Titel angehängt.
captureGroupintegerNeinWelche Capture Group extrahiert wird (0 = vollständiger Match, 1 = erste Gruppe, etc.). Wenn weggelassen, wird die letzte Capture Group des Musters verwendet (ohne Gruppe der vollständige Match).

Beispiel ​

Dieses Titelregel-Set aus dem Tatort-Community-Regelwerk:

json
"titleRules": [
  { "type": "regex", "field": "title", "pattern": "(?<=Tatort:\\s*)\\S.*" }
]

Für den Mediathek-Titel „Tatort: Borowski und die Kinder" ergibt dies: "Borowski und die Kinder". Mit der itemTitleIncludes-Strategie muss der Mediathek-Titel diesen String enthalten; er wird danach als Episodentitel verwendet.

Enrichment-Felder ​

Das optionale enrichment-Objekt steuert, wie FunkArr Treffer mit externen Metadaten (TVDB/TMDB) anreichert. Alle Felder sind optional; ohne Angabe gelten die Standardwerte.

FeldTypStandardBeschreibung
enabledbooleantrueSchaltet die Anreicherung für dieses Regelwerk ein oder aus.
methodsstring[]["title", "airdate"]Verwendete Matching-Methoden in dieser Reihenfolge. Erlaubt: title, airdate.
title.thresholdnumber0.7Mindest-Ähnlichkeit (0.0-1.0) beim Titelvergleich.
airdate.toleranceinteger7Erlaubte Abweichung des Ausstrahlungsdatums in Tagen.
airdate.minTitleAffinitynumber0.3Mindest-Titelähnlichkeit (0.0-1.0), damit ein Datums-Match akzeptiert wird.
runtime.tolerancenumber0.35Erlaubte relative Abweichung der Laufzeit (0.0-1.0).
runtime.modestring"tiebreaker""tiebreaker" nutzt die Laufzeit nur zur Entscheidung bei Gleichstand, "filter" verwirft Kandidaten außerhalb der Toleranz.
year.toleranceinteger1Erlaubte Abweichung des Erscheinungsjahres in Jahren.
json
"enrichment": {
  "enabled": true,
  "methods": ["title", "airdate"],
  "title": { "threshold": 0.8 },
  "airdate": { "tolerance": 3, "minTitleAffinity": 0.3 },
  "runtime": { "tolerance": 0.35, "mode": "tiebreaker" },
  "year": { "tolerance": 1 }
}