# 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](https://nodejs.org/) - **yt-dlp** - wird automatisch installiert (siehe unten) ## Schnellinstallation (empfohlen) Falls du Node.js bereits installiert hast, führe einfach aus: ```bash 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/](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: ```bash # Falls du Git hast: git clone cd yt # Oder lade das Projekt als ZIP herunter und entpacke es ``` ### Schritt 3: Projekt öffnen Öffne ein Terminal im Projektordner: ```bash cd yt ``` ### Schritt 4: Abhängigkeiten installieren Führe diesen Befehl aus: ```bash npm install ``` Das kann einige Minuten dauern. Warte, bis es fertig ist. ### Schritt 5: yt-dlp installieren **Für macOS:** ```bash brew install yt-dlp ``` **Für Linux (Ubuntu/Debian):** ```bash 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](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):** ```bash pip install yt-dlp ``` ### Schritt 6: Environment-Variablen einrichten Erstelle eine Datei namens `.env` im Projektordner: **Windows (PowerShell):** ```powershell New-Item -Path .env -ItemType File notepad .env ``` **macOS/Linux:** ```bash 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: ```bash 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](https://www.docker.com/products/docker-desktop/) - **Windows**: [Docker Desktop für Windows](https://www.docker.com/products/docker-desktop/) - **Linux**: Folge der [Docker Installationsanleitung](https://docs.docker.com/engine/install/) ### Schritt 2: Environment-Variablen setzen Erstelle eine `.env` Datei (siehe Schritt 6 oben). ### Schritt 3: Starten ```bash 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