kuomar/kuonen.pdftools repository overview

⁠Kuonen PDFTools

PDF und Dokumente lesen, erzeugen, bearbeiten und umwandeln, alles in einem Container.

Kuonen PDFTools ist eine .NET-10-Bibliothek, deren Kern ohne eine einzige Fremdabhängigkeit auskommt. Sie ist auch auf beschädigte, verschlüsselte und fremde PDFs ausgelegt. Das Abbild bringt drei Dinge mit:

• den Prüfstand, eine Weboberfläche mit Editor, Konvertern und Beispielen;
• den Noten-Editor;
• einen virtuellen Netzwerkdrucker (IPP).

Das Abbild ist multi-arch (linux/amd64, linux/arm64).

⁠Schnellstart

docker run -d --name pdftools -p 8080:8080 kuomar/kuonen.pdftools:latest

Danach http://localhost:8080⁠ öffnen.

⁠Tags

⁠Funktionsumfang

⁠PDF lesen und reparieren

• Robustes Laden beliebiger PDFs:
  • klassische, Stream- und hybride Querverweise;
  • Reparaturpfad für beschädigte Dateien;
  • RC4, AES-128 und AES-256.
• Text, Bilder, Vektorgrafik, Schriften, Kommentare, Lesezeichen und Metadaten auslesen, mit Position und Formatierung.
• Formulare (AcroForm und XFA) als Schema auslesen und befüllen.
• Zwei PDFs vergleichen.
• Preflight für fremde Dateien.

⁠PDF erzeugen und bearbeiten

• Layout-Engine mit:
  • Fließtext, Tabellen (verbundene Zellen, Kreuztabellen), Textverkettung und Gruppen;
  • Musterseiten und Absatz-/Zeichenformaten wie in InDesign;
  • Formelsatz, SVG, Barcodes (QR, Code 128, PDF417, DataMatrix …) und getaggtem PDF.
• Schweizer QR-Rechnung (Zahlteil nach SIX) samt Rechnung mit MWST und Swico-S1.
• Bearbeiten:
  • Zusammenführen, Aufteilen (nach Seiten, Lesezeichen, Grösse), Drehen und Seiten organisieren;
  • Wasserzeichen, Seitenzahlen, Bates-Nummern, Kopf-/Fusszeilen, Stempel;
  • Schwärzen (wirklich angewendet), Bereinigen, Optimieren und Verkleinern;
  • Verschlüsseln und Entschlüsseln, digitale Signatur und Zertifizierung.
• PDF/A und PDF/UA prüfen und umwandeln; PDF/X-4 und Druckvorstufe:
  • Sonderfarben und Overprint, OutputIntent;
  • Schnitt- und Passmarken, Seitenrahmen und Anschnitt.
• Echtes ICC-Farbmanagement: RGB → CMYK, Softproof, ΔE2000.

⁠OCR

• PDFs und Scans durchsuchbar machen, auch ganze Ordner.
• Eigene Erkennung mit trainierbaren Modellen, Tesseract im tools-Abbild.
• Barcodes lesen.

⁠Umwandeln, in beide Richtungen

• Office:
  • Word (.docx), Excel (.xlsx), PowerPoint (.pptx);
  • OpenDocument (.odt, .odg), RTF.
• Satz und Grafik:
  • InDesign (.idml), Visio (.vsdx, .vdx, .vsd);
  • SVG, EMF/WMF, EPS/PostScript, PCL.
• Web und Text:
  • HTML/CSS mit JavaScript, Markdown, LaTeX (TikZ, pgfplots, Beamer, BibTeX);
  • XSL-FO, EPUB, FB2, Text.
• Bilder mit eigenen Codecs:
  • JPEG, PNG, TIFF, GIF, WebP, JPEG 2000;
  • HEIF/HEIC, AVIF, JPEG XL, JBIG2, PSD, ICO/ICNS und weitere;
  • EXIF-, IPTC- und XMP-Metadaten.
• Arbeitsformat .kdoc: Jedes Dokument lässt sich verlustarm als bearbeitbares Arbeitsdokument öffnen und in jedes Zielformat zurückschreiben.

⁠Editor im Browser

• Rahmen, Ebenen, Hilfslinien, Liquid Layout, Gruppen mit Grössenverhalten.
• Fließtext-Modus mit Schreibstrich, Fussnoten, Inhaltsverzeichnis und Formeln.
• Rückgängig/Wiederholen und Export in alle unterstützten Formate.

⁠Notensatz

• MusicXML und MIDI lesen und schreiben; Partitur als PDF, PNG oder TIFF.
• Stimmenauszüge und transponierende Instrumente.
• Mehrstimmiger Satz, Gesangstext, Dynamik, Artikulation und Tabulatur.
• Noten-Editor mit mehreren Spuren, Klaviatur und Wiedergabe.
• Notenblatt-Erkennung (OMR): vom gescannten Blatt zurück zu MusicXML.

⁠Weitere Module

• Fotoentwicklung im Stil von Lightroom:
  • Belichtung, Tonwerte, Kurven, Farbmischer und Masken;
  • XMP-Sidecars, Vorgaben, Stapel und Katalog.
• Archive ohne Fremdkomponente:
  • Lesen und Schreiben: ZIP (inkl. ZIP64/AES), TAR, GZip, BZIP2, XZ/LZMA, Zstandard, LZ4, 7z, CAB, ISO 9660/UDF, cpio/ar;
  • nur Lesen: RAR, DMG, StuffIt.
• Schriften:
  • TrueType, OpenType/CFF, Type 1 und Bitmap-Schriften lesen und schreiben;
  • Subsetting und ein Schrift-Editor.
• Braille: Export und Prüfung.

⁠Virtueller Drucker (IPP Everywhere)

• Ein Netzwerkdrucker, der jeden Druckauftrag als PDF ablegt.
• Er meldet sich per mDNS/Bonjour und WSD, Windows, macOS, Linux und CUPS finden ihn treiberlos.

⁠MCP-Server für KI-Assistenten

• Über 200 Werkzeuge nach dem Model Context Protocol.
• Damit können KI-Assistenten wie Claude alle oben genannten Funktionen direkt nutzen.

⁠Docker Compose

Prüfstand, Noten-Dienst und Druck-Spooler laufen aus einem Abbild, nur mit verschiedenen Einstiegen:

services:
  pruefstand:
    image: kuomar/kuonen.pdftools:tools
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./data:/data

  noten:
    image: kuomar/kuonen.pdftools:tools
    restart: unless-stopped
    environment:
      - KUONEN_PDFTOOLS_DIENST=musik
    ports:
      - "8081:8080"

  spooler:
    image: kuomar/kuonen.pdftools:tools
    restart: unless-stopped
    ports:
      - "631:8080"
    volumes:
      - ./data:/data

⁠Wichtige Umgebungsvariablen

⁠Lizenz

• Der Prüfstand läuft ohne Lizenz im Demo-Modus.
• Mit einem Lizenz-File werden die lizenzpflichtigen Teile freigeschaltet, auch einzeln nach Gruppen und Werkzeugen.