Skip to content

README.md

Latest commit

 

History

History
156 lines (119 loc) · 7.82 KB

README.md

File metadata and controls

156 lines (119 loc) · 7.82 KB

🎬 vdr-rectools

vdr-rectools (ehemals vdr-reccleaner) ist eine modulare, vollautomatisierte Bash-Suite für den Video Disk Recorder (VDR). Sie dient zur Verwaltung, Reparatur, Konvertierung und nahtlosen Integration von VDR-Aufnahmen in Media-Center wie Plex oder Kodi.

✨ Features

  • 📥 Smart Import: Erkennt und verarbeitet diverse Videoformate (z.B. MKV, MP4, AVI, MOV) und Codecs (H.264, HEVC, MiniDV, Web-Formate) automatisch und wählt die optimale Import-Strategie (Remuxing oder Re-Encoding).
  • 📝 Intelligente Metadaten: Liest beim Import .nfo-Dateien (Titel, Plot) ein und schreibt sie direkt in die info-Datei des VDR für eine perfekte Darstellung.
  • 🎬 TVScraper Integration: Triggert nach dem Import optional einen Metadaten-Scrape im VDR (Modi: immediate oder batch).
  • 🛠️ Smart Repair: Repariert defekte Aufnahmen in einem zweistufigen Verfahren: Zuerst ein schneller Header-Fix, bei Bedarf gefolgt von einem kompletten Re-Encoding.
  • 💬 Auto-Subtitles: Sucht beim Import automatisch nach passenden Untertiteln und legt sie als .srt direkt zur Aufnahme.
  • 🗜️ H.265 Shrink-Modus: Komprimiert große Aufnahmen auf Knopfdruck in den platzsparenden HEVC-Codec (H.265).
  • 📺 VDR OSD-Integration: Klinkt sich automatisch in das reccmds.conf Befehlsmenü des VDR ein (inkl. Smart Downscaling).
  • ✉️ Intelligentes Reporting: Sendet Erfolgs- oder Fehlermeldungen per E-Mail.
  • 🧹 Auto-Cleanup: Findet und löscht leere Aufnahmeordner im Video-Verzeichnis.

� Der Import-Workflow im Detail

Der Import ist das Herzstück von vdr-rectools. Das Skript durchsucht das IMPORT_DIR nach gängigen Videodateien wie .mkv, .mp4, .avi, .mov oder .ts. Wenn eine Datei gefunden wird, passiert Folgendes im Hintergrund:

  1. Metadaten finden: Das Skript sucht nach einer passenden .nfo-Datei (z.B. Mein Film.nfo). Werden darin <title> und <plot> gefunden, werden diese für die VDR-Aufnahme übernommen. Andernfalls wird der Dateiname als Titel verwendet.
  2. Struktur anlegen: Es wird ein VDR-konformer Aufnahmeordner erstellt (z.B. /srv/vdr/video/Mein_Film/2026-04-22.10.00.1-0.rec/).
  3. Schonendes Remuxing: Die Quelldatei (.mkv, .mp4 etc.) wird ohne Qualitätsverlust in eine VDR-kompatible .ts-Datei umgewandelt (-c copy).
  4. Reparatur & Index: Die neue .ts-Datei wird durch smart_repair geschickt, um Timestamps zu korrigieren. Anschließend wird der VDR-Index (index) neu generiert.
  5. Metadaten schreiben: Die info-Datei wird mit Titel und Beschreibung aus Schritt 1 befüllt.
  6. Untertitel & TVScraper: Das Skript sucht nach Untertiteln und triggert (falls konfiguriert) das TVScraper-Plugin.
  7. Aufräumen: Nach dem erfolgreichen Import wird die Originaldatei aus dem Import-Verzeichnis gelöscht.

�📦 Systemvoraussetzungen

Das Skript ist für Debian/Ubuntu-basierte Systeme (wie yaVDR) optimiert. Folgende Abhängigkeiten werden bei der Installation des .deb-Pakets automatisch aufgelöst:

  • vdr
  • ffmpeg
  • bash (>= 4.0)
  • coreutils, findutils
  • subliminal (für den Untertitel-Download)
  • bsd-mailx oder mailutils (für das Reporting)

🚀 Installation

Variante A: Installation über das fertige .deb Paket (Empfohlen)

Lade dir das aktuellste Release von der GitHub Releases Seite herunter und installiere es bequem via APT.

# Ersetze * durch die aktuelle Versionsnummer
sudo apt install ./vdr-rectools_*.deb

Variante B: Manuelle Installation aus dem Quellcode

Diese Methode ist für Entwickler oder für manuelle Anpassungen gedacht.

# Repository klonen
git clone https://github.com/hotzenplotz5/vdr-rectools.git
cd vdr-rectools

# Paket bauen & installieren
debuild -us -uc
# Ersetze * durch die aktuelle Versionsnummer
sudo dpkg -i ../vdr-rectools_*.deb

⚙️ Konfiguration

Datei: /etc/vdr/conf.d/vdr-rectools.conf

Variable Beschreibung Standard
AUTO_START_NIGHT Erlaubt den nächtlichen Automatik-Scan (1=An, 0=Aus) 0
AUTO_TIMER Genereller Schalter für Timer-Aktionen 0
IMPORT_DIR Pfad für MKV-Filme zum Import /srv/video/Filme
MAIL_NOTIFY E-Mail-Adresse für Statusberichte (leer)
AUTO_SUB_DOWNLOAD Automatischer Download von Untertiteln 1
SUB_LANG Sprache für Untertitel (z.B. de, en) de
AUTO_ENCODE_IMPORT Automatisches Re-Encoding beim Import (1=An, 0=Aus) 1
CRF_H264_DEFAULT CRF-Wert für H.264 (niedriger=besser) 23
PRESET_H264_DEFAULT Preset für H.264 (z.B. medium, fast) medium
CRF_H265_DEFAULT CRF-Wert für H.265 (niedriger=besser) 23
PRESET_H265_DEFAULT Preset für H.265 (z.B. medium, fast) medium
HW_ACCEL Hardwarebeschleunigung (none, nvenc, vaapi, qsv) none
SHRINK_MAX_RES Maximale Auflösung (Höhe) für Shrink. 0=deaktiviert 0
CRF_H264_FALLBACK CRF-Wert für Fallback-Encoding 23
PRESET_H264_FALLBACK Preset für Fallback-Encoding fast
MIN_COMPRESSION_RATIO_H264 Max. Dateigröße in % des Originals für H.264-Encodes 70
MIN_COMPRESSION_RATIO_H265 Max. Dateigröße in % des Originals für H.265-Encodes 50
MIN_COMPRESSION_RATIO_H264_FALLBACK Max. Dateigröße in % des Originals für H.264-Fallback 70
MIN_FREE_GB Mindestfreispeicher auf der Festplatte 20
MAX_FILES Maximale Anzahl Dateien pro Durchlauf 10
PAUSE_WORK Pause zwischen Arbeitsschritten (Sekunden) 30
PAUSE_CHECK Pause zwischen Datei-Checks (Sekunden) 2
SNAPSHOT_TIME Zeitstempel für generierte Vorschaubilder 00:05:00

🕹 Bedienung

Terminal-Befehle

  • vdr-rectools start - Startet einen vollständigen Scan (Import & Cleanup) im Hintergrund.
  • vdr-rectools import - Startet gezielt nur den MKV-Import-Prozess.
  • vdr-rectools repair - Startet einen Reparatur-Lauf für alle Aufnahmen.
  • vdr-rectools status - Zeigt PID, Laufzeit und die letzten Log-Zeilen an.
  • vdr-rectools stop - Beendet laufende Hintergrundprozesse sauber.
  • vdr-rectools cron - Simuliert den Timer-Aufruf (prüft AUTO_START_NIGHT).
  • vdr-rectools repair_single <Pfad> - Repariert gezielt eine einzelne Aufnahme (Pfad zum .rec Ordner).

Systemd-Timer (Automatik)

Der Timer ist standardmäßig aktiv und triggert den Scan (meist nachts). Er führt die Arbeit aber nur aus, wenn AUTO_START_NIGHT=1 gesetzt ist.

sudo systemctl status vdr-rectools.timer

📈 Monitoring & Feedback

Logging

Alle Vorgänge werden detailliert protokolliert. Dies ist die erste Anlaufstelle bei Problemen:

  • Pfad: /var/log/vdr-rectools.log
  • Inhalt: Start/Stop-Zeiten, FFmpeg-Ausgaben beim Re-Muxing, Import-Ergebnisse.

E-Mail-Benachrichtigungen

Bei gesetzter MAIL_NOTIFY Adresse versendet das Skript nach jedem Lauf eine E-Mail mit:

  • Zusammenfassung der importierten Filme und reparierten Aufnahmen.
  • Warnungen bei zu wenig Festplattenplatz (MIN_FREE_GB).
  • Detaillierten Fehlermeldungen, falls ein Import oder Re-Muxing fehlgeschlagen ist.

📺 VDR OSD-Integration

Die Befehle werden automatisch in das VDR-Menü (Befehle-Taste innerhalb einer Aufnahme) eingebunden:

  • Aufnahme reparieren (Rectools): Startet Reparatur der aktuellen Aufnahme.
  • Werbung schneiden (Rectools): Schneidet Aufnahme basierend auf VDR-Marken.
  • Platz sparen H.265 (Rectools): Konvertiert die Aufnahme nach HEVC.
  • Plex/Kodi Sync (Rectools): Triggert die Synchronisation für externe Player.

📋 Voraussetzungen

Das Paket installiert Abhängigkeiten wie vdr, ffmpeg, mediainfo, subliminal und mailx automatisch mit.

📄 Lizenz & Maintainer

GPL-3.0+ | Maintainer: Holger Schvestka hotzenplotz5@gmx.de