177 lines
4.0 KiB
Markdown
177 lines
4.0 KiB
Markdown
# 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
|
|
|