Der Server weiss jetzt mehr als Titel und Plakat

Bisher standen zu einem Film vier Angaben in der Datenbank: Titel, Jahr,
Beschreibung, zwei Bilder. Damit lässt sich eine Kachel zeichnen und sonst
nichts — keine Detailseite, die mehr sagt als der Dateiname, keine
Vorschläge, kein Filter nach Genre. Alles drei hing daran.

Jetzt kommen dazu: **Laufzeit, Bewertung, Werbezeile, Altersfreigabe,
Genres, Besetzung, Stab — und der Schriftzug des Titels.** Letzterer ist
das, was eine Startseite teuer aussehen lässt: „Blade Runner 2049" in seiner
eigenen Schrift über dem Hintergrundbild statt in der Systemschrift.

**Alles in einer Anfrage.** `append_to_response` hängt Besetzung,
Fremdkennungen, Freigaben und Bilder an den Einzelabruf. Vier getrennte
Anfragen je Titel wären bei vierhundert Filmen sechzehnhundert, und TMDB
begrenzt, wie oft man fragen darf. Der eigene Abruf der IMDb-Kennung ist
dabei entfallen — sie hängt jetzt mit dran.

Freigaben sind national: die FSK gilt in Deutschland, die MPAA in den USA,
und TMDB führt beide nebeneinander. Genommen wird die des eingestellten
Landes. Beim Schriftzug entscheidet zuerst die Sprache und erst danach die
Bildbewertung — ein deutscher Titel in deutscher Schrift schlägt den besser
bewerteten englischen.

Vom Stab nur Regie und Drehbuch. TMDB führt dort auch Beleuchter und
Caterer; eine Detailseite, die alle nennt, nennt nichts.

**Genres und Personen als eigene Tabellen**, nicht als Text im Film. Sonst:
filtern über `LIKE`, Tippfehler als eigenes Genre, und bei einer Umbenennung
vierhundert Zeilen anfassen. Personen über die Kennung der Quelle geführt,
nicht über den Namen — es gibt zwei Schauspieler namens „Chris Evans".

Darauf sitzen zwei neue Endpunkte: ein Filter nach Genre (nur die, die in
der Mediathek auch vorkommen — ein Knopf zu einer leeren Liste ist schlimmer
als kein Knopf) und **Vorschläge** über die Genres des zuletzt Gesehenen.
Keine Empfehlungsmaschine: ein Haushaltsserver hat keine Millionen
Sehverläufe, aus denen sich etwas lernen liesse. Eine schlichte Regel ist
nachvollziehbar, was eine undurchschaubare Empfehlung nie ist.

---

**Zwei Fehler, beide fand erst der echte Lauf.**

`UNIQUE constraint failed: Genres.Name`, und damit scheiterte der ganze
Scan — in der Mediathek erschien kein einziger Titel. Vier Bibliotheken
scannen gleichzeitig, jede mit eigenem Datenbankkontext; zwei stossen auf
„Drama", keine sieht die ungespeicherte Zeile der anderen. Statt die Läufe
zu serialisieren — das kostete bei zehn Bibliotheken das Zehnfache an Zeit —
wird der Fehlschlag hingenommen und die Zeile des anderen benutzt. Sie steht
ja genau dafür da.

Und: **eine geänderte Sprache erreichte vorhandene Titel nie.** Ein zweiter
Scan fragt nichts erneut, das ist Absicht. Wer aber von Englisch auf Deutsch
stellt, bekam deutsche Titel erst beim nächsten neuen Film. Dafür gibt es
jetzt „Metadaten auffrischen" je Bibliothek — geholt über die bekannte
Kennung, nicht über eine neue Suche, damit eine Zuordnung von Hand
stehenbleibt.

368 Tests grün, zehn davon neu. Am Container nachgewiesen: „Der Untergang",
156 Minuten, FSK 12, Bewertung 7,9, Genres Drama/Historie/Kriegsfilm,
22 Mitwirkende mit Rollennamen, Schriftzug und Hintergrund da — und nach dem
Umstellen auf de-DE heisst er nicht mehr „Downfall".

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Scarriffle
2026-10-03 23:12:35 +02:00
co-authored by Claude Opus 5
parent 230beb9664
commit ede4069cd4
15 changed files with 2337 additions and 61 deletions
+245 -33
View File
@@ -38,6 +38,19 @@ public sealed class TmdbClient(
private const string PosterSize = "w500";
private const string BackdropSize = "w1280";
private const string StillSize = "w300";
/// <summary>Porträts sind klein und viele — ein Kopf je Kachel.</summary>
private const string ProfileSize = "w185";
/// <summary>Schriftzüge sind breit und flach — w500 reicht auch gross.</summary>
private const string LogoSize = "w500";
/// <summary>Wie viele Darsteller je Titel übernommen werden.</summary>
///
/// <remarks>
/// TMDB nennt bei grossen Produktionen über hundert. Eine Besetzungsliste,
/// die man scrollen muss, bis die Statisten kommen, hilft niemandem — und
/// jede Zeile ist ein Porträt, das heruntergeladen und abgelegt wird.
/// </remarks>
private const int HöchstensDarsteller = 20;
private static readonly JsonSerializerOptions Json = new(JsonSerializerDefaults.Web);
@@ -58,7 +71,13 @@ public sealed class TmdbClient(
{
var treffer = await SuchenAsync<TmdbMovie>("search/movie", title,
year is { } j ? ("year", j.ToString()) : null, m => m.Title, ct);
return treffer is null ? null : await MitImdb(Als(treffer, title), "movie", ct);
if (treffer is null) return null;
// **Der Treffer der Suche taugt nur als Kennung.** `search/movie`
// liefert weder Laufzeit noch Genres noch Besetzung; dafür braucht es
// den Einzelabruf. Der kostet eine Anfrage — dieselbe, die vorher
// ohnehin für die IMDb-Kennung fällig war.
return await GetMovieAsync(treffer.Id, ct) ?? Als(treffer, title);
}
public async Task<IReadOnlyList<MovieMetadata>> SearchMoviesAsync(
@@ -74,9 +93,36 @@ public sealed class TmdbClient(
var einstellung = await einstellungen.GetAsync(ct);
if (string.IsNullOrWhiteSpace(einstellung.ApiKey)) return null;
// **Alles in einer Anfrage.** `append_to_response` hängt Besetzung,
// Fremdkennungen und Freigaben an den Einzelabruf. Drei getrennte
// Anfragen je Titel wären bei vierhundert Filmen zwölfhundert — und
// TMDB begrenzt, wie oft man fragen darf.
var film = await HolenAsync<TmdbMovie>(
$"movie/{providerId}?language={Uri.EscapeDataString(einstellung.Language)}", einstellung, ct);
return film is null ? null : await MitImdb(Als(film, ""), "movie", ct);
$"movie/{providerId}?language={Uri.EscapeDataString(einstellung.Language)}" +
"&append_to_response=credits,external_ids,release_dates,images" +
// **Sprachlos ist erwünscht.** Viele Schriftzüge tragen gar keine
// Sprache (`null`), weil sie keinen Text enthalten, der übersetzt
// werden müsste. Ohne diese Angabe liefert TMDB sie nicht mit.
$"&include_image_language={Uri.EscapeDataString(Sprachkürzel(einstellung.Language))},en,null",
einstellung, ct);
// **Kennung null gibt es bei TMDB nicht.** Antwortet etwas anderes
// als der erwartete Einzelabruf — ein Anmeldeportal, ein Proxy, eine
// Trefferliste —, liest der Dekoder daraus eine Null. Das als Treffer
// durchzulassen hiesse, einen Film mit der Kennung 0 anzulegen.
if (film is null or { Id: 0 }) return null;
return Als(film, "") with
{
ImdbId = Leer(film.ExternalIds?.ImdbId),
RuntimeMinutes = film.Runtime > 0 ? film.Runtime : null,
Rating = film.VoteAverage > 0 ? film.VoteAverage : null,
Tagline = Leer(film.Tagline),
ContentRating = Freigabe(film.ReleaseDates, Land(einstellung.Language)),
Genres = Namen(film.Genres),
Credits = Mitwirkende(film.Credits),
Logo = Schriftzug(film.Images, Sprachkürzel(einstellung.Language)),
};
}
private static MovieMetadata Als(TmdbMovie roh, string rückfall) => new(
@@ -87,7 +133,8 @@ public sealed class TmdbClient(
{
var treffer = await SuchenAsync<TmdbSeries>("search/tv", title,
year is { } j ? ("first_air_date_year", j.ToString()) : null, s => s.Name, ct);
return treffer is null ? null : await MitImdb(Als(treffer, title), "tv", ct);
if (treffer is null) return null;
return await GetSeriesAsync(treffer.Id, ct) ?? Als(treffer, title);
}
public async Task<IReadOnlyList<SeriesMetadata>> SearchSeriesAsync(
@@ -104,39 +151,34 @@ public sealed class TmdbClient(
if (string.IsNullOrWhiteSpace(einstellung.ApiKey)) return null;
var serie = await HolenAsync<TmdbSeries>(
$"tv/{providerId}?language={Uri.EscapeDataString(einstellung.Language)}", einstellung, ct);
return serie is null ? null : await MitImdb(Als(serie, ""), "tv", ct);
$"tv/{providerId}?language={Uri.EscapeDataString(einstellung.Language)}" +
"&append_to_response=credits,external_ids,content_ratings,images" +
$"&include_image_language={Uri.EscapeDataString(Sprachkürzel(einstellung.Language))},en,null",
einstellung, ct);
if (serie is null or { Id: 0 }) return null;
return Als(serie, "") with
{
ImdbId = Leer(serie.ExternalIds?.ImdbId),
// Die übliche Länge einer Folge, nicht die der ganzen Serie.
RuntimeMinutes = serie.EpisodeRunTime?.FirstOrDefault(l => l > 0),
Rating = serie.VoteAverage > 0 ? serie.VoteAverage : null,
Tagline = Leer(serie.Tagline),
ContentRating = Freigabe(serie.ContentRatings, Land(einstellung.Language)),
Genres = Namen(serie.Genres),
Credits = Mitwirkende(serie.Credits),
Logo = Schriftzug(serie.Images, Sprachkürzel(einstellung.Language)),
};
}
private static SeriesMetadata Als(TmdbSeries roh, string rückfall) => new(
roh.Id, roh.Name ?? rückfall, JahrAus(roh.FirstAirDate), Leer(roh.Overview),
Bild(roh.PosterPath, PosterSize), Bild(roh.BackdropPath, BackdropSize));
/// <summary>Holt die IMDb-Kennung nach — eine Anfrage je neuem Treffer.</summary>
///
/// <remarks>
/// <b>Die Suche bei TMDB liefert sie nicht mit.</b> Gebraucht wird sie für
/// die NFO-Datei: wer später auf ein anderes Werkzeug wechselt, findet
/// damit denselben Titel wieder, auch wenn das Werkzeug TMDB gar nicht
/// kennt.
///
/// Scheitert der Nachschlag, bleibt sie leer — das ist kein Grund, den
/// ganzen Treffer wegzuwerfen.
/// </remarks>
private async Task<MovieMetadata> MitImdb(MovieMetadata film, string art, CancellationToken ct) =>
film with { ImdbId = await ImdbAsync(art, film.ProviderId, ct) };
private async Task<SeriesMetadata> MitImdb(SeriesMetadata serie, string art, CancellationToken ct) =>
serie with { ImdbId = await ImdbAsync(art, serie.ProviderId, ct) };
private async Task<string?> ImdbAsync(string art, int kennung, CancellationToken ct)
{
var einstellung = await einstellungen.GetAsync(ct);
if (string.IsNullOrWhiteSpace(einstellung.ApiKey)) return null;
var fremde = await HolenAsync<TmdbExternalIds>($"{art}/{kennung}/external_ids", einstellung, ct);
return Leer(fremde?.ImdbId);
}
// Der eigene Abruf von `external_ids` ist entfallen: die Kennung hängt
// jetzt über `append_to_response` am Einzelabruf. Das spart eine Anfrage
// je Titel — bei vierhundert Filmen vierhundert.
public async Task<EpisodeMetadata?> FindEpisodeAsync(
int seriesProviderId, int season, int episode, CancellationToken ct = default)
@@ -261,6 +303,115 @@ public sealed class TmdbClient(
return index < 0 ? pfadMitAbfrage : pfadMitAbfrage[..index] + "api_key=…";
}
/// <summary>Das Land aus einer Sprachangabe wie „de-DE".</summary>
///
/// <remarks>
/// Freigaben sind national: die FSK gilt in Deutschland, die MPAA in den
/// USA, und TMDB führt beide nebeneinander. Steht kein Land dabei, ist
/// „US" die Angabe, die am häufigsten gefüllt ist — besser als keine.
/// </remarks>
private static string Land(string sprache)
{
var teile = sprache.Split('-');
return teile.Length > 1 && teile[1].Length == 2 ? teile[1].ToUpperInvariant() : "US";
}
/// <summary>„de" aus „de-DE".</summary>
private static string Sprachkürzel(string sprache) =>
sprache.Split('-')[0].ToLowerInvariant();
/// <summary>Der Schriftzug, möglichst in der eingestellten Sprache.</summary>
///
/// <remarks>
/// <b>Die Reihenfolge ist die Aussage.</b> Erst die eigene Sprache — ein
/// deutscher Filmtitel in deutscher Schrift —, dann der ohne Sprache
/// (meist ein reines Bildzeichen, überall richtig), dann Englisch. Erst
/// innerhalb einer Stufe entscheidet die Bewertung bei TMDB, weil es dort
/// um Bildqualität geht und nicht mehr um die Sprache.
/// </remarks>
private static RemoteImage? Schriftzug(TmdbImages? bilder, string sprache)
{
var alle = bilder?.Logos?.Where(l => !string.IsNullOrWhiteSpace(l.FilePath)).ToList();
if (alle is not { Count: > 0 }) return null;
var beste = alle
.OrderBy(l => string.Equals(l.Language, sprache, StringComparison.OrdinalIgnoreCase) ? 0
: string.IsNullOrEmpty(l.Language) ? 1
: string.Equals(l.Language, "en", StringComparison.OrdinalIgnoreCase) ? 2
: 3)
.ThenByDescending(l => l.VoteAverage ?? 0)
.First();
return Bild(beste.FilePath, LogoSize);
}
private static string? Freigabe(TmdbReleaseDates? quelle, string land) =>
Leer(quelle?.Results?
.FirstOrDefault(r => string.Equals(r.Country, land, StringComparison.OrdinalIgnoreCase))?
.Releases?
.Select(r => r.Certification)
.FirstOrDefault(c => !string.IsNullOrWhiteSpace(c)));
private static string? Freigabe(TmdbContentRatings? quelle, string land) =>
Leer(quelle?.Results?
.FirstOrDefault(r => string.Equals(r.Country, land, StringComparison.OrdinalIgnoreCase))?
.Rating);
private static IReadOnlyList<string>? Namen(List<TmdbGenre>? genres)
{
var liste = genres?
.Select(g => g.Name?.Trim())
.Where(n => !string.IsNullOrEmpty(n))
.Select(n => n!)
.Distinct(StringComparer.OrdinalIgnoreCase)
.ToList();
return liste is { Count: > 0 } ? liste : null;
}
/// <summary>Darsteller, Regie und Drehbuch — in dieser Reihenfolge.</summary>
///
/// <remarks>
/// <b>Aus dem Stab nur zwei Rollen.</b> TMDB führt dort auch Beleuchter
/// und Caterer; eine Detailseite, die alle nennt, nennt nichts. Regie und
/// Drehbuch sind das, wonach jemand sucht.
/// </remarks>
private static IReadOnlyList<CreditMetadata>? Mitwirkende(TmdbCredits? quelle)
{
if (quelle is null) return null;
var liste = new List<CreditMetadata>();
foreach (var d in (quelle.Cast ?? []).OrderBy(c => c.Order ?? int.MaxValue).Take(HöchstensDarsteller))
{
if (string.IsNullOrWhiteSpace(d.Name)) continue;
liste.Add(new CreditMetadata(
d.Id, d.Name.Trim(), CreditKind.Actor, Leer(d.Character),
Bild(d.ProfilePath, ProfileSize), d.Order ?? liste.Count));
}
var stab = 0;
foreach (var m in quelle.Crew ?? [])
{
var rolle = m.Job?.Trim() switch
{
"Director" => CreditKind.Director,
"Writer" or "Screenplay" or "Story" => CreditKind.Writer,
_ => (CreditKind?)null,
};
if (rolle is not { } art || string.IsNullOrWhiteSpace(m.Name)) continue;
// Dieselbe Person steht im Stab mehrfach, wenn sie mehrere
// Aufgaben hatte — „Drehbuch" und „Story" sind bei TMDB zwei
// Zeilen und auf einer Detailseite ein Name.
if (liste.Any(e => e.ProviderId == m.Id && e.Kind == art)) continue;
liste.Add(new CreditMetadata(
m.Id, m.Name.Trim(), art, null, Bild(m.ProfilePath, ProfileSize), stab++));
}
return liste.Count > 0 ? liste : null;
}
private static RemoteImage? Bild(string? pfad, string grösse) =>
string.IsNullOrWhiteSpace(pfad) ? null : new RemoteImage($"https://image.tmdb.org/t/p/{grösse}{pfad}");
@@ -280,7 +431,16 @@ public sealed class TmdbClient(
[property: JsonPropertyName("release_date")] string? ReleaseDate,
[property: JsonPropertyName("overview")] string? Overview,
[property: JsonPropertyName("poster_path")] string? PosterPath,
[property: JsonPropertyName("backdrop_path")] string? BackdropPath);
[property: JsonPropertyName("backdrop_path")] string? BackdropPath,
// Die folgenden liefert nur der Einzelabruf, nicht die Suche.
[property: JsonPropertyName("runtime")] int? Runtime = null,
[property: JsonPropertyName("vote_average")] double? VoteAverage = null,
[property: JsonPropertyName("tagline")] string? Tagline = null,
[property: JsonPropertyName("genres")] List<TmdbGenre>? Genres = null,
[property: JsonPropertyName("credits")] TmdbCredits? Credits = null,
[property: JsonPropertyName("external_ids")] TmdbExternalIds? ExternalIds = null,
[property: JsonPropertyName("release_dates")] TmdbReleaseDates? ReleaseDates = null,
[property: JsonPropertyName("images")] TmdbImages? Images = null);
private sealed record TmdbSeries(
[property: JsonPropertyName("id")] int Id,
@@ -288,7 +448,59 @@ public sealed class TmdbClient(
[property: JsonPropertyName("first_air_date")] string? FirstAirDate,
[property: JsonPropertyName("overview")] string? Overview,
[property: JsonPropertyName("poster_path")] string? PosterPath,
[property: JsonPropertyName("backdrop_path")] string? BackdropPath);
[property: JsonPropertyName("backdrop_path")] string? BackdropPath,
[property: JsonPropertyName("episode_run_time")] List<int>? EpisodeRunTime = null,
[property: JsonPropertyName("vote_average")] double? VoteAverage = null,
[property: JsonPropertyName("tagline")] string? Tagline = null,
[property: JsonPropertyName("genres")] List<TmdbGenre>? Genres = null,
[property: JsonPropertyName("credits")] TmdbCredits? Credits = null,
[property: JsonPropertyName("external_ids")] TmdbExternalIds? ExternalIds = null,
[property: JsonPropertyName("content_ratings")] TmdbContentRatings? ContentRatings = null,
[property: JsonPropertyName("images")] TmdbImages? Images = null);
private sealed record TmdbGenre([property: JsonPropertyName("name")] string? Name);
private sealed record TmdbImages(
[property: JsonPropertyName("logos")] List<TmdbImage>? Logos);
private sealed record TmdbImage(
[property: JsonPropertyName("file_path")] string? FilePath,
[property: JsonPropertyName("iso_639_1")] string? Language,
[property: JsonPropertyName("vote_average")] double? VoteAverage);
private sealed record TmdbCredits(
[property: JsonPropertyName("cast")] List<TmdbCast>? Cast,
[property: JsonPropertyName("crew")] List<TmdbCrew>? Crew);
private sealed record TmdbCast(
[property: JsonPropertyName("id")] int Id,
[property: JsonPropertyName("name")] string? Name,
[property: JsonPropertyName("character")] string? Character,
[property: JsonPropertyName("profile_path")] string? ProfilePath,
[property: JsonPropertyName("order")] int? Order);
private sealed record TmdbCrew(
[property: JsonPropertyName("id")] int Id,
[property: JsonPropertyName("name")] string? Name,
[property: JsonPropertyName("job")] string? Job,
[property: JsonPropertyName("profile_path")] string? ProfilePath);
private sealed record TmdbReleaseDates(
[property: JsonPropertyName("results")] List<TmdbReleaseCountry>? Results);
private sealed record TmdbReleaseCountry(
[property: JsonPropertyName("iso_3166_1")] string? Country,
[property: JsonPropertyName("release_dates")] List<TmdbRelease>? Releases);
private sealed record TmdbRelease(
[property: JsonPropertyName("certification")] string? Certification);
private sealed record TmdbContentRatings(
[property: JsonPropertyName("results")] List<TmdbContentRating>? Results);
private sealed record TmdbContentRating(
[property: JsonPropertyName("iso_3166_1")] string? Country,
[property: JsonPropertyName("rating")] string? Rating);
private sealed record TmdbEpisode(
[property: JsonPropertyName("name")] string? Name,