Schnellstart

Quelldateien

Diese Seite wurde aus den folgenden Quelldateien erstellt:

• docs/getting-started.md
• docs/installation.md
• core/app.go
• core/config.go
• core/aes.go
• core/rule.go
• core/bind.go
• core/http.go
• core/utils.go
• core/proxy.go

Download und Installation

Download-Quellen

Die Software wird über zwei Hauptkanäle verteilt. Die primäre Quelle ist GitHub Releases, wo die neuesten Versionen veröffentlicht werden. Als Alternative steht ein Mirror-Service über Lanzou Cloud zur Verfügung, der speziell für Benutzer in China optimiert ist (docs/getting-started.md:1-5).

Verfügbare Download-Quellen:

Wichtiger Hinweis für Windows 7 Benutzer: Aufgrund von Kompatibilitätsproblemen wird Windows 7 Benutzern empfohlen, die Version 2.3.0 zu verwenden, da neuere Versionen möglicherweise nicht vollständig unterstützt werden (docs/getting-started.md:1-5).

Systemanforderungen und Dateiauswahl

Die korrekte Installationsdatei hängt vom verwendeten Betriebssystem und der Systemarchitektur ab (docs/installation.md:1-11).

Betriebssystem-spezifische Auswahl:

Installationsprozess nach Betriebssystem

Windows Installation:

1. Die heruntergeladene .exe-Datei per Doppelklick ausführen
2. Den Installationsanweisungen folgen
3. Wichtig: Bei der ersten Ausführung mit Rechtsklick → "Als Administrator ausführen" starten (docs/installation.md:6-8)

macOS Installation:

1. Die .dmg-Datei öffnen
2. Die Anwendung res-downloader in den Programme-Ordner ziehen (docs/installation.md:9-11)

Linux Installation:

Für Ubuntu/Debian-Systeme steht ein .deb-Paket zur Verfügung:

bash
1sudo apt install res-downloader_3.0.2_linux_x64.deb

Alternativ kann die ausführbare Datei direkt verwendet werden:

bash
1chmod +x ./res-downloader_3.0.2_linux_x64
2sudo ./res-downloader_3.0.2_linux_x64

(docs/installation.md:13-20)

---

Erste Schritte und Inbetriebnahme

Grundlegende Startanforderungen

Vor der ersten Verwendung müssen bestimmte Voraussetzungen erfüllt sein, damit die Software korrekt funktioniert. Die Anwendung benötigt Administratorrechte und muss ein SSL-Zertifikat installieren, um den Netzwerkverkehr überwachen zu können (docs/getting-started.md:7-12).

Erforderliche Schritte:

1. Zertifikatsinstallation zulassen: Während der Installation oder beim ersten Start muss der Installation des Zertifikats zugestimmt werden
2. Netzwerkzugriff erlauben: Die Firewall muss den Netzwerkzugriff für die Anwendung zulassen
3. Administratorrechte (Windows): Unter Windows muss die Anwendung beim ersten Start mit Administratorrechten ausgeführt werden

Startsequenz und Proxy-Aktivierung

Nach dem erfolgreichen Start der Anwendung ist die Aktivierung des Proxysystems erforderlich, damit die Software Netzwerkressourcen erfassen kann (docs/getting-started.md:7-12).

Schritt-für-Schritt-Anleitung:

1. Anwendung starten (Windows: Rechtsklick → "Als Administrator ausführen")
2. Im Hauptfenster oben links auf "Proxy starten" klicken
3. Die Quelle öffnen, deren Ressourcen erfasst werden sollen (z.B. Video-Plattformen, Webseiten, Mini-Programme)
4. Zurück zur Anwendung wechseln – die erfassten Ressourcen werden nun in der Liste angezeigt

Technische Details zur Zertifikatsinstallation

Intern verwendet die Anwendung ein eingebettetes CA-Zertifikat, das für HTTPS-Interception erforderlich ist. Dieses Zertifikat wird bei der ersten Installation im Benutzerdatenverzeichnis abgelegt (core/app.go:143-154).

Die Zertifikatsinstallation erfolgt durch die installCert()-Methode, die:

• Das Zertifikat im System installiert
• Bei Erfolg eine Lock-Datei (install.lock) erstellt
• Fehler bei der Installation protokolliert

---

Wichtige Hinweise und Fehlerbehebung

Windows-spezifische Probleme

Problem: Anwendung startet nicht oder funktioniert nicht korrekt

Ursache: Sicherheitssoftware oder fehlende Administratorrechte (docs/getting-started.md:14-16).

Lösung:

1. Alle Sicherheits- und Antivirenprogramme vorübergehend deaktivieren
2. Installation erneut durchführen
3. Nach der Installation beim ersten Start zwingend mit Rechtsklick → "Als Administrator ausführen" starten

macOS-spezifische Probleme

Problem: Netzwerkverkehr wird nicht erfasst

Ursache: Die macOS-Firewall blockiert eingehende Verbindungen oder verhindert das Proxy-System (docs/getting-started.md:14-16).

Lösung:

• Systemeinstellungen → Sicherheit → Firewall deaktivieren
• Oder: Ausnahme für res-downloader in den Firewall-Einstellungen hinzufügen

Proxy-Aktivierungsprobleme

Problem: Proxy lässt sich nicht aktivieren oder Ressourcen werden nicht erfasst

Die Proxy-Aktivierung erfolgt intern über die OpenSystemProxy()-Methode, die den Systemproxy konfiguriert (core/app.go:156-166).

Mögliche Ursachen und Lösungen:

Erweiterte Fehlerbehebung

Bei anhaltenden Problemen können folgende Schritte helfen:

1. Lock-Datei prüfen: Die Datei install.lock im Benutzerdatenverzeichnis muss existieren
2. Konfiguration zurücksetzen: Die Anwendung bietet eine Reset-Funktion, die alle Einstellungen und Caches löscht
3. Logs prüfen: Die Anwendung protokolliert Fehler in einem Logger-System

---

Konfiguration und Speicherorte

Standardkonfiguration

Die Anwendung verwendet eine Standardkonfiguration, die beim ersten Start erstellt wird. Diese Konfiguration wird im JSON-Format gespeichert und kann über die Benutzeroberfläche angepasst werden (core/config.go:52-73).

Wichtige Standardwerte:

Verzeichnisstruktur

Die Anwendung speichert alle benutzerspezifischen Daten in einem zentralen Verzeichnis, das beim ersten Start erstellt wird (core/app.go:112-117).

Speicherorte nach Betriebssystem:

Wichtige Dateien im Benutzerdatenverzeichnis:

• config.json – Anwendungskonfiguration
• install.lock – Marker für erfolgreiche Zertifikatsinstallation
• pass.cache – Zwischengespeicherte Anmeldedaten
• cert.crt – Installiertes SSL-Zertifikat

Konfigurationsdatei bearbeiten

Die Konfiguration wird automatisch beim Start geladen und mit den Standardwerten zusammengeführt. Benutzerdefinierte Einstellungen werden in config.json gespeichert und haben Vorrang vor den Standardwerten (core/config.go:52-73).

---

Netzwerk- und Proxy-Einstellungen

Proxy-Konfiguration

Die Anwendung fungiert als lokaler HTTP/HTTPS-Proxy, der den Netzwerkverkehr überwacht und Medienressourcen extrahiert. Die Proxy-Einstellungen werden automatisch im System konfiguriert, wenn die Proxy-Funktion aktiviert wird (core/app.go:156-166).

Verfügbare Proxy-Optionen:

Upstream-Proxy konfigurieren

Falls ein Upstream-Proxy erforderlich ist (z.B. in Unternehmensnetzwerken), kann dieser in der Konfiguration angegeben werden. Die Einstellung UpstreamProxy akzeptiert eine vollständige Proxy-URL (core/config.go:52-73).

Beispielkonfiguration:

json
1{
2  "UpstreamProxy": "http://proxy.example.com:8080",
3  "OpenProxy": true,
4  "DownloadProxy": true
5}

---

Verifikation und Test

Erfolgreiche Installation überprüfen

Nach der Installation und dem ersten Start kann die Funktionalität durch folgende Schritte verifiziert werden:

1. Anwendung startet korrekt: Das Hauptfenster wird angezeigt
2. Proxy aktivierbar: Der Button "Proxy starten" ist funktional
3. Zertifikat installiert: Keine Warnungen bei HTTPS-Verbindungen

Test-Download durchführen

Um die Funktionalität zu testen:

1. Proxy in der Anwendung aktivieren
2. Einen Browser öffnen und eine Video-Webseite aufrufen
3. Ein Video abspielen
4. Zurück zur Anwendung wechseln – das Video sollte in der Ressourcenliste erscheinen

Logs und Diagnose

Bei Problemen können die internen Logs Aufschluss geben. Die Anwendung verwendet ein Logger-System, das Fehler und Warnungen protokolliert (core/app.go:118).

---

Nächste Schritte

Nach erfolgreicher Installation und Inbetriebnahme stehen folgende Funktionen zur Verfügung:

Ressourcen-Management

• Ressourcen filtern: Nach Typ (Video, Audio, Bild) filtern
• Qualität auswählen: Verschiedene Qualitätsstufen für Downloads wählen
• Batch-Downloads: Mehrere Ressourcen gleichzeitig herunterladen

Erweiterte Konfiguration

• Regeln anpassen: Eigene Erfassungsregeln definieren
• MIME-Typen erweitern: Zusätzliche Dateiformate unterstützen
• Benutzer-Agent anpassen: Spezifische User-Agent-Strings konfigurieren

Integration und Automatisierung

Die Anwendung bietet verschiedene Integrationsmöglichkeiten, die in der vollständigen Dokumentation beschrieben werden. Für detaillierte Informationen zur Konfiguration und erweiterten Nutzung wird auf das Kapitel "Verwendungshandbuch" verwiesen.