yt/INSTALLATION.md

Einfache Installationsanleitung

Diese Anleitung führt dich Schritt für Schritt durch die Installation der YouTube Downloader Anwendung.

Voraussetzungen

Du brauchst:

• Node.js (Version 20 oder höher) - Download hier
• yt-dlp - wird automatisch installiert (siehe unten)

Schnellinstallation (empfohlen)

Falls du Node.js bereits installiert hast, führe einfach aus:

npm run install:setup

Dieses Skript führt automatisch alle Installationsschritte aus!

Manuelle Installation Schritt für Schritt

Schritt 1: Node.js installieren

1. Gehe zu https://nodejs.org/
2. Lade die LTS-Version herunter (empfohlen)
3. Installiere Node.js mit den Standard-Einstellungen
4. Öffne ein Terminal/Fenster (macOS: Terminal, Windows: PowerShell oder CMD)

Schritt 2: Projekt herunterladen

Falls du das Projekt noch nicht hast:

# Falls du Git hast:
git clone <repository-url>
cd yt

# Oder lade das Projekt als ZIP herunter und entpacke es

Schritt 3: Projekt öffnen

Öffne ein Terminal im Projektordner:

cd yt

Schritt 4: Abhängigkeiten installieren

Führe diesen Befehl aus:

npm install

Das kann einige Minuten dauern. Warte, bis es fertig ist.

Schritt 5: yt-dlp installieren

Für macOS:

brew install yt-dlp

Für Linux (Ubuntu/Debian):

sudo apt-get update
sudo apt-get install yt-dlp

Für Windows:

1. Lade yt-dlp von https://github.com/yt-dlp/yt-dlp/releases
2. Entpacke die Datei
3. Füge den Ordner zu deinem PATH hinzu (optional, aber empfohlen)

Oder mit pip (funktioniert auf allen Systemen):

pip install yt-dlp

Schritt 6: Environment-Variablen einrichten

Erstelle eine Datei namens .env im Projektordner:

Windows (PowerShell):

New-Item -Path .env -ItemType File
notepad .env

macOS/Linux:

touch .env
nano .env

Füge folgende Zeilen ein (ändere die Werte nach deinen Wünschen):

LOGIN_USERNAME=admin
LOGIN_PASSWORD=mein-sicheres-passwort
DOWNLOAD_DIR=./downloaded
SESSION_SECRET=mein-geheimes-session-secret

Speichere die Datei (in nano: Strg+X, dann Y, dann Enter).

Schritt 7: Anwendung starten

Führe diesen Befehl aus:

npm run dev

Du solltest eine Meldung sehen wie:

Local: http://localhost:4321

Schritt 8: Im Browser öffnen

Öffne deinen Browser und gehe zu:

http://localhost:4321

Schritt 9: Anmelden

• Benutzername: Der Wert aus LOGIN_USERNAME in deiner .env Datei
• Passwort: Der Wert aus LOGIN_PASSWORD in deiner .env Datei

Mit Docker (einfacher, aber Docker muss installiert sein)

Wenn du Docker installiert hast, ist es noch einfacher:

Schritt 1: Docker installieren

• macOS: Docker Desktop für Mac
• Windows: Docker Desktop für Windows
• Linux: Folge der Docker Installationsanleitung

Schritt 2: Environment-Variablen setzen

Erstelle eine .env Datei (siehe Schritt 6 oben).

Schritt 3: Starten

docker-compose up --build

Die Anwendung läuft dann auf http://localhost:4321

Häufige Probleme

"npm: command not found"

• Node.js ist nicht installiert oder nicht im PATH
• Installiere Node.js neu und starte das Terminal neu

"yt-dlp: command not found"

• yt-dlp ist nicht installiert
• Folge Schritt 5 oben

"Port 4321 already in use"

• Ein anderer Prozess verwendet den Port
• Ändere den Port in package.json oder beende den anderen Prozess

Login funktioniert nicht

• Prüfe, ob die .env Datei existiert und die richtigen Werte enthält
• Starte den Server neu nach Änderungen an der .env Datei

Hilfe

Bei Problemen:

1. Prüfe, ob alle Schritte korrekt ausgeführt wurden
2. Stelle sicher, dass Node.js und yt-dlp installiert sind
3. Prüfe die Fehlermeldungen im Terminal