Initial commit of YouTube Downloader application, including core functionality for downloading videos, user authentication, and Docker support. Added configuration files, environment setup, and basic UI components using Astro.js and Tailwind CSS.

INSTALLATION.md

@@ -0,0 +1,176 @@
+# 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 <repository-url>
+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
+