Plex ist raus — und nahm zwei stille Fehler mit

Vollständig entfernt: das Paket `PlexKit` samt 108 Tests, der
Web-Authenticator, die Anmeldung über plex.tv, die Serverauswahl und alles,
was daran hing. 43 Dateien gelöscht, 68 Stellen in 28 weiteren bereinigt.

**Zwei Dinge hätten beim blossen Streichen still das Falsche getan.**

`playbackUnavailableMessage` deckte im Else-Zweig zwei Lagen gleichzeitig ab
— „es ist Plex" und „niemand ist angemeldet". Wer die Serverart naiv
herausstreicht, bekommt als nicht angemeldeter Nutzer „Jellyfin-Wiedergabe
steht aus" statt „Server nicht erreichbar". Die Unterscheidung hängt jetzt
daran, ob überhaupt ein Server da ist.

Die Schlüsselbund-Einträge `plex.account` und `plex.server` wurden allein
über den Authenticator aus dem gelöschten Paket entfernt. Danach stünde
`plex.account` in keiner Zeile dieses Projekts mehr: wer sich nie abgemeldet
hat, trüge ein gültiges Token am fremden Konto bis in alle Ewigkeit mit sich,
ohne dass irgendein Weg es noch löschen könnte. `purgePlexLeftovers()` räumt
beide Token und fünf Voreinstellungen einmalig ab — und fasst nichts an, wo
nichts liegt, damit kein Jellyfin-Nutzer dafür seinen Mediathekenspeicher
verliert.

**Was Nutzer sehen.** Die Berechtigungsfrage fürs lokale Netz sagte wörtlich,
die App brauche es, „um deinen Plex-Server zu finden" — das stand so im
Systemdialog. Der Anmeldebildschirm hatte zwei Knöpfe, und der hervorgehobene
war der für Plex; der verbliebene erbt die Hervorhebung, denn ein Knopf, der
aussieht wie die zweite Wahl, lässt nach der ersten suchen. 14 verwaiste
Textbausteine sind weg, vier umformuliert.

Darunter einer, der schlicht nicht mehr stimmte: `signIn.privacy` versprach,
das Passwort erreiche diese App nie. Beim Jellyfin-Rückfall auf das Passwort
tut es das sehr wohl. Die Zusage, die weiterhin gilt, ist die über fremde
Dienste — und nur die steht jetzt da.

**Was ausdrücklich bleibt:** `MediaBackend`. Diese Abstraktion hat zwei
Server gleichzeitig getragen, und der Steckplatz, den Plex räumt, ist genau
der, auf den Halo kommt. `ServerKind` fällt dagegen weg — mit einem Fall ist
es ein Bool, das `backend != nil` schon beantwortet.

Nebenbei zog die README nach. Sie beschrieb noch einen „nativen Plex-Client"
mit zwei Playern und VLCKit, beides seit Längerem nicht mehr wahr.

368 Tests grün (von 476 minus die 108 aus PlexKitTests, kein anderer).
iOS und tvOS bauen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Scarriffle
2026-10-03 11:10:20 +02:00
co-authored by Claude Opus 5
parent 93695dc332
commit 2fcf6821c8
68 changed files with 231 additions and 9425 deletions
@@ -2,7 +2,6 @@ import SwiftUI
import FlixyDesign
import FlixyDownloads
import MediaKit
import PlexKit
/// Der Download-Knopf auf einer Detailseite.
///
+3 -7
View File
@@ -1,6 +1,5 @@
import Foundation
import MediaKit
import PlexKit
/// Der Ladezustand eines Bildschirms.
///
@@ -58,15 +57,12 @@ extension LoadState {
/// Bildschirm eine andere Erklärung.
enum ErrorText {
static func describe(_ error: any Error) -> String {
// Die neutrale Form zuerst, weil die Ansichten nur noch sie sehen.
// Plex' eigener Fehler kommt nur noch dort an, wo unmittelbar mit ihm
// gesprochen wird — Player, Downloads, Live-TV.
// Die neutrale Form zuerst: die Ansichten sehen nur noch sie, und
// jeder Server übersetzt seine eigenen Fehler schon an der Grenze
// seines Moduls dorthin.
if let backendError = error as? MediaBackendError {
return describe(backendError)
}
if let plexError = error as? PlexError {
return describe(plexError.asMediaBackendError)
}
return error.localizedDescription
}
+7 -19
View File
@@ -3,7 +3,6 @@ import FlixyDesign
import MediaKit
import FlixyDownloads
import FlixyPlayback
import PlexKit
/// Die Wurzelansicht.
///
@@ -88,20 +87,8 @@ struct RootView: View {
.frame(maxWidth: .infinity, maxHeight: .infinity)
.background(Color.flixyCanvas)
case .signedOut, .authenticating:
SignInView(
phase: session.phase,
manualCode: session.showsManualCode ? session.pendingCode : nil,
onSignIn: { Task { await session.beginSignIn() } },
onCancel: { session.cancelSignIn() }
)
case .choosingServer(let servers):
NavigationStack {
ServerPickerView(servers: servers) { resource in
Task { await session.connect(to: resource) }
}
}
case .signedOut:
SignInView()
case .connecting(let name):
ConnectingView(serverName: name)
@@ -247,10 +234,11 @@ struct RootView: View {
settings: settings,
languages: languages,
subtitles: subtitleAppearance,
// **Nicht mehr über `server`.** Der ist ein `PlexServer` und bei
// Jellyfin immer `nil` — damit galt dort jede Wiedergabe als
// entfernt, auch zuhause am Kabel, und „Auto" hätte ein
// 67-Mbit-Remux ohne Not heruntergerechnet.
// **Vom Server erfragt, nicht aus der Adresse geschlossen.** Wer
// über einen Reverse Proxy geht, erreicht seinen Server auch von
// der Couch aus unter einem öffentlichen Namen — ihn deshalb als
// entfernt zu führen hiesse, „Auto" würde ein 67-Mbit-Remux
// zuhause am Kabel ohne Not herunterrechnen.
isLocalConnection: session.isLocalConnection,
connectionDescription: session.connectionDescription,
unavailableMessage: session.playbackUnavailableMessage
-1
View File
@@ -4,7 +4,6 @@ import MediaKit
import Observation
import FlixyDownloads
import FlixyPlayback
import PlexKit
/// Führt einen Abspielwunsch aus.
///
-13
View File
@@ -2,7 +2,6 @@ import SwiftUI
import FlixyDesign
import FlixyDownloads
import FlixyPlayback
import PlexKit
/// Der Vollbildplayer.
struct PlayerView: View {
@@ -757,18 +756,6 @@ struct PlayerView: View {
Text("player.preparing")
.font(.flixyCaption)
.foregroundStyle(.white.opacity(0.6))
// Über die Vermittlung von Plex ist die Leitung auf wenige Mbit
// gedrosselt. Ein großer Film läuft darüber nicht an, und ohne
// diesen Hinweis sucht man den Fehler in der App statt in der
// Verbindung.
if session.server?.connection.relay == true {
Label("player.relayWarning", systemImage: "exclamationmark.triangle")
.font(.flixyCaption)
.foregroundStyle(.white.opacity(0.8))
.multilineTextAlignment(.center)
.padding(.top, FlixySpacing.snug)
}
}
.padding(FlixySpacing.section)
}
+8 -52
View File
@@ -1,6 +1,5 @@
import SwiftUI
import FlixyDesign
import PlexKit
/// Was beim letzten Abspielversuch passiert ist.
///
@@ -11,23 +10,18 @@ struct DiagnosticsView: View {
@Environment(FlixySession.self) private var session
@Environment(\.flixyAccent) private var accent
@Environment(PlaybackDiagnostics.self) private var diagnostics
@State private var liveTVStructure: String?
@State private var isInspectingLiveTV = false
var body: some View {
Form {
Section("diagnostics.connection") {
if let server = session.server {
LabeledContent("settings.serverName", value: server.name)
LabeledContent("settings.address", value: server.connection.uri)
.font(.flixyCaption)
if server.connection.relay {
// Der häufigste Grund dafür, dass nichts anläuft. Ohne
// Hinweis sucht man den Fehler in der App.
Label("diagnostics.relayWarning", systemImage: "exclamationmark.triangle")
if session.backend != nil {
LabeledContent("settings.serverName", value: session.serverName)
if let address = session.serverAddress {
LabeledContent("settings.address", value: address)
.font(.flixyCaption)
}
if let beschreibung = session.connectionDescription {
LabeledContent("settings.connection", value: beschreibung)
.font(.flixyCaption)
.foregroundStyle(Color.flixyDestructive)
}
} else {
Text("diagnostics.noServer").foregroundStyle(Color.flixyTextMuted)
@@ -73,36 +67,6 @@ struct DiagnosticsView: View {
}
}
Section {
Button {
Task { await inspectLiveTV() }
} label: {
if isInspectingLiveTV {
ProgressView().controlSize(.small)
} else {
Label("diagnostics.liveTV", systemImage: "antenna.radiowaves.left.and.right")
}
}
.disabled(isInspectingLiveTV)
if let liveTVStructure {
Text(liveTVStructure)
.font(.system(.caption2, design: .monospaced))
.foregroundStyle(Color.flixyTextSecondary)
.textSelection(.enabled)
Button {
FlixyClipboard.copy(liveTVStructure)
} label: {
Label("diagnostics.copy", systemImage: "doc.on.doc")
}
}
} header: {
Text("sidebar.liveTV")
} footer: {
Text("diagnostics.liveTVHint")
}
Section("settings.app") {
LabeledContent("settings.version", value: Branding.version)
LabeledContent("settings.build", value: Branding.buildStamp)
@@ -122,14 +86,6 @@ struct DiagnosticsView: View {
.flixyInlineTitle()
}
/// Fragt den Server, wie seine Antwort auf `/livetv/dvrs` aufgebaut ist.
private func inspectLiveTV() async {
guard let server = session.server else { return }
isInspectingLiveTV = true
defer { isInspectingLiveTV = false }
liveTVStructure = await server.liveTVStructure()
}
/// Der Bericht als Text zum Weitergeben.
///
/// Enthält bewusst keinen Token: die Quelladresse ist schon ohne
+11 -21
View File
@@ -1,7 +1,6 @@
import SwiftUI
import FlixyDesign
import MediaKit
import PlexKit
/// Mit welchem Server gesprochen wird — und was er gerade anbietet.
struct ServerSettingsView: View {
@@ -12,12 +11,11 @@ struct ServerSettingsView: View {
Form {
Section("settings.server") {
LabeledContent("settings.serverName", value: session.serverName)
// Welche Art von Server — bei zwei möglichen ist das keine
// Nebensache mehr, sondern die erste Frage bei jeder
// Rückmeldung.
LabeledContent("settings.serverKind", value: kindLabel)
if let connection = session.server?.connection {
LabeledContent("settings.connection", value: connectionLabel(connection))
// Nah oder fern: daran hängt, ob „Auto" gedeckelt anfängt,
// und damit die erste Frage bei jeder Rückmeldung über
// Ruckeln.
if session.backend != nil {
LabeledContent("settings.connection", value: connectionLabel)
}
if let address = session.serverAddress {
LabeledContent("settings.address", value: address)
@@ -53,20 +51,12 @@ struct ServerSettingsView: View {
.flixyInlineTitle()
}
private var kindLabel: String {
switch session.kind {
case .plex: "Plex"
case .jellyfin: "Jellyfin"
case nil: "—"
}
}
/// Zeigt, über welchen Weg die Verbindung läuft — beim Suchen nach
/// Ruckeln ist das die erste Frage.
private func connectionLabel(_ connection: PlexConnection) -> String {
if connection.local { return String(localized: "settings.connectionLocal") }
if connection.relay { return String(localized: "settings.connectionRelay") }
return String(localized: "settings.connectionRemote")
/// Zeigt, ob der Server im selben Netz steht — beim Suchen nach Ruckeln
/// ist das die erste Frage.
private var connectionLabel: String {
session.isLocalConnection
? String(localized: "settings.connectionLocal")
: String(localized: "settings.connectionRemote")
}
}
@@ -1,6 +1,5 @@
import SwiftUI
import FlixyDesign
import PlexKit
/// Während ein Weg zum Server gesucht wird.
struct ConnectingView: View {
@@ -20,58 +19,6 @@ struct ConnectingView: View {
}
}
/// Wenn am Konto mehrere Server hängen.
struct ServerPickerView: View {
let servers: [PlexResource]
let onSelect: (PlexResource) -> Void
@Environment(\.flixyAccent) private var accent
var body: some View {
List(servers) { server in
Button {
onSelect(server)
} label: {
HStack(spacing: FlixySpacing.regular) {
Image(systemName: server.owned ? "server.rack" : "person.2")
.foregroundStyle(accent)
.frame(width: 28)
VStack(alignment: .leading, spacing: 2) {
Text(server.name)
.font(.flixyCardTitle)
.foregroundStyle(Color.flixyTextPrimary)
Text(subtitle(for: server))
.font(.flixyCaption)
.foregroundStyle(Color.flixyTextMuted)
}
Spacer()
Image(systemName: "chevron.right")
.font(.flixyCaption)
.foregroundStyle(Color.flixyTextMuted)
}
.contentShape(.rect)
}
.buttonStyle(.plain)
.listRowBackground(Color.flixySurface)
}
.scrollContentBackground(.hidden)
.background(Color.flixyCanvas)
.navigationTitle(Text("serverPicker.title"))
}
private func subtitle(for server: PlexResource) -> String {
var pieces: [String] = []
pieces.append(server.owned
? String(localized: "serverPicker.owned")
: String(localized: "serverPicker.shared"))
if let platform = server.platform { pieces.append(platform) }
if let version = server.productVersion { pieces.append(version) }
return pieces.joined(separator: " · ")
}
}
/// Wenn etwas schiefgegangen ist.
struct ConnectionFailureView: View {
let message: String
+13 -76
View File
@@ -3,30 +3,18 @@ import FlixyDesign
/// Der Anmeldebildschirm.
///
/// Zwei Wege, weil es zwei Serverarten gibt. **Plex** öffnet seine eigene
/// Anmeldemaske in einem Fenster innerhalb der App; das Passwort wird dort
/// eingegeben und erreicht Flixy nie. **Jellyfin** hat kein Verzeichnis wie
/// plex.tv — dort wird die Adresse des eigenen Servers eingetippt und, wann
/// immer der Server es anbietet, ein Code bestätigt statt eines Passworts.
/// **Ein Weg, seit es einen Server gibt.** Hier standen zwei Knöpfe
/// nebeneinander, und der obere war der auffälligere — er führte zu Plex.
/// Bleibt einer übrig, erbt er die Hervorhebung: ein Knopf, der aussieht wie
/// die zweite Wahl, lässt den Benutzer nach der ersten suchen.
///
/// Die beiden Wege sind absichtlich nicht zu einem zusammengefasst. Sie haben
/// nichts gemeinsam außer dem Ziel, und der Versuch, das zu verstecken, würde
/// beide verschlechtern.
/// Jellyfin hat kein Verzeichnis, an dem die eigenen Server hängen. Deshalb
/// wird die Adresse eingetippt und, wann immer der Server es anbietet, ein
/// Code bestätigt statt eines Passworts — das führt `JellyfinSignInView`.
struct SignInView: View {
let phase: FlixySession.Phase
/// Der Code der laufenden Plex-Anmeldung, sobald er gezeigt werden soll.
let manualCode: String?
let onSignIn: () -> Void
let onCancel: () -> Void
@Environment(\.flixyAccent) private var accent
@State private var showsJellyfinSignIn = false
private var isAuthenticating: Bool {
if case .authenticating = phase { return true }
return false
}
var body: some View {
VStack(spacing: FlixySpacing.section) {
Spacer()
@@ -49,21 +37,6 @@ struct SignInView: View {
Spacer()
VStack(spacing: FlixySpacing.regular) {
Button(action: onSignIn) {
Group {
if isAuthenticating {
ProgressView().tint(Color.flixyCanvas)
} else {
Text("signIn.withPlex").font(.flixyRowHeader)
}
}
.frame(maxWidth: .infinity)
.padding(.vertical, FlixySpacing.regular)
}
.buttonStyle(.borderedProminent)
.tint(accent)
.disabled(isAuthenticating)
Button {
showsJellyfinSignIn = true
} label: {
@@ -72,18 +45,13 @@ struct SignInView: View {
.frame(maxWidth: .infinity)
.padding(.vertical, FlixySpacing.regular)
}
.buttonStyle(.bordered)
.tint(Color.flixyTextSecondary)
.disabled(isAuthenticating)
.buttonStyle(.borderedProminent)
.tint(accent)
if let manualCode {
manualFallback(code: manualCode)
} else {
Text("signIn.privacy")
.font(.flixyCaption)
.foregroundStyle(Color.flixyTextMuted)
.multilineTextAlignment(.center)
}
Text("signIn.privacy")
.font(.flixyCaption)
.foregroundStyle(Color.flixyTextMuted)
.multilineTextAlignment(.center)
}
Spacer().frame(height: FlixySpacing.section)
@@ -96,35 +64,4 @@ struct SignInView: View {
JellyfinSignInView()
}
}
/// Der Ausweg, wenn die Browser-Seite den Code nicht verknüpft.
///
/// Das passiert, wenn man dort schon bei Plex angemeldet ist: die Seite
/// springt weiter, ohne zu verknüpfen, und die App wartete vergeblich.
/// Der Code gilt weiter — abtippen führt immer zum Ziel.
@ViewBuilder
private func manualFallback(code: String) -> some View {
VStack(spacing: FlixySpacing.regular) {
Divider().overlay(Color.flixySeparator)
Text("signIn.manualHint")
.font(.flixyCaption)
.foregroundStyle(Color.flixyTextSecondary)
.multilineTextAlignment(.center)
Text(code)
.font(.system(.title, design: .monospaced, weight: .semibold))
.tracking(6)
.foregroundStyle(Color.flixyTextPrimary)
.textSelection(.enabled)
.padding(.vertical, FlixySpacing.snug)
.frame(maxWidth: .infinity)
.background(Color.flixyElevated, in: .rect(cornerRadius: FlixyRadius.control))
Button("action.cancel", action: onCancel)
.font(.flixyCaption)
.foregroundStyle(Color.flixyTextSecondary)
}
.transition(.opacity)
}
}