BrandtWolf PlexPlayer – Technisches Benutzerhandbuch

Willkommen beim BrandtWolf PlexPlayer, einem modernen und leistungsstarken Medienplayer für Linux und Android. Dieses Handbuch führt dich durch alle Aspekte der Einrichtung, Nutzung und Fehlerbehebung.

---

1. Benutzeroberfläche & Navigation

Die Benutzeroberfläche ist darauf optimiert, sowohl auf Desktop-Systemen als auch auf mobilen Endgeräten eine intuitive Steuerung zu ermöglichen.

Das Sidebar-Menü (Navigationsleiste)

Die Sidebar ist dein zentrales Steuerzentrum. In der Desktop Version und in der Mobilen Version schließt sich die Sidebar automatisch, um mehr Platz für Medieninhalte zu schaffen.

• Einklappen/Ausklappen: In der Desktop und in der Mobilen Version schließt sich die Sidebar automatisch, wenn du außerhalb des Menüs auf den Bildschirm tippst.
• Benutzerprofil: Oben wird der aktuell angemeldete Benutzer angezeigt.
• Verbindungsanzeige: Ein farbiger Punkt zeigt die Echtzeit-Qualität zum Plex-Server an:
  • 🔵 Cyan (Stark): Lokale Verbindung (LAN/WLAN) oder sehr schnelle Remote-Anbindung.
  • 🟡 Gelb (Mittel): Standard Lokale oder Remote-Verbindung.
  • 🟠 Orange (Schwach): Langsame Verbindung, Pufferung möglich.
  • 🔴 Rot (Getrennt): Keine Verbindung zum Server. In diesem Modus stehen nur Downloads und die lokalen Playlisten zur Verfügung.

---

2. Medien-Bibliotheken & Verwaltung

Filme, Serien & Musik

Der Player trennt deine Inhalte automatisch nach den in Plex definierten Mediatheken.

• Ansichts-Modi: Wähle zwischen „Zuletzt hinzugefügt“ (Standard) und „Bibliothek“ (A-Z Sortierung).
• Suchfunktion: Mit der Lupe kannst du deine gesamte Bibliothek schnell nach Titeln durchsuchen.

Serien-Spezifische Funktionen

Serien werden hierarchisch dargestellt: Serie -> Staffeln -> Episoden.

• Fortschrittsanzeige: Ein blaues „Play“-Icon auf einem Staffel- oder Episoden-Poster signalisiert, dass der Inhalt angefangen wurde. Ein grüner Haken zeigt an, dass er bereits vollständig gesehen wurde.
• Staffel-Navigation: In der Detailansicht einer Serie kannst du horizontal durch alle verfügbaren Staffeln scrollen.
• Auto-Play: Nach dem Ende einer Episode wird automatisch nach 5 Sekunden die nächste Episode gestartet. Du kannst den Countdown jederzeit abbrechen.

Watchlist

Markiere Inhalte zur späteren Ansicht.

• Filter: In der Watchlist kannst du gezielt nach Filmen, Serien oder Musik-Interpreten filtern.

---

3. Abspiel-Technologie (Offline First)

Bevorzugung lokaler Dateien

Wenn du einen Film oder eine Episode heruntergeladen hast, wird der Player immer automatisch die lokale Datei abspielen, selbst wenn du online bist.

• Vorteile: Keine Pufferung, maximale Qualität und Einsparung von Internet-Bandbreite.
• Stream-Fallback: Sollte eine lokale Datei beschädigt sein oder fehlen, schaltet der Player automatisch auf den Online-Stream um.

Direct Play & Transcoding

Der Player ist so konzipiert, dass er Medienformate nativ abspielt (Direct Play).

• Falls die Internetgeschwindigkeit zu gering ist, erkennt der Server dies und reduziert die Qualität automatisch (Transcoding).
• In den Einstellungen des Video-Players kannst du die Qualität auch manuell festlegen (z.B. von 1080p auf 720p reduzieren).

---

4. Das Duale Player-System

Der BrandtWolf PlexPlayer nutzt zwei spezialisierte Player-Einheiten für ein optimales Erlebnis.

A. Video-Player

Optimiert für Filme und Serien auf Linux (MPV-basiert) und Android.

• Klassische Steuerung: Intuitive Buttons für Play/Pause, 10-Sekunden-Sprünge und Lautstärkeregelung.
• Vollbild-Modus: Wechsle nahtlos zwischen Fenster- und Vollbild-Modus.
• Auto-Resume: Der Player merkt sich sekundengenau, wo du aufgehört hast.

B. Audio-Player

Spezialisiert auf Musik und Hörbücher mit Fokus auf Hintergrundwiedergabe.

• Album-Resume: Der Player merkt sich nicht nur die Position im Track, sondern auch, bei welchem Titel eines Albums du zuletzt warst.
• Background Play: Musik spielt weiter, auch wenn das Display aus ist oder die App im Hintergrund läuft.
• Android Auto: Verbinde dein Smartphone mit deinem Fahrzeug, um deine Musik und Playlists direkt über das Display deines Autos zu steuern.

---

5. Listen-Management (Playlists)

Erstelle und verwalte deine eigenen Medienlisten direkt in der App.

• Erstellung: Klicke in der Detailansicht eines Mediums auf „Zu Playlist hinzufügen“.
• Sortierung: Halte einen Titel im Playlist-Grid gedrückt, um ihn per Drag & Drop zu verschieben.
• Offline-Playlists: Heruntergeladene Titel in Playlists sind durch ein kleines Icon gekennzeichnet und funktionieren ohne Internet.

---

6. Dashboard & Statistiken (Nur Admins)

Der Zugriff auf das Dashboard ist nur für Server-Admins möglich. Andere Nutzer sehen die Standard-Startseite.

Dashboard-Struktur

Das Dashboard ist in zwei Hauptbereiche unterteilt:

1. Server Status (Tab):
   • Server Info: Plex Version, Plattform und Online-Status.
   • Now Playing: Echtzeit-Übersicht aller aktiven Streams (wer schaut was?).
   • Server Ressourcen: Grafische Anzeige der Bandbreite (LAN/WAN) sowie CPU-, RAM-, GPU- und HDD-Auslastung.
2. Top Charts (Tab):
   • Kategorien: Wechsle zwischen Filmen, Serien, Interpreten und Top-Nutzern.
   • Benutzer-Filter: Filter die Statistiken nach einzelnen Nutzern des Plex-Homes.

---

7. Erweiterte Einstellungen & Tools

Speicher-Management

In den Einstellungen (Settings) findest du detaillierte Statistiken:

• Verbrauch: Getrennte Anzeige für Audio-Dateien, Video-Dateien, Bild-Cache und RAM-Nutzung.
• Cache leeren: Löscht den Bild-Cache (Cover/Poster), um Speicherplatz freizugeben.
• Downloads löschen: Entfernt alle Offline-Inhalte dauerhaft vom Gerät.

System & Benutzer

• Benutzer wechseln: Wechsel zu anderen Managed Usern („Switch User“) direkt im Profil-Bereich. (PIN-geschützte Profile werden unterstützt).
• Updates: Der Player prüft automatisch auf neue Versionen. Steht ein Update bereit, erscheint ein oranger Hinweis. Mit einem Klick auf „Download & Install“ wird die neue Version geladen und (auf Android) zur Installation angeboten.

---

8. Offline-Nutzung & Sicherheit

Der 30-Tage Lease

Aus Lizenzgründen müssen heruntergeladene Inhalte alle 30 Tage validiert werden.

Wenn die App länger als 30 Tage keine Verbindung zum Server herstellen kann, werden Offline-Inhalte aus Sicherheitsgründen automatisch gelöscht. Verbinde die App mindestens einmal monatlich mit dem Internet, um deine Downloads zu behalten.

---

9. Fehlerbehebung (Troubleshooting)

Problem	Mögliche Ursache	Lösung
PIN-Login schlägt fehl	Code abgelaufen.	Starte den Login-Prozess neu, um einen neuen 4-Stellen-Code zu generieren.
Download startet nicht	Fehlende Berechtigung, Verbindungsabbruch oder Speicher voll.	Prüfe, ob deine Verbindung zum Server besteht, ob Administrator Downloads erlaubt hat und ob genügend Speicherplatz frei ist. Gegebenenfalls schließe die App vollständig und starte sie wieder neu, dann werden die Downloads automatisch fortgesetzt.
„403 Forbidden“	Token ungültig.	Melde dich mit Admin Account ab und verbinde dein Plex Konto mit der App neu.
Ruckeln bei hoher Bitrate	Netzwerk zu langsam (WLAN).	Überprüfe ob die die WLAN Verbindung gut ist. Gegebenenfalls lade die Datei herunter um sie offline Abzuspielen.
Android Auto wird nicht erkannt	Kabel/Bluetooth Problem.	Stelle sicher, dass „PlexPlayer“ in den Android Auto Einstellungen deines Smartphones aktiviert ist.

Stand: Version 1.1.10 – BrandtWolf Entwicklung 2026

---