1. Sidebar (Seitenleiste)

Die Sidebar ist die permanente Navigationsleiste auf der linken Seite der Anwendung. Sie und in dunklem Design gehalten.

1.1 Logo

Ganz oben in der Sidebar wird das Zenith-Logo angezeigt (Pfeil + Berg + "ZENITH" Schriftzug). Das Logo und dient als visuelle Markenidentifikation.

1.2 Navigationsmenü

Unterhalb des Logos befindet sich die vertikale Navigationsliste. Die Einträge sind in logische Gruppen unterteilt, getrennt durch unsichtbare Abstandshalter:

Hauptbereiche

Verbindung

Automatisierung

Benachrichtigungen

System

Aktiver Zustand

• Ausgewählt: Cyan-Textfarbe mit linkem Cyan-Rand und dunklem Hintergrund
• Hover: Leicht aufgehellte Textfarbe
• Normal: Gedämpftes Violett-Grau

1.3 Admin-Sperre (🔓 Admin)

Am unteren Rand der Sidebar befindet sich der Admin-Lock-Button. Damit kann ein Administrator bestimmte Tabs mit einem Passwort sperren, um unbefugte Änderungen zu verhindern.

Gesperrte Tabs werden mit einem 🔒 Symbol markiert und können nur nach Eingabe des Admin-Passworts betreten werden.

1.4 Demo-Hinweis

Im DEMO-Modus wird am unteren Rand der Sidebar ein orangefarbener Hinweiskasten angezeigt:

⚠ DEMO VERSION
Eingeschränkte Funktionen
Upgrade für vollen Zugriff

2. Dashboard (Kommandozentrale)

Das Dashboard ist die Startseite der Anwendung und bietet eine Übersicht über alle wichtigen Systeme auf einen Blick. Es ist scrollbar und aktualisiert sich automatisch alle 3 Sekunden.

2.1 VPN-Status-Karte (volle Breite, oben)

Die VPN-Karte zeigt den aktuellen Verbindungsstatus und ermöglicht das schnelle Ein-/Ausschalten des VPN direkt vom Dashboard.

Elemente

Zustände

Verhalten

• Bei Aktivierung wird zuerst geprüft, ob ein VPN-Interface konfiguriert ist
• Bei Fehler wird der Toggle automatisch zurückgesetzt
• Der Status synchronisiert sich automatisch mit dem VPN Guard Tab

2.2 Queue-Karte (links, Hauptbereich)

Die Queue-Karte nimmt den größten Teil des Dashboards ein und hat zwei Unter-Tabs: Upload und Download.

Tab-Umschalter

2.2.1 Upload-Seite

Zeigt alle Upload-Tasks in der Warteschlange als scrollbare Liste.

Task-Einträge

Jeder Task wird als Zeile mit folgenden Infos angezeigt: - Task-Name (z.B. rudirudi5 (7. Kopie)) - Dateigröße (z.B. 656.9 MB) - Status (Pending / Packing / Uploading / Completed / Failed / Paused) - Fortschrittsbalken (0–100%) - Geschwindigkeit (bei aktiven Uploads)

Bei Klick auf eine Zeile wird der Task selektiert (blau hervorgehoben) und kann einzeln gestartet werden.

Buttons

3-Zustands-Logik: Der Haupt-Button wechselt zwischen "Alle starten" → "Alle pausieren" → "Alle fortsetzen", identisch zum Download-Tab.

2.2.2 Download-Seite

Zeigt alle Download-Tasks (NZB-Importe) in der Warteschlange.

Task-Einträge

• NZB-Name
• Fortschritt (Segments downloaded / total)
• Geschwindigkeit
• Status (Queued / Downloading / Extracting / Completed / Failed)

Buttons

2.3 Watched Folders (rechts oben)

Zeigt alle konfigurierten Überwachungsordner (Watchfolders) mit individuellen Toggle-Schaltern.

Elemente pro Ordner

Verhalten

• Deaktivieren: Entfernt alle ausstehenden Tasks dieses Ordners aus der Queue
• Aktivieren: Startet den Watchdog neu und scannt den Ordner nach vorhandenen Dateien
• Ordner werden über Einstellungen → Überwachungsordner hinzugefügt/entfernt
• Wenn keine Ordner konfiguriert sind: "No watchfolders configured"

2.4 Disk Space Guard (rechts unten)

Zeigt den aktuellen Speicherplatzverbrauch und enthält mehrere Subsektionen.

2.4.1 Festplatten-Nutzung

2.4.2 Cache

2.4.3 RAM Modus

Unterhalb einer violetten Trennlinie befindet sich die RAM-Modus-Anzeige:

RAM-Modus: Wenn aktiviert, werden Upload-Tasks im RAM (tmpfs unter /dev/shm) verarbeitet statt auf der Festplatte. Das beschleunigt Pack- und PAR2-Vorgänge erheblich, benötigt aber ausreichend freien Arbeitsspeicher.

2.4.4 Speedtest

2.5 Titelleiste (Custom)

Zenith verwendet eine eigene rahmmenlose Titelleiste (Frameless Window) am oberen Rand:

2.6 Statusleiste (unten)

Am unteren Rand des Fensters befindet sich die permanente Statusleiste:

2.7 System-Tray-Icon

Zenith zeigt ein System-Tray-Icon in der Taskleiste (neben der Uhr): - Rechtsklick: Kontextmenü mit Show/Hide, Pause/Resume, Quit - Linksklick: Fenster anzeigen/verstecken - Bei aktivierter Option "In Tray minimieren" wird das Fenster beim Schließen nur versteckt

2.8 Werbebanner (nur DEMO)

Im DEMO-Modus wird oberhalb des Inhaltsbereichs (über allen Tabs) ein rotierendes Werbebanner angezeigt: - Wechselt alle 15 Sekunden - Zeigt Upgrade-Angebote und Partnerwerbung - Verschwindet nach Lizenz-Aktivierung

Upload Tab — Upload-Warteschlange

Der Upload-Tab ist die zentrale Verwaltung für alle Upload-Aufgaben. Hier werden Dateien und Ordner hinzugefügt, der Upload-Prozess gesteuert und der Fortschritt überwacht.

1. Seitenübersicht

Der Tab ist vertikal in folgende Bereiche aufgeteilt:

1. Header — Titel und Beschreibung
2. Steuerleiste — Button zum Hinzufügen von Dateien
3. Drag & Drop Zone — Dateien per Maus ablegen
4. Upload-Warteschlange — Interaktive Tabelle mit allen Tasks
5. Upload Log — Echtzeit-Protokoll aller Aktivitäten

2. Header

3. Steuerleiste

➕ Upload hinzufügen ▾ (Dropdown-Button)

Ein primärer Button mit Dropdown-Menü und zwei Optionen:

Hinzugefügte Dateien/Ordner werden sofort in die Warteschlange eingereiht.

4. Drag & Drop Zone

Unterhalb der Steuerleiste befindet sich eine gestrichelte Drop-Zone:

📥 Dateien oder Ordner hierher ziehen zum Hochladen

Verhalten

• Normal: Gestrichelter Rahmen in Grau
• Beim Darüberziehen: Rahmen wechselt zu Cyan mit leichtem Hintergrund-Glow
• Nach dem Ablegen: Dateien werden automatisch zur Queue hinzugefügt
• Unterstützt Dateien und Ordner gleichzeitig
• Mehrere Dateien können auf einmal abgelegt werden

5. Upload-Warteschlange (Hauptbereich)

Die Warteschlange ist eine interaktive Tabelle in einer dunklen Karte mit abgerundeten Ecken.

5.1 Queue-Header

5.2 Tabellen-Spalten

5.3 Status-Werte

5.4 Aktions-Buttons (pro Zeile)

Jede Zeile hat drei kleine Buttons (28×) rechts:

Glow-Logik

• Aktiver Task (Packing/Uploading): Play-Button leuchtet grün
• Pausierter Task: Pause-Button leuchtet orange
• Abgeschlossener/Fehlerhafter Task: Kein Glow, Buttons neutral
• Pending: Alle Buttons neutral (grau)

5.5 Neon-Fortschrittsbalken

Der Fortschrittsbalken ist ein Custom Widget (NeonProgressBar) mit: - Farbverlauf von Dunkelblau über Cyan zu hellem Blau - Glow-Effekt am Fortschrittsende - Prozentanzeige als überlagerten Text

6. Globale Steuerungs-Buttons (unterhalb der Tabelle)

3-Zustands-Button-Logik

▶ Alle starten → ⏸ Alle pausieren → ▶ Alle fortsetzen → ⏸ Alle pausieren → ...
 (grün) (orange) (grün) (orange)

Graceful Pause: Beim Pausieren wird der aktuelle Verarbeitungsschritt (z.B. Pack oder Upload) noch zu Ende geführt, bevor der nächste Task anhält. Laufende NNTP-Verbindungen werden nicht abrupt getrennt.

Automatisches Entfernen

Wenn in den Einstellungen "Fertige Uploads automatisch entfernen" aktiviert ist: - Der Button "✓ Fertige ausblenden" wird ausgegraut und deaktiviert - Tooltip zeigt: "Automatisches Entfernen ist aktiviert" - Abgeschlossene Tasks werden nach 5 Sekunden automatisch aus der Tabelle entfernt

7. Upload Log

Am unteren Rand des Tabs befindet sich ein Echtzeit-Protokoll in einer eigenen Karte:

Darstellung

• Hintergrund: Dunkles Terminal-Design mit Monospace-Schrift
• Maximale Höhe: (scrollbar)
• Auto-Scroll: Springt automatisch zum neuesten Eintrag

Farbcodierung

Log-Einträge

8. Pipeline-Verarbeitung

Im Hintergrund arbeitet die Upload-Engine im Pipelined-Modus:

Task A: [Pack] → [PAR2] → [Upload]
Task B: [Pack] → [PAR2] → [Upload]
Task C: [Pack] → [PAR2] → ...

• Während Task A hochgeladen wird, kann Task B bereits gepackt werden
• Der DiskGuard verhindert, dass zu viele Tasks gleichzeitig gepackt werden (Speicherplatzkontrolle)
• Der ConnectionBudget verwaltet die NNTP-Verbindungen zwischen Upload- und Download-Aufgaben

9. Einzeltask-Modus

Über den ▶-Button an einem einzelnen Task oder den "▶ Einzeln starten" Button im Dashboard kann ein einzelner Task isoliert gestartet werden:

• Nur der ausgewählte Task wird verarbeitet
• Die restliche Queue bleibt pausiert
• Nach Abschluss des einzelnen Tasks pausiert die Queue automatisch wieder
• Nützlich zum Testen oder für Prioritäts-Uploads

Download Tab — Usenet Downloader

Der Download-Tab ermöglicht das Herunterladen von Dateien aus dem Usenet über NZB-Dateien. Er unterstützt Multi-Connection-Downloads, automatische Passwort-Erkennung, PAR2-Reparatur, 7-Zip-Extraktion und NZBLNK-Protokollunterstützung.

1. Seitenübersicht

Der Tab ist vertikal in folgende Bereiche aufgeteilt:

1. Header — Titel und Beschreibung
2. NZB Import Card — NZB-Datei/URL eingeben, Passwort, Queue-Button
3. Download-Warteschlange — Tabelle mit allen Download-Tasks
4. Download Log — Echtzeit-Protokoll aller Aktivitäten

2. Header

3. NZB Import Card

Eine abgerundete Karte mit dem Import-Widget zum Hinzufügen neuer Downloads.

3.1 Drag & Drop Zone

📎 NZB-Datei hierher ziehen (Drag & Drop)

• Normal: Gestrichelter Rahmen in Grau
• Beim Darüberziehen: Text ändert sich zu "📥 NZB hier ablegen!", Rahmen wird Cyan
• Akzeptiert nur .nzb-Dateien

3.2 NZB-Eingabefeld

Unterstützte Eingaben

• Lokale Datei: /home/user/downloads/example.nzb
• URL: https://example.com/releases/example.nzb — wird automatisch heruntergeladen
• Zwischenablage: NZB-URLs und NZBLNK-Links werden automatisch aus der Zwischenablage erkannt

3.3 Passwort-Feld

Automatische Passwort-Erkennung

Das System erkennt Passwörter automatisch aus dem NZB-Dateinamen. Gängige Formate: - filename {{password}}.nzb - filename [password].nzb - filename - password.nzb

Bei Erkennung wird das Passwort automatisch eingetragen und im Log angezeigt:

🔑 Passwort erkannt: p*****d

3.4 Aktions-Button

Hinweis: Der Button fügt nur zur Queue hinzu, startet den Download aber nicht automatisch. Dies geschieht über den separaten Start-Button.

4. Download-Warteschlange

4.1 Queue-Header

4.2 Tabelle

Identische Spaltenstruktur wie die Upload-Queue:

4.3 Status-Werte

4.4 Rechtsklick-Kontextmenü

Über Rechtsklick auf einen Queue-Eintrag öffnet sich ein Kontextmenü:

5. Steuerungs-Buttons

3-Zustands-Logik

Identisch zum Upload-Tab:

▶ Downloads starten → ⏸ Alle pausieren → ▶ Downloads fortsetzen → ...

6. Download Log

Echtzeit-Protokoll identisch zum Upload-Tab:

• Hintergrund: Terminal-Design mit Monospace-Schrift
• Maximale Höhe: (scrollbar)
• Farbcodierung: Grün (Erfolg), Rot (Fehler), Grau (Info)

Typische Log-Einträge

7. Spezial-Features

7.1 Zwischenablage-Überwachung

Zenith überwacht automatisch die Zwischenablage auf: - NZB-URLs — Links die .nzb enthalten werden automatisch ins Eingabefeld übernommen - NZBLNK-Links — nzblnk: Protokoll-Links werden automatisch verarbeitet

Diese Funktion kann in den Einstellungen deaktiviert werden (dl_clipboard_monitor).

7.2 NZBLNK-Protokoll-Unterstützung

Zenith ist als Handler für das nzblnk: URI-Schema registriert. Bei Klick auf einen NZBLNK-Link im Browser:

1. Zenith öffnet sich (oder aktiviert das bestehende Fenster)
2. Der Link wird automatisch verarbeitet
3. Die NZB wird über folgende Quellen gesucht (in dieser Reihenfolge):
4. Newznab-Indexer (falls konfiguriert)
5. Binsearch.info (kostenlos, kein API-Key nötig)
6. NZBIndex.com (kostenlos, RSS-Feed)
7. Bei Fund wird die NZB heruntergeladen und zur Queue hinzugefügt
8. Das Passwort aus dem NZBLNK wird automatisch übernommen

7.3 Automatische Passwort-Erkennung

Das System erkennt Passwörter aus: - NZB-Dateiname — Gängige Muster wie {{password}}, [password] - NZBLNK-Daten — Passwort-Feld im NZBLNK-URI - Manuell — Rechtsklick → Passwort setzen

7.4 Auto-Extraktion

Nach dem Download wird automatisch: 1. PAR2-Reparatur — Fehlende/beschädigte Segmente werden repariert (konfigurierbar) 2. CRC-Check — Integritätsprüfung der heruntergeladenen Dateien (konfigurierbar) 3. 7-Zip-Extraktion — Archive werden entpackt (konfigurierbar) 4. Archiv-Cleanup — RAR/7z-Dateien nach Extraktion löschen (konfigurierbar) 5. Junk-Cleanup — Überflüssige Dateien (NFO, TXT, etc.) löschen (konfigurierbar)

7.5 Mirror-Modus

Der Mirror-Modus ermöglicht das automatische Re-Uploading nach dem Download: - Download → Extraktion → automatischer Upload mit denselben Einstellungen - Status wechselt zu Mirror: Uploading - Wird über den Remote-Input-Tab oder API gesteuert

7.6 Queue-Persistenz

Die Download-Queue wird automatisch gespeichert und beim Neustart wiederhergestellt. Pending-Tasks bleiben erhalten, auch wenn die Anwendung geschlossen wird.

7.7 ConnectionBudget

Downloads und Uploads teilen sich die NNTP-Verbindungen über das ConnectionBudget-System: - Wenn ein Upload läuft, werden die verfügbaren Verbindungen für Downloads reduziert - Der Provider-Nutzungsmodus (Upload/Download/Beides) bestimmt die Verteilung - Bei Provider-Nutzung "Download" werden nur Download-Verbindungen erstellt

8. Konfigurierbare Einstellungen

Folgende Download-Einstellungen können unter Einstellungen → Download konfiguriert werden:

Cloud Backup — Verschlüsseltes Usenet-Backup

Der Cloud-Backup-Tab ermöglicht es, Ordner mit AES-256 zu verschlüsseln, ins Usenet hochzuladen und bei Bedarf wiederherzustellen. Die NZB-Datei dient dabei als "Schlüssel" zur Wiederherstellung — solange die Usenet-Retention nicht abgelaufen ist.

1. Seitenübersicht

Der Tab ist vertikal in fünf Karten aufgeteilt:

1. 📁 Backup-Quellen — Ordner hinzufügen/verwalten
2. 🔐 Verschlüsselung & Einstellungen — Passwort, Optionen
3. 📋 Backup-Verlauf — Tabelle aller durchgeführten Backups
4. 📥 Wiederherstellung — NZB-basierte Wiederherstellung
5. 📋 Backup Log — Echtzeit-Protokoll

2. Backup-Quellen (Karte 1)

2.1 Ordner-Liste

Jeder hinzugefügte Ordner wird als eigene Zeile mit folgenden Elementen angezeigt:

2.2 Pro-Ordner-Einstellungen (ausklappbar)

Über den ⚙-Button werden individuelle Einstellungen für jeden Ordner sichtbar:

2.3 Änderungserkennung

Zenith überwacht alle 5 Minuten die Backup-Ordner auf Veränderungen: - Neue, geänderte oder gelöschte Dateien werden erkannt - Status wechselt zu orange: ⚠ 3 Ordner mit Tooltip-Details - Nach erfolgreichem Backup wird der Status wieder grün

2.4 Buttons

3. Verschlüsselung & Einstellungen (Karte 2)

3.1 Linke Seite — Passwort

⚠ Wichtig: Ohne das Passwort können Backups NICHT wiederhergestellt werden. Es gibt keine Passwort-Wiederherstellung.

3.2 Rechte Seite — Globale Einstellungen

3.3 Info-Tooltips (ℹ)

Neben bestimmten Feldern erscheinen Info-Tooltips mit ausführlichen Erklärungen: - Passwort: Erklärt AES-256 und warnt vor Passwort-Verlust - Retention: Erklärt die Retention-Warnung mit Provider-Beispielen

4. Backup-Verlauf (Karte 3)

Eine Tabelle mit allen durchgeführten Backups:

5. Wiederherstellung (Karte 4)

Zum Wiederherstellen eines Backups werden drei Angaben benötigt:

Wiederherstellungs-Prozess

1. 📥 Download — Verschlüsselte Archive werden über den Usenet-Provider heruntergeladen
2. 🛡 PAR2-Reparatur — Fehlende Segmente werden repariert (20% Redundanz)
3. 🔓 Entschlüsselung — 7-Zip entpackt mit dem angegebenen Passwort
4. 📁 Dateien — Originaldateien werden im Ziel-Ordner wiederhergestellt

6. Backup Log (Karte 5)

Identisch zu den Logs in Upload/Download-Tab:

• Terminal-Design mit Monospace-Schrift
• ** Höhe**, scrollbar
• Farbcodiert: Grün (Erfolg), Rot (Fehler), Grau (Info)

Typische Log-Einträge

7. Automatisierungs-Features

7.1 Zeitplan-Backups

Für jeden Ordner kann ein automatischer Zeitplan konfiguriert werden:

• Zeitplan-Prüfung läuft alle 60 Sekunden
• Backups werden nur gestartet, wenn das letzte Backup älter als das Intervall ist

7.2 Retention-Warnung

Zenith warnt automatisch vor ablaufenden Backups: - Prüfung alle 2 Stunden + initial nach 5 Sekunden - Warnung erscheint 30 Tage vor Retention-Ablauf - Wiederholt sich alle 2 Tage - Kann pro Backup stumm geschaltet werden (Mute)

7.3 Änderungserkennung

• Prüfung alle 5 Minuten + initial nach 10 Sekunden
• Vergleicht Datei-Timestamps mit dem Zeitpunkt des letzten Backups
• Zeigt betroffene Unterordner im Status-Tooltip
• Orange Status-Anzeige bei Änderungen

8. Backup-Prozess (technisch)

8.1 Backup-Ablauf

Ordner auswählen → Verschlüsseln (7-Zip AES-256)
 → PAR2 erstellen (20% Redundanz)
 → Upload über NNTP
 → NZB speichern (= Backup-Index)
 → Temp-Dateien aufräumen

8.2 Verschlüsselungsmodus

• Algorithmus: AES-256 (via 7-Zip -p Flag)
• Header-Verschlüsselung: Aktiviert (-mhe=on) — Dateinamen sind nicht sichtbar
• Split-Archive: Konfigurierbares Volume (10–2000 MB)
• PAR2-Redundanz: Fest 20% für maximale Datenintegrität
• Newsgroup: Standardmäßig "privat" (ohne Newsgroup-Header)

8.3 Backup-Modi

Statistik Tab — Upload- & Download-Statistiken

Der Statistik-Tab bietet eine visuelle Übersicht über alle Upload- und Download-Aktivitäten mit interaktiven Balkendiagrammen, Kennzahlen-Karten und einer Verlaufs-Ansicht. Die Daten werden aus der lokalen SQLite-Datenbank gelesen und alle 5 Sekunden aktualisiert.

1. Seitenübersicht

Der Tab ist vertikal aufgeteilt in:

1. Header mit Zeitraum-Filter — Dropdown zur Periodenauswahl
2. Upload-Kennzahlen — 6 Statistik-Karten
3. Upload-Volumen-Diagramm — Interaktives Balkendiagramm
4. Download-Kennzahlen — 6 Statistik-Karten
5. Download-Volumen-Diagramm — Interaktives Balkendiagramm
6. Letzte Uploads — Verlaufsliste
7. Letzte Downloads — Verlaufsliste
8. Reset-Button — Alle Statistiken löschen

2. Header & Zeitraum-Filter

Zeitraum-Optionen

Der Zeitraum beeinflusst alle angezeigten Statistiken (Kennzahlen, Diagramme, Verlauf).

3. Upload-Kennzahlen (⬆ UPLOADS)

Sechs Statistik-Karten nebeneinander, jede mit Icon, Titel und großem Wert:

Geschwindigkeitsberechnung: Die Durchschnittsgeschwindigkeit wird aus den timed_bytes_uploaded und upload_seconds Spalten berechnet — also nur die tatsächliche Transferzeit, ohne Pack/PAR2-Phasen.

4. Upload-Volumen-Diagramm

Ein Custom-Widget (BarChartWidget) das mit QPainter gezeichnet wird:

Darstellung

• Balken: Gradient von Dunkelblau zu Cyan mit abgerundeten Ecken
• Y-Achse: Automatische Skalierung mit Rasterlinien (gepunktet)
• X-Achse: Datum (DD.MM), Monat (MM) oder Jahr (YYYY) je nach Zeitraum
• Wert: Über jedem Balken wird der Wert angezeigt
• Einheit: [GB] oben links
• Leerzustand: "Keine Daten vorhanden" bei fehlenden Daten

Mindestgröße

• Höhe
• Automatische Breite (füllt verfügbaren Platz)

5. Download-Kennzahlen (⬇ DOWNLOADS)

Identische Struktur wie die Upload-Kennzahlen, aber in Violett:

6. Download-Volumen-Diagramm

Identisch zum Upload-Diagramm, aber mit violettem Farbverlauf ( →).

7. Letzte Uploads (Verlaufsliste)

Zeigt die letzten 10 Uploads als scrollbare Liste mit:

Farbgebung

• ✅ Erfolgreich: Grün
• ❌ Fehlgeschlagen: Rot
• ⏳ Ausstehend: Gelb
• Leerzustand: "Noch keine Uploads vorhanden."

8. Letzte Downloads (Verlaufsliste)

Identische Struktur wie "Letzte Uploads", zeigt die letzten 10 Downloads:

Leerzustand: "Noch keine Downloads vorhanden."

9. Statistik zurücksetzen

Am unteren Rand befindet sich ein roter Reset-Button:

Bestätigungs-Dialog

Vor dem Löschen erscheint ein Warnungs-Dialog:

Möchtest du wirklich alle Statistiken zurücksetzen?

Dies löscht alle Upload- und Download-Statistiken,
sowie die Upload-Historie. Diese Aktion kann nicht
rückgängig gemacht werden.

[Ja, zurücksetzen] [Abbrechen]

Das Zurücksetzen löscht die Tabellen stats, uploads und downloads in der SQLite-Datenbank.

10. Datenquelle

Alle Statistiken werden aus der lokalen SQLite-Datenbank gelesen (~/.zenith-uploader/zenith.db):

stats-Tabelle (tägliche Aggregation)

uploads-Tabelle (Einzelaufzeichnung)

downloads-Tabelle (Einzelaufzeichnung)

VPN Guard — VPN-Schutz für Uploads

Der VPN Guard Tab verwaltet VPN-Verbindungen über OpenVPN und WireGuard. Profile können für verschiedene Anbieter und Länder gespeichert werden. Der Kill-Switch pausiert automatisch alle Uploads bei VPN-Abbruch.

1. Seitenübersicht

Der Tab ist vertikal aufgeteilt in:

1. Header — Titel und Beschreibung
2. Root-Warnung — Hinweis bei fehlenden Root-Rechten (Linux)
3. Status Card — Aktueller VPN-Status mit Connect/Disconnect
4. Gespeicherte Profile — Liste der VPN-Profile
5. Einstellungen — Kill-Switch Konfiguration
6. VPN Log — Echtzeit-Protokoll

2. Header

3. Root-Warnung (Linux)

Auf Linux wird geprüft, ob Root-Rechte oder pkexec verfügbar sind. Ohne Root erscheint eine gelbe Warnbox:

⚠ Root-Rechte nicht verfügbar. VPN benötigt Root (pkexec oder sudo).
Installiere policykit-1: sudo apt install policykit-1

Auf Windows wird diese Warnung nicht angezeigt.

4. Status Card (Hauptbereich)

Die zentrale Status-Karte zeigt den aktuellen VPN-Zustand:

4.1 Status-Anzeige

4.2 Connect/Disconnect Buttons

5. Gespeicherte Profile

5.1 Profil-Karten

Jedes gespeicherte Profil wird als klickbare Karte angezeigt:

Auswahl-Logik

• Klick auf eine Karte wählt das Profil aus (blaue Umrandung)
• Das aktive Profil wird in der Config gespeichert und beim nächsten Connect verwendet
• Config-Pfad, Auth-User und Auth-Pass werden automatisch in die aktive Config übernommen

Leerzustand

Keine Profile gespeichert. Füge ein VPN-Profil hinzu, um loszulegen.

5.2 Profil hinzufügen (＋ Button → Dialog)

Beim Klick auf "＋ Profil hinzufügen" öffnet sich ein Formular-Dialog:

Unterstützte Länder

Protokoll-abhängige Felder

• OpenVPN: User/Pass-Felder sichtbar, Config-Filter *.ovpn
• WireGuard: User/Pass-Felder ausgeblendet, Config-Filter *.conf

6. Einstellungen

Kill-Switch

Beschreibungstext:

Wenn die VPN-Verbindung unerwartet abbricht, werden alle laufenden Uploads sofort pausiert.

Kill-Switch Funktionsweise

1. VPN-Verbindung bricht ab (openvpn/wireguard Prozess endet unerwartet)
2. Der AppController erkennt den Status-Wechsel über vpn_status_changed
3. Alle laufenden Uploads werden sofort pausiert
4. Der Benutzer wird benachrichtigt (Status wechselt zu FEHLER)
5. Nach erneuter VPN-Verbindung können Uploads manuell fortgesetzt werden

7. VPN Log

Echtzeit-Protokoll der VPN-Aktivitäten:

• Terminal-Design mit Monospace-Schrift
• ** Höhe**, scrollbar

Typische Log-Einträge

8. VPN-Engine (Hintergrund)

Unterstützte Protokolle

Verbindungsprozess

1. Profil-Daten werden in die aktive Config geschrieben
2. VPN-Prozess wird gestartet (über pkexec auf Linux, direkt auf Windows)
3. Verbindungsstatus wird über den Prozess-Output überwacht
4. IP-Adresse wird nach Verbindungsaufbau ermittelt
5. Dashboard-VPN-Widget wird über Signal vpn_status_changed aktualisiert

Teil 7a: Remote Eingänge — RSS Feeds (📡)

Remote Eingänge — RSS Feeds

Der RSS-Feed-Subtab ermöglicht das automatische Abfragen von RSS-Feeds (z.B. von Usenet-Indexern), Filtern nach Kriterien und Hinzufügen der gefundenen NZBs zur Download-Queue.

1. Übersicht

Der Tab "📡 RSS Feeds" ist der erste Subtab unter "Remote Inputs" und vertikal in zwei Bereiche (Splitter) aufgeteilt:

1. Oben: Feed-Tabelle mit allen gespeicherten RSS-Feeds
2. Unten: Bearbeitungsformular + Feed-Vorschau + Statuslog

2. Feed-Tabelle (oberer Bereich)

2.1 Tabellenspalten

2.2 Buttons

3. Feed-Einstellungen (unterer Bereich)

Beim Klick auf einen Feed in der Tabelle werden die Einstellungen im unteren Formular geladen.

3.1 Formularfelder

3.2 Regex-Filter Beispiele

Tipps: - . = beliebiges Zeichen (auch Punkt/Leerzeichen) - \\. = nur ein Punkt - .* = beliebig viele Zeichen - Filter ist case-insensitive

3.3 Buttons

4. Feed-Vorschau

Nach einer Abfrage werden die Ergebnisse in einer Vorschau-Tabelle angezeigt:

4.1 Tabellenspalten

4.2 Vorschau-Buttons

4.3 Dismissed GUIDs

Entfernte Einträge werden über ihre GUID gespeichert und bei zukünftigen Abfragen nicht erneut angezeigt. Die dismissed GUIDs werden in der Config persistiert.

5. Status-Log

Am unteren Rand des Formulars ein einzeiliges Label mit Statusmeldungen:

6. Automatischer Polling

Wenn ein Feed aktiviert und ein Intervall gesetzt ist: 1. Zenith prüft im Hintergrund alle X Minuten den Feed 2. Neue Einträge werden gegen den Titel-Filter und die Größenfilter geprüft 3. Bereits gesehene GUIDs werden übersprungen 4. Bei "Automatisch zur Queue": NZBs werden direkt zum Download hinzugefügt 5. Ohne Auto-Queue: Einträge erscheinen in der Vorschau zur manuellen Auswahl

Teil 7b: Remote Eingänge — Newznab (🔍)

Remote Eingänge — Newznab Indexer

Der Newznab-Subtab ermöglicht die Anbindung an Usenet-Indexer (z.B. NZBGeek, DrunkenSlug, NZBFinder), um automatisch NZBs nach Kategorien, Filtern und Zeitintervallen abzurufen.

1. Übersicht

Der Tab "🔍 Newznab" ist der zweite Subtab unter "Remote Inputs" und vertikal in zwei Bereiche (Splitter) aufgeteilt:

1. Oben: Feed-Tabelle mit allen konfigurierten Newznab-Indexern
2. Unten: Bearbeitungsformular + Statuslog

2. Feed-Tabelle (oberer Bereich)

2.1 Tabellenspalten

2.2 Buttons

3. Feed-Einstellungen (unterer Bereich)

Beim Klick auf einen Indexer in der Tabelle werden die Einstellungen geladen.

3.1 Formularfelder

3.2 Newznab-Kategorien

Tipp: Mehrere Kategorien mit Komma trennen. Leer = alle Kategorien.

3.3 Regex-Filter

Identisch zum RSS-Feed-Tab. Case-insensitive Regex-Filter für Titel:

4. Aktions-Buttons

5. Status-Log

Statusmeldungen im unteren Bereich:

6. Newznab API-Integration

6.1 API-Endpunkte

Zenith nutzt die Standard-Newznab API:

6.2 Polling-Ablauf

1. Timer löst Abfrage aus (alle X Minuten)
2. API-Anfrage mit Kategorien und Limit
3. Ergebnisse werden gegen Titel-Filter (Regex) geprüft
4. Größen-Filter (Min/Max) wird angewendet
5. Bereits bekannte GUIDs werden übersprungen
6. Bei "Automatisch herunterladen": NZBs werden heruntergeladen und zur Queue hinzugefügt
7. Bei "Queue automatisch starten": Download startet sofort

7. Kompatible Indexer

Zenith unterstützt alle Newznab-kompatiblen Indexer, z.B.:

Teil 7c: Remote Eingänge — FTP / SFTP (📂)

Remote Eingänge — FTP / SFTP

Der FTP-Subtab bietet einen integrierten FTP/SFTP-Client mit Datei-Browser, Navigation und Datei-Download. Damit können Dateien von einem Remote-Server direkt in Zenith heruntergeladen werden.

1. Übersicht

Der Tab "📂 FTP / SFTP" ist der dritte Subtab unter "Remote Inputs" und besteht aus:

1. Verbindungseinstellungen — Host, Port, Zugangsdaten
2. Remote-Datei-Browser — Interaktive Dateiliste mit Navigation
3. Download-Bereich — Lokaler Zielordner + Download-Button
4. Status-Log — Verbindungs- und Download-Status

2. Verbindungseinstellungen

2.1 Formularfelder

2.2 Verbindungs-Buttons

2.3 Verbindungsstatus

3. Remote-Datei-Browser

3.1 Navigationsleiste

Alle Navigationsbuttons sind erst nach erfolgreicher Verbindung aktiv.

3.2 Datei-Tabelle

3.3 Interaktion

3.4 Unterstützte Protokolle

4. Download-Bereich

4.1 Download-Prozess

1. Ausgewählte Dateien werden nacheinander heruntergeladen
2. Fortschritt wird über Signal _ftp_dl_progress_signal gemeldet
3. Status-Log zeigt den aktuellen Download-Status
4. Dateien werden im gewählten lokalen Ordner gespeichert

4.2 Ordner-Download

Bei Auswahl eines Ordners wird der gesamte Inhalt rekursiv heruntergeladen.

5. Status-Log

Einzeiliges Label mit Statusmeldungen:

6. Technische Details

6.1 SFTP-Optimierungen

transport.window_size = 2 * 1024 * 1024 # 2 MB Window für schnellen Transfer
transport.packetizer.REKEY_BYTES = pow(2, 40) # Rekeying erst nach 1 TB
transport.packetizer.REKEY_PACKETS = pow(2, 40) # Rekeying-Intervall sehr hoch
transport.set_keepalive(30) # Keepalive alle 30 Sekunden

6.2 FTP-Optimierungen

ftp.set_pasv(True) # Passiv-Modus für NAT/Firewall
ftp.sendcmd("OPTS UTF8 ON") # UTF-8-Modus für Sonderzeichen

6.3 Threading

Alle Verbindungs- und Navigations-Operationen laufen in Background-Threads, um die UI nicht zu blockieren. Cross-Thread-Updates werden über Qt-Signals (_ftp_log_signal, _ftp_listing_signal, _ftp_dl_progress_signal) an den Main-Thread übermittelt.

Teil 8a: Auto-Post — Forum Poster (📝)

Auto-Post — Forum Poster

Der Forum-Poster-Subtab ermöglicht automatisches oder manuelles Posten von Upload-Informationen in Usenet-Foren. Profile können für verschiedene Forum-Engines erstellt, getestet und verwaltet werden.

1. Übersicht

Der Tab "📝 Forum Poster" ist der erste Subtab unter "Auto-Post" und besteht aus:

1. Header — Titel + "＋ Profil hinzufügen" Button
2. Profil-Karten — Liste aller Forum-Profile
3. Post-Queue — Manuelle Post-Warteschlange
4. Hinweis-Karte — Legende mit Tipps

2. Profil-Karten

Jedes Forum-Profil wird als klickbare Karte mit farbcodiertem linken Rand angezeigt:

2.1 Karten-Elemente

2.2 Engine-Farben

2.3 Interaktion

Leerzustand

Keine Forum-Profile konfiguriert.
Füge ein Profil hinzu um automatisch zu posten.

3. Profil hinzufügen / bearbeiten (Dialog)

Beim Klick auf "＋ Profil hinzufügen" oder eine bestehende Karte öffnet sich ein Formular-Dialog:

3.1 Formularfelder

3.2 Thread-Titel Platzhalter

3.3 Dialog-Buttons

3.4 Verbindungstest

Der Test läuft im Hintergrund-Thread: 1. Forum-URL wird geparsed (Basis-URL + Forum-ID) 2. Login wird versucht 3. Ergebnis wird als QMessageBox angezeigt (Erfolg / Fehler)

4. Post-Modi

5. Post-Queue (Manuell)

Uploads die über Profile im Modus "Manuell" konfiguriert sind, erscheinen hier:

5.1 Queue-Karten

Jeder Eintrag wird als Karte mit gelbem linken Rand angezeigt:

5.2 Posting-Ablauf (Manuell)

1. Klick auf "▶ Posten"
2. Forum-Engine wird geladen
3. Login wird durchgeführt
4. Template wird gerendert (Platzhalter ersetzt)
5. Anti-Spam Timer wird abgewartet
6. Thread wird erstellt
7. Bei Erfolg: Eintrag wird aus der Queue entfernt

Leerzustand

Keine Posts in der Warteschlange.

6. Hinweis-Karte (Legende)

Am unteren Rand eine Info-Karte mit Tipps:

• ● Gib den direkten Forum-Link ein (z.B. forumdisplay.php?f=89)
• ● Automatisch: Postet sofort nach Upload-Abschluss
• ● Manuell: Upload erscheint in der Post-Queue zur Prüfung
• ● Der Anti-Spam Timer verhindert zu schnelles Posten
• ● Aktuell unterstützt: vBulletin 3.x (weitere Engines folgen)

7. Unterstützte Forum-Engines

Teil 8b: Auto-Post — Vorlagen / Templates (📄)

Auto-Post — Vorlagen (Templates)

Der Vorlagen-Subtab bietet einen BBCode/HTML-Template-Editor mit Live-Toolbar, Platzhalter-Referenz und Vorlagen-Verwaltung. Templates werden beim Forum-Posting automatisch mit Upload-Daten befüllt.

1. Übersicht

Der Tab "📄 Vorlagen" ist der zweite Subtab unter "Auto-Post" und besteht aus:

1. Platzhalter-Referenz — Übersicht aller verfügbaren Platzhalter
2. Vorlagen-Liste (links) — Alle gespeicherten Templates
3. Editor (rechts) — BBCode/HTML-Editor mit Toolbar

Das Layout ist als horizontaler Splitter organisiert ( Liste | Editor).

2. Platzhalter-Referenz

Am oberen Rand eine kompakte Chip-Leiste mit allen verfügbaren Platzhaltern:

Jeder Chip ist grün auf dunkelgrünem Hintergrund mit Tooltip.

3. Vorlagen-Liste (links)

3.1 Liste

• Jede Vorlage wird mit dem Icon "📄" und ihrem Namen angezeigt
• Auswahl per Klick lädt die Vorlage in den Editor
• Erste Vorlage wird automatisch ausgewählt

3.2 Buttons

3.3 Einschränkungen

• Minimum: Es muss immer mindestens eine Vorlage existieren
• Maximum: Maximal 10 Vorlagen (konfiguriert über MAX_POSTING_TEMPLATES)
• Standard-Template: Wird automatisch erstellt wenn keine Vorlagen vorhanden sind

4. Editor (rechts)

4.1 Editor-Felder

4.2 BBCode-Toolbar

11 Buttons für schnelles Einfügen von BBCode-Tags:

Verhalten: Bei markiertem Text wird der BBCode um die Auswahl herum eingefügt. Ohne Auswahl werden die Tags an der Cursor-Position eingefügt.

4.3 Editor-Styling

• Schriftart: JetBrains Mono → Consolas → Courier New (Fallback)
• Textfarbe: Grün
• Hintergrund: Dunkel
• Auswahl: Dunkelblau

4.4 Speichern

5. Standard-Template (vBulletin 3.x)

Wird automatisch erstellt wenn keine Vorlagen vorhanden sind:

[center][size=5][color=red][b]{title}[/b][/color][/size][/center]

[center][size=3][color=][b]»Inhalt«[/b][/color][/size]
[size=2][color=white]{description}[/color][/size][/center]

[nfo]{nfo_content}[/nfo]

[hide]
[center][size=3][color=][b]»Header«[/b][/color][/size]
[size=2][color=white]{header}[/color][/size][/center]

[center][size=3][color=][b]»Password«[/b][/color][/size]
[size=2][color=white]{password}[/color][/size][/center]

[center][nzblnk]nzblnk:?t={title}&h={header}&p={password}[/nzblnk]
[/center][/hide]

Template-Elemente erklärt

6. Template-Rendering (Ablauf)

Beim Posten in ein Forum:

1. Template wird aus dem Profil geladen
2. Alle {platzhalter} werden durch aktuelle Upload-Daten ersetzt
3. Thread-Titel wird separat mit eigenem Format gerendert
4. Der fertige BBCode/HTML-Text wird als Thread-Nachricht gepostet

Webhooks & Benachrichtigungen

Der Webhook-Tab ermöglicht das Senden automatischer Benachrichtigungen über verschiedene Kanäle, wenn bestimmte Ereignisse auftreten (z.B. Upload abgeschlossen, VPN verloren, Speicher kritisch).

1. Übersicht

Der Tab besteht aus:

1. Header — Titel + "＋ Webhook hinzufügen" Button
2. Webhook-Karten — Liste aller konfigurierten Webhooks
3. Hinweis-Karte — Legende mit Tipps

2. Unterstützte Anbieter

3. Webhook-Karten

Jeder gespeicherte Webhook wird als klickbare Karte angezeigt:

3.1 Karten-Elemente

3.2 Interaktion

Leerzustand

Keine Webhooks konfiguriert.
Füge einen Webhook hinzu, um Benachrichtigungen zu erhalten.

4. Webhook hinzufügen / bearbeiten (Dialog)

4.1 Allgemeine Felder

4.2 Anbieter-spezifische Felder

Discord

Telegram

E-Mail

ntfy

Custom

5. Ereignisse

Pro Webhook können folgende Ereignisse aktiviert/deaktiviert werden:

Standard: Alle Ereignisse sind bei neuen Webhooks aktiviert.

6. Datenfelder

Welche Informationen in der Benachrichtigung enthalten sein sollen:

7. Test senden

Der Dialog enthält einen "🔔 Test senden" Button:

1. Aktueller Dialog-Zustand wird temporär als Webhook-Objekt erzeugt
2. WebhookDispatcher.send_test wird aufgerufen
3. Eine Test-Benachrichtigung wird an den konfigurierten Anbieter gesendet
4. Erfolg/Fehler wird als QMessageBox angezeigt

8. Hinweis-Karte (Legende)

Am unteren Rand eine Info-Karte:

• ● Klicke auf eine Karte zum Bearbeiten
• ● Klicke ● / ○ zum Aktivieren / Deaktivieren
• ● Mehrere Webhooks pro Anbieter möglich
• ● Ereignisse und Datenfelder sind pro Webhook konfigurierbar

Teil 10a: Einstellungen — Provider (🌐)

Einstellungen — Provider

Der Provider-Subtab verwaltet die Usenet-Server-Konfiguration. Mehrere Provider können hinzugefügt, getestet und für Upload, Download oder beides verwendet werden.

1. Übersicht

Der Tab besteht aus:

1. Provider-Tabelle — Alle konfigurierten Usenet-Provider
2. Add/Edit-Formular — Neuen Provider hinzufügen
3. Aktions-Buttons — Hinzufügen + Verbindungstest

2. Provider-Tabelle

2.1 Spalten

2.2 Tabellenverhalten

• Alle Text/Zahl-Spalten sind per Doppelklick direkt editierbar
• Änderungen werden sofort automatisch gespeichert
• Benutzername und Passwort werden nicht in der Tabelle angezeigt (nur in Config)
• Beim Löschen werden alle nachfolgenden Rows neu gebunden

3. Add/Edit-Formular

4. Verbindungstest (🔌 Test Connection)

1. NNTP-Verbindung wird mit nntplib aufgebaut
2. SSL-Context wird bei aktivem SSL erstellt
3. Latenz wird gemessen (ms)
4. Server-Welcome-Message wird angezeigt
5. Bei Fehler: Exception wird angezeigt

Teil 10b: Einstellungen — Upload Einstellungen (⚙)

Einstellungen — Upload Einstellungen

Der Upload-Settings-Subtab enthält alle Konfigurationsoptionen für den Upload-Prozess. Unterteilt in Standard-Einstellungen (immer sichtbar) und Expert-Mode (umschaltbar).

1. Übersicht

Obere Leiste

2. Standard-Einstellungen (3-Spalten-Grid)

2.1 Allgemein

2.2 Verarbeitung

Pipelined vs Sequential: - Sequential: Ein Task wird komplett abgearbeitet bevor der nächste startet - Pipelined: Während ein Upload läuft, wird der nächste Task bereits gepackt. DiskGuard begrenzt automatisch

2.3 Disk Guard

2.4 Cleanup

2.5 Ressourcen

3. Expert-Modus (3-Spalten-Grid)

Sichtbar nur wenn "Expert-Modus aktivieren" aktiviert ist. Hintergrund: violetter Rahmen.

3.1 7zip Compression — Expert

3.2 ParPar — Recovery Data

3.3 NNTP — Upload Engine

Teil 10c: Einstellungen — Download Einstellungen (📥)

Einstellungen — Download Einstellungen

Der Download-Settings-Subtab konfiguriert alle Aspekte des NZB-Download-Prozesses, von Ordnerstruktur über Verarbeitung bis zu Disk Guard und Mirror Mode.

1. Übersicht

Das Layout ist ein 2-Spalten-Grid mit 5 Gruppen:

2. Ordner & Dateien

NZB umbenennen: Nur sinnvoll wenn der NZB-Dateiname nichts über den Inhalt aussagt (z.B. dfbuevnzncuvb.nzb). Nicht empfohlen bei aussagekräftigen Namen.

3. Verarbeitung

Junk-Erweiterungen (nur wenn Junk löschen aktiv)

Die einzelnen Erweiterungen sind nur aktivierbar wenn der Master-Toggle "Junk-Dateien löschen" aktiv ist.

4. Verbindung

5. Disk Guard (Download)

Tipp: Den Download-Disk-Guard 10% niedriger als den Upload-Disk-Guard setzen (z.B. Upload=90% → Download=80%). So wird bei gleichzeitigem Up-/Download der Upload nie blockiert.

6. Mirror Mode

Aktiviert: Archive mit Entpack-Fehler werden gelöscht, um Re-Uploads via Watchfolder zu verhindern. Deaktiviert: Archive bleiben erhalten und können manuell mit dem richtigen Passwort entpackt werden.

Teil 10d: Einstellungen — Überwachungsordner (👁)

Einstellungen — Überwachungsordner

Der Watchfolder-Subtab verwaltet automatisch überwachte Ordner. Neue Dateien/Ordner werden automatisch zur Upload-Queue hinzugefügt.

1. Übersicht

Der Tab besteht aus:

1. Header — Titel + Zähler (z.B. "3 / 10")
2. Subtitle — Erklärungstext
3. Ordner-Liste — Konfigurierte Überwachungsordner als Karten
4. ＋ Hinzufügen Button — Neuen Ordner hinzufügen

2. Ordner-Karten

Jeder überwachte Ordner wird als Karte angezeigt:

2.1 Karten-Elemente

2.2 Status-Logik

Leerzustand

Keine Überwachungsordner konfiguriert

3. Newsgroup-Zuweisung

Jedem Ordner können eigene Newsgroups zugewiesen werden:

3.1 Dropdown-Optionen

3.2 Chip-Verhalten

• Mehrere Newsgroups pro Ordner möglich
• Chip mit "x" Button zum Entfernen einzelner Newsgroups
• "Keine Newsgroup" ersetzt alle anderen
• Hinzufügen einer echten Newsgroup entfernt __none__-Marker
• Ohne Zuweisung: "(Standard-Newsgroups)" in kursiv

3.3 Persistenz

Newsgroups werden in watch_folder_newsgroups gespeichert:

{
 "/pfad/zum/ordner": ["alt.binaries.boneless", "alt.binaries.misc"],
 "/anderer/ordner": ["__none__"]
}

4. Ordner hinzufügen

1. Klick auf "＋ Ordner hinzufügen"
2. Ordner-Dialog öffnet sich
3. Prüfung auf Duplikate (Info-Meldung wenn bereits vorhanden)
4. Maximum: 10 Ordner — Button wird deaktiviert bei Erreichen
5. Watchdog wird sofort neu geladen (controller.reload_watchdog)

5. Ordner entfernen

1. Klick auf "X" Button
2. Ordner wird aus watch_folders entfernt
3. Eintrag aus watch_folders_disabled bereinigt
4. Per-Folder Newsgroups aus watch_folder_newsgroups entfernt
5. Watchdog wird sofort neu geladen

6. Verknüpfung mit Dashboard

Die Watchfolder-Toggle-Switches im Dashboard (● Aktiv / ○ Deaktiviert) schreiben in die watch_folders_disabled Liste. Der Status im Watchfolder-Tab wird beim Tab-Wechsel automatisch aktualisiert.

Lizenz

Der Lizenz-Tab verwaltet die Produktaktivierung, zeigt den aktuellen Lizenzstatus an und bietet HWID-Management für Gerätewechsel.

1. Übersicht

Der Tab besteht aus:

1. Header — Titel + Beschreibung
2. Lizenz-Badge-Karte — Grosses Badge mit Ablaufdatum
3. Aktivierungskarte — Lizenzschlüssel-Eingabe
4. Lizenzverwaltung — 3 Aktions-Karten (HWID Reset, Deaktivieren, HWID kopieren)
5. Demo-Karte (nur im Demo-Modus) — Einschränkungen + Upgrade-Link
6. Features-Karte (nur bei aktiver Lizenz) — Freigeschaltete Features

2. Lizenz-Stufen

3. Lizenz-Badge-Karte

• Grosses Badge mit Lizenz-Status und Icon
• Untertitel:
• DEMO: "Eingeschränkte Funktionen — Upgrade für vollen Zugriff"
• VOLLVERSION: "Alle Features freigeschaltet — Unbegrenzt"
• Trennlinie in Status-Farbe
• Gültig bis: Ablaufdatum / "∞ Unbegrenzt" / "—" (Demo)
• Hintergrund: Gradient in Status-Farbe

4. Lizenz-Aktivierung

Aktivierungs-Flow

1. Schlüssel eingeben
2. license.activate(key) wird aufgerufen
3. Erfolg: result.valid = True → Schlüssel wird in Config gespeichert, Neustart erforderlich
4. Fehler: result.error wird in Dialog angezeigt

5. Lizenzverwaltung (3 Aktions-Karten)

5.1 🔄 HWID zurücksetzen

5.2 ⛔ Lizenz deaktivieren

5.3 📋 HWID kopieren

6. Demo-Einschränkungen (nur DEMO)

Gelbe Warnkarte mit:

Upgrade-Link: → zenith-uploader.com (extern)

7. Freigeschaltete Features (nur Vollversion)

Grüne Feature-Liste:

• ✓ Unbegrenzte Uploads
• ✓ Keine Branding-Header
• ✓ Volle Geschwindigkeit
• ✓ Kill-Switch & VPN Guard
• ✓ Priority Support

Support & Diagnose

Der Support-Tab bietet System-Informationen, einen integrierten Log-Viewer mit Echtzeit-Filterung und Schnellaktionen für Bug-Reports.

1. Übersicht

Der Tab besteht aus:

1. Header — Titel + Versions-Badge (v1.0.0)
2. System-Info-Karten — 4 Karten nebeneinander
3. Log-Viewer — Syntax-hervorgehobener Live-Log
4. Schnellaktionen — 4 Aktions-Karten
5. Footer — Support-E-Mail + Website-Link

2. System-Info-Karten

OS-Erkennung

3. Log-Viewer

3.1 Header-Zeile

3.2 Log-Anzeige

• Quelle: ~/.zenith-uploader/logs/zenith.log
• Max. Zeilen: 1000 (letzte)
• Auto-Refresh: Alle 10 Sekunden via QTimer
• Font: JetBrains Mono 10pt (Fallback: Consolas)
• Scroll: Automatisch zum Ende nach jedem Laden

3.3 Syntax-Highlighting (Log-Level-Farben)

3.4 Filterlogik

1. Level-Filter: Prüft ob [LEVEL im Zeilen-Text enthalten ist
2. Suche: Case-insensitiver Substring-Match
3. Kombination: Beide Filter werden UND-verknüpft
4. HTML-Output: Zeilen werden als farbige <span> in <pre> gerendert

3.5 Aktions-Leiste

4. Schnellaktionen (4 Karten)

4.1 🐛 Fehler melden

Bug-Report E-Mail-Template:

An: [SUPPORT_EMAIL]
Betreff: Zenith Bug Report

Bitte beschreibe das Problem / Please describe the issue:

Schritte zum Reproduzieren / Steps to reproduce:
1.
2.
3.

Erwartetes Verhalten / Expected behavior:

Tatsächliches Verhalten / Actual behavior:

--- System Info ---
OS: [auto]
Python: [auto]
CPU: [auto] Kerne

Bitte die Log-Datei anhängen / Please attach the log file.

4.2 📂 Log-Ordner öffnen

• Öffnet ~/.zenith-uploader/logs/ im System-Dateimanager
• Erstellt den Ordner falls nicht vorhanden

4.3 📋 Log-Pfad kopieren

• Kopiert den vollständigen Pfad zum Log-Ordner in die Zwischenablage

4.4 📊 Systeminfo kopieren

Kopiert formatierten Text:

Zenith Uploader — System Info
===================================
OS: [Betriebssystem]
Python: [Version]
CPU: [Kerne] Kerne
RAM: [Verfügbar] / [Gesamt] GB
Log: [Log-Pfad]

5. Footer

📧 [SUPPORT_EMAIL] · Hilfe & Dokumentation unter zenith-uploader.com