ffmpeg

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 22 Open GitHub ↗

REDAXO ffmpeg video tools

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# REDAXO-AddOn: FFmpeg Video Tools v4.1.0

Vollständige Video-Management-Lösung für REDAXO CMS – Konvertierung, Trimming und detaillierte Video-Analyse, alles in einem Addon!

## 🔧 Voraussetzungen

- PHP-Funktion `exec` aktiviert (für FFmpeg-Kommandos)
- FFmpeg und FFprobe installiert und im PATH verfügbar
- REDAXO 5.18.1 oder höher
- PHP 8.1 oder höher
- **Wichtig:** Das VideoPreview-Addon muss deinstalliert werden (Funktionalität ist integriert)

## 🚀 Features im Überblick

### Video-Konverter
- **Hintergrundverarbeitung** – Browser schließen während der Konvertierung möglich
- **Intelligente Medienpool-Integration** mit `web_`-Prefix
- **Metadaten-Erhaltung** (Titel, Beschreibung, Copyright)
- **Kompressionsanzeige** zeigt eingesparten Speicherplatz
- **Auto-Cleanup** für Originaldateien nach erfolgreicher Konvertierung
- **🆕 Vorgefertigte Presets** für Web, Mobile, Archive und Standard-Konvertierungen
- **🆕 Command-Vorschau** zeigt das generierte FFmpeg-Kommando in Echtzeit
- **🆕 Direkte Command-Eingabe** ohne separate Textarea

### 🆕 Video-Trimmer
- **Präzises Schneiden** direkt im Browser
- **Verlustfreies Trimming** mit FFmpeg Stream-Copy
- **Intuitive Bedienung** mit Video-Player-Integration, Scrubber und HUD-Steuerung
- **Bereichstest** für definierte Start-/Endzeit direkt im Player
- **Loop-Schalter** für einfache Vorschau-Tests
- **Keyboard-Shortcuts** für professionellen Workflow
- **Alle Video-Typen** unterstützt (Original + web-optimiert)

### 🆕 Video-Informationen 
- **Detaillierte technische Analyse** aller Video-Parameter
- **Responsive Darstellung** mit Layout-Schutz
- **Optimierungsempfehlungen** für Web-Performance
- **Audio/Video-Stream-Details** komplett verfügbar

### 🆕 Video-Thumbnails (Media Manager)
- **Automatische Thumbnail-Generierung** aus Videos
- **Media Manager Integration** für responsive Bildgrößen
- **Konfigurierbarer Zeitpunkt** für Thumbnail-Extraktion
- **Fallback-Placeholder** bei FFmpeg-Problemen

### 🆕 PHP-API für Entwickler
- **Module-Integration** mit `VideoInfo` Klasse (`FriendsOfRedaxo\FFmpeg\VideoInfo`)
- **Performance-optimierte Methoden** für häufige Abfragen
- **Template-Integration** für Video-Galerien und responsive Player
- **Optimierungs-Checks** für automatische Qualitätsbewertung

## 📋 Workflow

### Video-Konverter
1. **Medienpool → Video-Tools → Video-Konverter** öffnen
2. Gewünschtes Video in der tabellarischen Übersicht finden
3. Direkt am Eintrag auf **"Dieses Video konvertieren"** klicken
4. **Browser schließen möglich** – Konvertierung läuft weiter
5. Fortschritt direkt am Eintrag verfolgen (Donut + optionales Protokoll)
6. Später "Status prüfen" → Fertig optimiertes Video im Medienpool

### Video-Trimmer
1. **Medienpool → Video-Tools → Video-Trimmer** aufrufen
2. Video aus der Liste auswählen (alle Typen verfügbar)
3. **Video-Player nutzen** um Position zu finden
4. **Start-/Endzeit setzen**:
   - Position im Player pausieren
   - "Aktuelle Zeit setzen" klicken (oder Strg+S/E)
5. **Bereich testen** nutzen, um den markierten Abschnitt wiederholt abzuspielen
6. Optional **Loop-Schalter** aktivieren, damit die Vorschau direkt in Schleife läuft
7. "Video schneiden" → Geschnittenes Video als `web_trimmed_*` gespeichert

### Video-Informationen
1. **Medienpool → Video-Tools → Video-Informationen** öffnen
2. Video aus der Liste auswählen
3. **Komplette technische Analyse** ansehen:
   - Auflösung, Bitrate, Codec, Framerate
   - Audio-Details, Seitenverhältnis
   - Optimierungsempfehlungen mit Score
4. **Direkter Zugang** zu Trimmer und Konverter

## 🔌 PHP-API für Module & Templates

### Basis-Verwendung

```php
<?php
use FriendsOfRedaxo\FFmpeg;

// Video-Informationen in Modulen abrufen
$videoFile = 'REX_MEDIA[1]';
$info = VideoInfo::getBasicInfo($videoFile);

if ($info) {
    echo '<div class="video-info">';
    echo '<h3>' . $info['filename'] . '</h3>';
    echo '<p>Dauer: ' . $info['duration_formatted'] . '</p>';
    echo '<p>Auflösung: ' . $info['width'] . ' × ' . $info['height'] . ' px</p>';
    echo '<p>Seitenverhältnis: ' . $info['aspect_ratio'] . '</p>';
    echo '<p>Dateigröße: ' . $info['filesize_formatted'] . '</p>';
    echo '</div>';
}
?>
```

### Schnelle Einzelwerte

```php
<?php
use FriendsOfRedaxo\FFmpeg;

$videoFile = 'REX_MEDIA[1]';

// Nur Dauer ermitteln (performance-optimiert)
$duration = VideoInfo::getDuration($videoFile);
echo 'Dauer: ' . $duration . ' Sekunden';

// Nur Seitenverhältnis
$ratio = VideoInfo::getAspectRatio($videoFile);
echo 'Format: ' . $ratio;
?>
```

### Web-Optimierung prüfen

```php
<?php
use FriendsOfRedaxo\FFmpeg;

$videoFile = 'REX_MEDIA[1]';
$status = VideoInfo::getOptimizationStatus($videoFile);

if ($status['optimized']) {
    echo '<span class="badge badge-success">Web-optimiert</span>';
} else {
    echo '<span class="badge badge-warning">Nicht optimiert</span>';
    foreach ($status['recommendations'] as $rec) {
        echo '<li>' . $rec . '</li>';
    }
}

echo '<p>Score: ' . $status['score'] . '/100</p>';
?>
```

### Responsive Video-Templates

```php
<?php
use FriendsOfRedaxo\FFmpeg;

$videoFile = 'REX_MEDIA[1]';
$info = VideoInfo::getBasicInfo($videoFile);

if ($info) {
    // CSS-Klasse basierend auf Seitenverhältnis
    $aspectClass = match($info['aspect_ratio']) {
        '16:9' => 'video-widescreen',
        '9:16' => 'video-portrait', 
        '1:1' => 'video-square',
        default => 'video-standard'
    };
    
    echo '<div class="video-container ' . $aspectClass . '">';
    echo '<video controls>';
    echo '<source src="' . rex_url::media($videoFile) . '" type="video/mp4">';
    echo '</video>';
    echo '</div>';
}
?>
```

### Video-Thumbnails generieren

```php
<?php
$videoFile = 'REX_MEDIA[1]';

// WebP-Vorschau (animiert) - benötigt Media Manager Typ mit 'rex_effect_video_to_webp'
$webpPreview = rex_media_manager::getUrl('video_webp', $videoFile);
echo '<img src="' . $webpPreview . '" alt="Video WebP Preview">';

// MP4-Vorschau (ohne Ton) - benötigt Media Manager Typ mit 'rex_effect_video_to_preview'
$mp4Preview = rex_media_manager::getUrl('video_preview', $videoFile);
echo '<video autoplay muted loop><source src="' . $mp4Preview . '" type="video/mp4"></video>';

// Kombination: WebP als Fallback für MP4
echo '<video autoplay muted loop poster="' . $webpPreview . '">';
echo '<source src="' . $mp4Preview . '" type="video/mp4">';
echo '<img src="' . $webpPreview . '" alt="Video Preview">';
echo '</video>';
?>
```

### Video-Galerie mit Thumbnails

```php
<?php
use FriendsOfRedaxo\FFmpeg;

// Video-Liste aus dem Medienpool
$sql = rex_sql::factory();
$videos = $sql->getArray('SELECT filename FROM rex_media WHERE filetype LIKE "video/%"');

echo '<div class="video-gallery">';
foreach ($videos as $video) {
    $filename = $video['filename'];
    $info = VideoInfo::getBasicInfo($filename);
    
    // WebP-Thumbnail für bessere Performance
    $thumbnail = rex_media_manager::getUrl('video_webp_thumb', $filename);
    
    if ($info && $thumbnail) {
        echo '<div class="video-item">';
        echo '<a href="' . rex_url::media($filename) . '" data-lightbox="videos">';
        echo '<img src="' . $thumbnail . '" alt="' . $info['filename'] . '">';
        echo '<div class="video-overlay">';
        echo '<span class="play-button">▶</span>';
        echo '<span class="duration">' . $info['duration_formatted'] . '</span>';
        echo '</div>';
        echo '</a>';
        echo '</div>';
    }
}
echo '</div>';
?>
```

### Verfügbare API-Methoden

- `getInfo($filename)` – Vollständige Video-Informationen
- `getBasicInfo($filename)` – Grundlegende Infos für Templates
- `getDuration($filename)` – Nur Video-Dauer (schnell)
- `getAspectRatio($filename)` – Nur Seitenverhältnis
- `getOptimizationStatus($filename)` – Web-Optimierung mit Score
- `isMobileOptimized($filename)` – Mobile-Kompatibilität prüfen

## ✨ Neueste Verbesserungen
- Moderne Vorschau-Modal mit Loop-Option für schnelle Prüfungen
- Trimmer-UI mit direkt eingebetteten Controls, Scrubber und Bereichstest
- Theme-optimierte Darstellung für Light-, Dark- und Auto-Theme
- Zuverlässige Initialisierung im REDAXO-Backend auch nach Navigation ohne kompletten Reload

## ⚙️ Installation & Konfiguration

### FFmpeg Installation

**Ubuntu/Debian:**
```bash
sudo apt update
sudo apt install ffmpeg
```

**CentOS/RHEL:**
```bash
sudo yum install epel-release
sudo yum install ffmpeg
```

**macOS (Homebrew):**
```bash
brew install ffmpeg
```

**Test der Installation:**
```bash
ffmpeg -version
ffprobe -version
```

### REDAXO-Konfiguration

1. **Addon installieren** über den Installer oder manuell
2. **Einstellungen konfigurieren** unter Video-Tools → Einstellungen:
   - FFmpeg-Kommando anpassen (falls nötig)
   - Auto-Cleanup aktivieren/deaktivieren

### Standard-Kommando
```bash
ffmpeg -y -i INPUT -vcodec h264 OUTPUT.mp4
```

## 🎛️ Keyboard-Shortcuts (Video-Trimmer)

- **Strg + S** – Aktuelle Position als Startzeit setzen
- **Strg + E** – Aktuelle Position als Endzeit setzen  
- **Leertaste** – Video pausieren/fortsetzen

## 🔧 Technische Details

### Unterstützte Video-Formate
- MP4, AVI, MOV, WMV, WebM, MKV
- Alle von FFmpeg unterstützten Formate

### Naming-Konventionen
- **Konvertierte Videos:** `web_originalname.mp4`
- **Getrimmte Videos:** `web_trimmed_originalname.mp4`
- **Duplikate:** Automatischer Counter-Suffix

### Performance-Optimierungen
- **Stream-Copy** für verlustfreies Trimming
- **Lazy Loading** der Video-Informationen
- **Caching** von FFprobe-Ergebnissen
- **Background Processing** für Konvertierungen

## 🐛 Troubleshooting

### "FFmpeg ist nicht verfügbar"
- FFmpeg Installation prüfen: `which ffmpeg`
- PATH-Variable korrekt gesetzt?
- PHP `exec()` Funktion verfügbar?

### "Konflikt mit VideoPreview-Addon"
- Das VideoPreview-Addon muss deinstalliert werden
- Alle Thumbnail-Funktionen sind jetzt im FFmpeg-Addon integriert
- Media Manager Effekt "Video-Vorschau" bleibt unverändert funktional

### Konvertierung startet nicht
- PHP-Zeitlimits erhöhen
- Disk-Space prüfen
- Dateiberechtigungen kontrollieren

### Videos werden nicht angezeigt
- MIME-Types in der Datenbank prüfen
- Browser-Unterstützung für Video-Format

## 📝 Changelog v4.0

### Neue Features
- ✅ **Video-Konverter Presets** – Vorgefertigte Konvertierungsvorlagen (Web, Mobile, Archive, Standard)
- ✅ **Command-Vorschau** – Echtzeit-Anzeige des generierten FFmpeg-Kommandos
- ✅ **Verbesserte UI** – Direkte Command-Eingabe ohne separate Textarea
- ✅ **Type Hints & Statische Analyse** – Vollständige PHPStan/PSalm-Kompatibilität
- ✅ **Bugfixes** – Preset-Override, Video-Mapping, Transparenzen behoben

### Verbesserungen
- ✅ Code-Qualität mit REDAXO Core Methods (`rex_file`, `rex_media_service`, `rex_logger`)
- ✅ Performance-Optimierungen in VideoInfo-Klasse
- ✅ Erweiterte Fehlerbehandlung und Logging
- ✅ Debug-Endpunkt für Konvertierungsprozesse

## 📄 Lizenz

Dieses Addon steht unter der MIT-Lizenz. Beiträge sind willkommen!

---

**Entwickelt für REDAXO CMS** – Weil gute Videos eine gute Plattform verdienen! 🎬

## 👥 Credits

- **Lead Development:** Thomas Skerbis ([@skerbis](https://github.com/skerbis))
- **Original Version:** Joachim Dörr ([@joachimdoerr](https://github.com/joachimdoerr))
- **Community:** Friends Of REDAXO

**Friends Of REDAXO** - https://github.com/FriendsOfREDAXO

ffmpeg

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README