disk2iso ist ein modulares Bash-basiertes Tool zur automatischen Archivierung optischer Medien (CDs, DVDs, Blu-rays) als ISO-Images. Es kombiniert intelligente Medien-Erkennung mit optimierten Kopiermethoden für jeden Disc-Typ.

Hauptmerkmale

🎯 Automatische Medien-Erkennung

6 Disc-Typen: audio-cd, dvd-video, bd-video, cd-rom, dvd-rom, bd-rom
Intelligente Analyse: UDF, ISO9660, Audio-CD Format-Erkennung
Label-Extraktion: Automatische Disc-Namen via isoinfo oder blkid

🎵 Audio-CD Support (Modul: lib-cd.sh)

Lossless Ripping: cdparanoia mit Fehlerkorrektur
MP3-Encoding: LAME VBR V2 (~190 kbps, fest kodiert)
Intelligente Metadaten-Erfassung:
- Primär: MusicBrainz-API (Disc-ID → Album/Artist/Tracks/Cover)
- Interaktive Auswahl: Bei mehreren Album-Treffern automatisches Web-Interface Modal (v1.2.0+)
- Fallback: CD-TEXT (icedax/cd-info/cdda2wav)
- Automatisch: Cover-Download via Cover Art Archive
ID3-Tags: Vollständige Metadaten-Einbettung in MP3s
Jellyfin-Support: NFO-Dateien für Media-Server
Nachträgliche Metadaten-Erfassung (Modul: lib-cd-metadata.sh, v1.2.0+):
- ISO-Remastering: Bereits erstellte Audio-ISOs mit neuen Tags versehen
- Web-Interface: "Add Metadata" Button im Archiv
- MusicBrainz-Suche: Manuelle Album-Auswahl über Web-UI
- Automatisches Remastering: MP3s extrahieren → Tags aktualisieren → Neue ISO erstellen

📀 Video-DVD Support (Modul: lib-dvd.sh)

Entschlüsselung: dvdbackup mit libdvdcss2
Intelligenter Retry: Automatischer Fallback bei Fehlern (dvdbackup → ddrescue)
Fehler-Tracking: Persistente .failed_dvds Liste (max. 2 Versuche)
Automatisches Reject: DVDs nach 2 Fehlversuchen
Priorität: Entschlüsselt vor verschlüsselt
Struktur: VIDEO_TS → ISO-Konvertierung
TMDB-Metadaten (Modul: lib-dvd-metadata.sh, v1.2.0+):
- Automatische Film-Suche: Titel-Extraktion aus disc_label
- TV-Serien Support: Automatische Erkennung von TV-Shows mit Staffel/Disc-Nummer
- Interaktive Auswahl: Web-Interface Modal bei mehreren Treffern
- Metadaten: .nfo Datei (Titel, Jahr, Regisseur, Genre, Laufzeit, Rating)
- Poster-Download: -thumb.jpg (w500 von TMDB)
- Nachträgliche Erfassung: "Add Metadata" Button im Web-Interface Archiv

🎬 Blu-ray Support (Modul: lib-bluray.sh)

Robustes Kopieren: ddrescue (primär), dd (fallback)
UDF-Support: Moderne Blu-ray-Dateisysteme
Große Medien: Bis 100GB+ unterstützt
Verschlüsselt: ISO-Kopie (Entschlüsselung extern möglich)

💾 Daten-Discs (Kern-Modul)

Universell: CD-ROM, DVD-ROM, BD-ROM
Methoden: dd (schnell), ddrescue (bei Fehlern)
1:1 Kopie: Bit-genaue ISO-Images

🔐 Integrität & Qualität

MD5-Checksummen: Automatisch für jede ISO
Fehlerbehandlung: Robuste Recovery-Mechanismen
Fortschrittsanzeige: Echtzeit-Feedback (MB/s, ETA)
Logging: Detaillierte Log-Dateien pro Disc

🌍 Mehrsprachigkeit

Modulares Sprachsystem: Jedes Modul hat eigene Sprachdateien
Verfügbare Sprachen: Deutsch (de), English (en), Español (es), Français (fr)
Vollständig synchronisiert: 202 Konstanten pro Sprache
Erweiterbar: Einfaches Hinzufügen weiterer Sprachen

📡 MQTT-Integration (Modul: lib-mqtt.sh)

Home Assistant Support: Native Integration über MQTT
Echtzeit-Status: Live-Updates im Dashboard
Push-Benachrichtigungen: Bei Medium-Wechsel, Abschluss, Fehler
Fortschrittsanzeige: Prozent, MB, ETA
Availability-Tracking: Online/Offline Status
Konfigurierbar: Broker, Auth, Topics

🔄 State Machine Architektur

11 definierte Zustände: Präzise Ablaufsteuerung
Zustandsübergänge: initializing → waiting_for_drive → drive_detected → waiting_for_media → media_detected → analyzing → copying → completed → waiting_for_removal → idle
Fehlerbehandlung: Automatischer Übergang zu error-State bei Problemen
Polling-Intervalle: Optimiert (Laufwerk: 20s, Medium: 2s, Entnahme: 5s)
API-Integration: JSON-API liefert aktuellen State in Echtzeit

🌐 Web-Interface & REST API

Flask-basiertes Dashboard: Modernes Web-UI auf Port 8080
Mehrsprachig: Web-UI nutzt gleiche LANGUAGE-Einstellung wie Backend (de, en, es, fr)
6 Hauptseiten: Home, Archive, Logs, Config, System, Help
Live-Updates: Auto-Refresh alle 5 Sekunden
JSON REST API (lib-api.sh + app.py):
- /api/status - Aktueller State und Fortschritt
- /api/archive - Liste aller ISOs
- /api/logs - Log-Dateien
- /api/config - Konfiguration
- /api/system - System-Informationen
- /api/metadata/musicbrainz/search - MusicBrainz Album-Suche (v1.2.0+)
- /api/metadata/musicbrainz/apply - Audio-ISO Remastering (v1.2.0+)
- /api/metadata/tmdb/search - TMDB Film/TV-Suche (v1.2.0+)
- /api/metadata/tmdb/apply - DVD/Blu-ray Metadaten hinzufügen (v1.2.0+)
Markdown-Rendering: Integrierte Hilfe-Dokumentation

Systemarchitektur

┌─────────────────────────────────────────────────────────┐
│              disk2iso.sh (Hauptskript)                  │
│  • State Machine (11 Zustände)                          │
│  • Laufwerks-Überwachung                                │
│  • Disc-Erkennung                                       │
│  • Modul-Loading (konditional)                          │
└──────────────┬──────────────────────────────────────────┘
               │
               ├── Kern-Module (immer geladen)
               │   ├── lib-common.sh      (Daten-Discs, Basis-Kopiermethoden)
               │   ├── lib-diskinfos.sh   (Disc-Typ-Erkennung)
               │   ├── lib-drivestat.sh   (Laufwerk-Status)
               │   ├── lib-files.sh       (Dateinamen-Verwaltung)
               │   ├── lib-folders.sh     (Ordner-Verwaltung)
               │   ├── lib-logging.sh     (Logging + Sprachsystem)
               │   ├── lib-api.sh         (JSON REST API)
               │   └── lib-systeminfo.sh  (System-Informationen)
               │
               └── Optionale Module (bei Installation wählbar)
                   ├── lib-cd.sh         (Audio-CD Ripping)
                   ├── lib-dvd.sh        (Video-DVD Backup)
                   ├── lib-bluray.sh     (Blu-ray Backup)
                   └── lib-mqtt.sh       (MQTT/Home Assistant Integration)

Ausgabe-Struktur

OUTPUT_DIR/
├── audio/                  # Audio-CDs (nur mit lib-cd.sh)
│   └── Artist/
│       └── Album/
│           ├── 01 - Track.mp3
│           ├── 02 - Track.mp3
│           ├── folder.jpg
│           └── album.nfo
│
├── data/                   # Daten-CDs/DVDs/Blu-rays
│   ├── disc_label.iso
│   └── disc_label.md5
│
├── dvd/                    # Video-DVDs (nur mit lib-dvd.sh)
│   ├── movie_title.iso
│   └── movie_title.md5
│
├── bd/                     # Blu-ray Videos (nur mit lib-bluray.sh)
│   ├── movie_title.iso
│   └── movie_title.md5
│
├── .log/                   # Zentrale Log-Dateien (versteckt)
│   ├── disc_label.log
│   └── audio.log
│
└── .temp/                  # Temporär (auto-cleanup, versteckt)
    ├── mountpoints/        # Mount-Points für Label-Erkennung
    └── disc_label_$$/      # Arbeitsverzeichnisse

Graceful Degradation

disk2iso funktioniert auch mit minimaler Installation:

Modul fehlt	Disc-Typ	Fallback
lib-cd.sh	audio-cd	→ data/ (dd/ddrescue)
lib-dvd.sh	dvd-video	→ data/ (dd/ddrescue)
lib-bluray.sh	bd-video	→ data/ (dd/ddrescue)
lib-mqtt.sh	-	Kein MQTT (nur lokales Logging)

Resultat: Immer ein ISO-Image, auch wenn spezialisierte Module fehlen.

Performance-Optimierungen

Lazy Initialization: Verzeichnisse nur bei Bedarf erstellen
Intelligente Methoden-Wahl: Beste Tool basierend auf Disc-Typ
Sequenzielle Verarbeitung: Audio-Track-Encoding Track für Track (platzsparend)
Fortschritts-Monitoring: Effizientes stat-basiertes Tracking

Tatsächliche Verarbeitungszeiten (gemessen):

Audio-CD (12 Tracks): ~15 Min (MusicBrainz + MP3 + ISO)
Video-DVD (7.5 GB): ~33 Min (dvdbackup entschlüsselt)
Blu-ray (46.6 GB): ~42 Min (ddrescue, verschlüsselt)

Sicherheits-Features

Root-Rechte erforderlich: Zugriff auf optische Laufwerke
Sichere Mount-Points: In OUTPUT_DIR statt /tmp
Signal-Handling: Sauberes Cleanup bei SIGTERM/SIGINT
Temp-Verzeichnis Cleanup: Automatisch nach jedem Vorgang
MD5-Checksummen: Integritätsprüfung aller ISOs

Unterstützte Plattformen

Primär: Debian 12 (Bookworm) / Debian 13 (Trixie)
Getestet auf: Ubuntu 22.04+, Linux Mint 21+
Voraussetzung: Bash 4.0+, systemd (für Service-Modus)

Lizenz & Credits

Lizenz: MIT License
Sprache: Bash
Abhängigkeiten: Open Source Tools (cdparanoia, lame, dvdbackup, ddrescue)
API-Nutzung: MusicBrainz (Community-Projekt)

Navigation

Weiter: Kapitel 2: Installation →

Siehe auch:

Kapitel 3: Betrieb - Web-Interface, REST API, Ausgabe-Struktur
Kapitel 4: Optionale Module - Audio-CD, DVD, Blu-ray, MQTT
Kapitel 5: Fehlerhandling - Fehler-Tracking & Debug-Modi
Kapitel 6: Entwickler - Architektur & Modulentwicklung
Deinstallation - Vollständige Entfernung

Version: 1.2.0 | Letzte Aktualisierung: 11.01.2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

disk2iso - Vollständiges Handbuch

📚 Inhaltsverzeichnis

1. Übersicht

2. Installation

3. Betrieb

4. Optionale Module

5. Fehlerhandling

6. Entwickler-Dokumentation

7. Deinstallation

8. Anhang

Übersicht

Was ist disk2iso?

Hauptmerkmale

🎯 Automatische Medien-Erkennung

🎵 Audio-CD Support (Modul: lib-cd.sh)

📀 Video-DVD Support (Modul: lib-dvd.sh)

🎬 Blu-ray Support (Modul: lib-bluray.sh)

💾 Daten-Discs (Kern-Modul)

🔐 Integrität & Qualität

🌍 Mehrsprachigkeit

📡 MQTT-Integration (Modul: lib-mqtt.sh)

🔄 State Machine Architektur

🌐 Web-Interface & REST API

Systemarchitektur

Ausgabe-Struktur

Graceful Degradation

Performance-Optimierungen

Sicherheits-Features

Unterstützte Plattformen

Lizenz & Credits

Navigation

FilesExpand file tree

Handbuch.md

Latest commit

History

Handbuch.md

File metadata and controls

disk2iso - Vollständiges Handbuch

📚 Inhaltsverzeichnis

Übersicht

Was ist disk2iso?

Hauptmerkmale

🎯 Automatische Medien-Erkennung

🎵 Audio-CD Support (Modul: lib-cd.sh)

📀 Video-DVD Support (Modul: lib-dvd.sh)

🎬 Blu-ray Support (Modul: lib-bluray.sh)

💾 Daten-Discs (Kern-Modul)

🔐 Integrität & Qualität

🌍 Mehrsprachigkeit

📡 MQTT-Integration (Modul: lib-mqtt.sh)

🔄 State Machine Architektur

🌐 Web-Interface & REST API

Systemarchitektur

Ausgabe-Struktur

Graceful Degradation

Performance-Optimierungen

Sicherheits-Features

Unterstützte Plattformen

Lizenz & Credits

Navigation