YouTube Downloader

Eine einfache Web-Anwendung zum Herunterladen von YouTube-Videos mit Astro.js und yt-dlp.

Features

• Einfache Login-Seite
• YouTube URL Download-Interface
• yt-dlp Integration für Video-Downloads (läuft innerhalb der App über npm-Package)
• Tailwind CSS für modernes Design
• Docker-Support

Voraussetzungen

• Node.js 20 oder höher
• Docker (optional, für Container-Deployment)

Installation

Für unerfahrene Nutzer: Siehe INSTALLATION.md für eine detaillierte Schritt-für-Schritt-Anleitung.

Schnellstart

1. Dependencies installieren:

npm install

2. yt-dlp installieren:

# macOS
brew install yt-dlp

# Linux
sudo apt-get install yt-dlp

# Windows oder mit pip
pip install yt-dlp

3. Environment-Variablen einrichten:

Erstelle eine .env Datei im Projektordner:

LOGIN_USERNAME=admin
LOGIN_PASSWORD=dein-passwort
DOWNLOAD_DIR=./downloaded
SESSION_SECRET=dein-session-secret

4. Development-Server starten:

npm run dev

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

Mit Docker

1. Docker Image bauen und starten:

docker-compose up --build

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

Als Desktop-App (Electron)

Für macOS:

npm run electron:build:mac

Für Windows:

npm run electron:build:win

Die fertige App wird in dist-electron/ erstellt:

• macOS: .dmg Installer oder .zip Portable Version
• Windows: .exe Installer oder Portable .exe

Siehe BUILD-MACOS.md für detaillierte Anleitung.

Verwendung

1. Öffne die Anwendung im Browser
2. Melde dich mit den konfigurierten Credentials an (siehe Environment-Variablen)
3. Gib eine YouTube URL in das Eingabefeld ein
4. Klicke auf "Download"
5. Das Video wird in den konfigurierten Ordner heruntergeladen (Standard: /downloaded)

Konfiguration

Environment-Variablen

• LOGIN_USERNAME: Benutzername für den Login (erforderlich wenn LOGIN nicht auf false gesetzt ist)
• LOGIN_PASSWORD: Passwort für den Login (erforderlich wenn LOGIN nicht auf false gesetzt ist)
• LOGIN: Wenn auf false gesetzt, wird der Login deaktiviert und alle Seiten sind ohne Authentifizierung zugänglich (Standard: true)
• DOWNLOAD_DIR: Verzeichnis für Downloads (Standard: ./downloaded)
• SESSION_SECRET: Secret für Session-Cookies (Standard: default-secret-change-in-production)
• STREAM_ONLY: Wenn auf true gesetzt, werden Dateien nicht physisch gespeichert, sondern direkt als Download-Stream angeboten (Standard: false)
• LOCALE: Sprache der Anwendung - de für Deutsch oder en für Englisch (Standard: de)
• YT_DLP_COOKIES: Pfad zu einer Cookie-Datei für yt-dlp (z.B. ./cookies.txt). Wird verwendet, um YouTube Bot-Erkennung zu umgehen. Siehe yt-dlp Cookie-Dokumentation
• YT_DLP_COOKIES_FROM_BROWSER: Browser-Name, aus dem Cookies geladen werden sollen (z.B. chrome, firefox, edge, safari). Alternative zu YT_DLP_COOKIES. Siehe yt-dlp Cookie-Dokumentation
• YT_DLP_JS_RUNTIME: JavaScript Runtime für yt-dlp (Standard: deno). Andere Optionen: node, d8, etc.

Beispiel .env Datei mit Login:

LOGIN_USERNAME=admin
LOGIN_PASSWORD=mein-sicheres-passwort
LOGIN=true
DOWNLOAD_DIR=./downloaded
SESSION_SECRET=mein-geheimes-session-secret
STREAM_ONLY=false
LOCALE=de
YT_DLP_COOKIES_FROM_BROWSER=chrome

Beispiel .env Datei ohne Login:

LOGIN=false
DOWNLOAD_DIR=./downloaded
STREAM_ONLY=false
LOCALE=de
YT_DLP_COOKIES_FROM_BROWSER=chrome

Hinweis zu Cookies:

• Wenn YouTube Bot-Erkennung auftritt, müssen Cookies verwendet werden
• YT_DLP_COOKIES_FROM_BROWSER ist die einfachste Option: Gibt den Browser-Namen an (z.B. chrome, firefox, edge, safari)
• Alternativ kann YT_DLP_COOKIES mit dem Pfad zu einer Cookie-Datei verwendet werden
• Cookie-Dateien können mit Browser-Erweiterungen wie "Get cookies.txt LOCALLY" oder "cookies.txt" exportiert werden

Hinweis zu LOGIN:

• Wenn LOGIN=false: Keine Login-Seite, alle Seiten sind öffentlich zugänglich. LOGIN_USERNAME und LOGIN_PASSWORD werden ignoriert.
• Wenn LOGIN=true oder nicht gesetzt: Login ist aktiviert. LOGIN_USERNAME und LOGIN_PASSWORD müssen gesetzt sein.

Hinweis zu STREAM_ONLY:

• Wenn STREAM_ONLY=true: Dateien werden temporär gespeichert, direkt als Download-Stream angeboten und danach automatisch gelöscht. Keine Dateien bleiben auf der Festplatte.
• Wenn STREAM_ONLY=false oder nicht gesetzt: Dateien werden im DOWNLOAD_DIR Verzeichnis gespeichert und können später über die Dateiliste abgerufen werden.

Projektstruktur

/
├── src/
│   ├── components/     # Astro-Komponenten
│   ├── layouts/        # Layout-Templates
│   ├── lib/            # Utility-Funktionen
│   └── pages/          # Seiten und API-Routes
├── Dockerfile          # Docker-Konfiguration
├── docker-compose.yml  # Docker Compose Setup
└── package.json        # Dependencies

Hinweise

• Die Login-Credentials müssen in den Environment-Variablen LOGIN_USERNAME und LOGIN_PASSWORD gesetzt werden
• Für Produktionsumgebungen sollte ein starkes Passwort verwendet werden
• yt-dlp läuft innerhalb der App über das npm-Package yt-dlp-wrap
• Im Docker-Container wird yt-dlp automatisch installiert
• Für lokale Entwicklung muss yt-dlp separat installiert sein (siehe Installation)