Bibox2Downloader

CLI-Tool, das Bücher aus Bibox2 über deren API herunterlädt, alle Seiten als Bilder speichert und daraus ein PDF baut.

Voraussetzungen

• .NET 10.0 SDK
• Internetzugang und gültiger Bibox2-Token (Bearer-Token) für das gewünschte Buch.
• Optional: ffmpeg im PATH, um (für PdfSharp) defekte Bilddateien automatisch neu zu codieren (PdfGenerator ruft es bei Bedarf auf).

Projektstruktur

• Bibox2Downloader/ – Quellcode und Bibox2Downloader.csproj (Console-App).
• Laufzeit-Output: pages-<buch-id>/ (JPG-Seiten oder auch einfach PNG-Seiten mit .jpg Extension) und <Buchtitel>.pdf im aktuellen Arbeitsverzeichnis.

Schnellstart

# Abhängigkeiten laden
dotnet restore Bibox2Downloader/Bibox2Downloader.csproj

# Build
dotnet build Bibox2Downloader/Bibox2Downloader.csproj

# Ausführen (Beispiel)
dotnet run --project Bibox2Downloader/Bibox2Downloader.csproj -- \
  -t "<DEIN_TOKEN>" \
  -b "<BUCH_ID>"

Hinweise:

• Das -- trennt .NET- und Programmargumente.
• Seiten werden in pages-<buch-id>/ nummeriert gespeichert. Vorhandene Seiten mit passender MD5 werden übersprungen.
• Die finale PDF heisst nach dem Buchtitel (ungültige Zeichen werden ersetzt).

ffmpeg-Hinweis

Wenn eine Seite nicht als Bild geladen werden kann, versucht das Programm automatisch, sie mit ffmpeg neu zu speichern (ffmpeg -i page_X.jpg ...). Installiere ffmpeg über dein Paketmanagement (z. B. apt install ffmpeg, brew install ffmpeg, choco install ffmpeg) und stelle sicher, dass es im PATH liegt.

Fehlerbehebung

• 401/403: Token prüfen (gültiger Bearer-Token der Session erforderlich).
• Download bricht ab: Netzwerkverbindung oder Buch-ID kontrollieren.
• PDF fehlt oder leer: Prüfe, ob Bilder in pages/ vorhanden sind und ob ffmpeg installiert ist, falls Bilder beschädigt sind.

Lizenz

Siehe LICENSE im Repository.