109 lines
4 KiB
Markdown
109 lines
4 KiB
Markdown
|
||
# Video-Konvertierungsprogramm
|
||
|
||
Dies ist ein einfaches Video-Konvertierungsprogramm, das eine Weboberfläche zur Verfügung stellt, um Videos in verschiedene Formate zu konvertieren. Das Backend läuft auf Python und verwendet WebSockets, um mit der Benutzeroberfläche zu kommunizieren und den Status von Konvertierungen zu verfolgen.
|
||
|
||
## Features
|
||
|
||
- **Weboberfläche** zur Anzeige aktueller Konvertierungen, Warteschlangen und Status.
|
||
- **Echtzeit-Kommunikation** via WebSocket zwischen Frontend und Backend.
|
||
- **Automatische Konvertierung** bei Dateipfadänderungen (optional, basierend auf den Einstellungen).
|
||
- **Statistiken** zu konvertierten Videos.
|
||
- Unterstützung für verschiedene Videoformate und Codecs.
|
||
|
||
## Anforderungen
|
||
|
||
- Python 3.8+
|
||
- Abhängigkeiten:
|
||
- `aiohttp` – Für den HTTP-Server
|
||
- `websockets` – Für die WebSocket-Kommunikation
|
||
- Weitere Abhängigkeiten wie z. B. `ffmpeg` für die Video-Konvertierung
|
||
|
||
### Installationsanweisungen
|
||
|
||
1. **Klonen des Repositories:**
|
||
|
||
```bash
|
||
git clone https://github.com/dein-benutzername/video-konverter.git
|
||
cd video-konverter
|
||
```
|
||
|
||
2. **Installiere die Abhängigkeiten:**
|
||
|
||
Wenn du noch keine virtuelle Umgebung eingerichtet hast, erstelle eine:
|
||
|
||
```bash
|
||
python3 -m venv venv
|
||
source venv/bin/activate # Auf Windows: venv\Scriptsctivate
|
||
```
|
||
|
||
Dann installiere alle benötigten Abhängigkeiten:
|
||
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
3. **Installiere ffmpeg:**
|
||
|
||
Für die Video-Konvertierung benötigst du `ffmpeg`. Installiere es je nach deinem Betriebssystem:
|
||
|
||
- **Ubuntu/Debian:**
|
||
```bash
|
||
sudo apt-get install ffmpeg
|
||
```
|
||
- **macOS (via Homebrew):**
|
||
```bash
|
||
brew install ffmpeg
|
||
```
|
||
- **Windows:**
|
||
Lade `ffmpeg` von [ffmpeg.org](https://ffmpeg.org/download.html) herunter und stelle sicher, dass es im Systempfad verfügbar ist.
|
||
|
||
## Nutzung
|
||
|
||
1. **Starte den Server:**
|
||
|
||
Der WebSocket-Server und der HTTP-Server laufen auf demselben Event-Loop. Um beide zu starten, führe einfach das Python-Skript aus:
|
||
|
||
```bash
|
||
python server.py
|
||
```
|
||
|
||
Der HTTP-Server ist auf `http://localhost:8080` erreichbar, und die WebSocket-Verbindung läuft unter `ws://localhost:8000`.
|
||
|
||
2. **Weboberfläche aufrufen:**
|
||
|
||
Öffne deinen Webbrowser und gehe zu `http://localhost:8080`, um die Benutzeroberfläche des Video-Konverters zu sehen. Du kannst Videos hochladen und deren Konvertierungsstatus in Echtzeit verfolgen.
|
||
|
||
## Funktionen der Weboberfläche
|
||
|
||
- **Aktuelle Konvertierungen**: Zeigt alle laufenden und abgeschlossenen Konvertierungen an.
|
||
- **Warteschlange**: Zeigt an, welche Videos noch konvertiert werden müssen.
|
||
- **Start/Pause/Stop**: Ermöglicht es, die Konvertierung zu steuern (je nach Implementierung).
|
||
- **Statistiken**: Zeigt Informationen zu den konvertierten Videos (z. B. Dateigröße, Format, etc.).
|
||
|
||
## Backend
|
||
|
||
Das Backend ist für die Verwaltung der Video-Konvertierungen zuständig und kommuniziert über WebSockets mit der Frontend-Weboberfläche.
|
||
|
||
### WebSocket-Server
|
||
|
||
Der WebSocket-Server wartet auf Verbindungen und sendet Updates zu den Konvertierungen an die Clients. Die Kommunikation erfolgt mit JSON-Nachrichten. Der Server unterstützt folgende Nachrichtenarten:
|
||
|
||
- **Datenpfad** (`data_path`): Gibt den Pfad der zu konvertierenden Datei an.
|
||
- **Befehle** (`data_command`): Für zukünftige Erweiterungen von Steuerbefehlen.
|
||
|
||
## Konfiguration
|
||
|
||
Die Konfiguration des Programms erfolgt über eine YAML-Datei (z. B. `config.yaml`), die Parameter wie den Serverport, den Pfad zu den Konvertierungswerkzeugen (z. B. `ffmpeg`) und automatische Startoptionen für die Konvertierungen enthält.
|
||
|
||
## Troubleshooting
|
||
|
||
- **Problem:** Der WebSocket-Server startet nicht.
|
||
- **Lösung:** Überprüfe, ob der Port (Standard: `8000`) bereits von einer anderen Anwendung verwendet wird.
|
||
|
||
- **Problem:** Videos werden nicht konvertiert.
|
||
- **Lösung:** Stelle sicher, dass `ffmpeg` korrekt installiert und im Systempfad verfügbar ist.
|
||
|
||
## Lizenz
|
||
|
||
Dieses Projekt ist unter der MIT-Lizenz lizenziert – siehe [LICENSE](LICENSE) für Details.
|