AnnexPDF – Handbuch

1. Überblick

AnnexPDF ist der native macOS-PDF-Arbeitsplatz der AnnexCREATE-Suite: Lesen, Annotieren, Editieren, Formulare, Sicherheit und Konvertieren auf Adobe-Acrobat-Pro-Niveau — aber schneller, offline-first, perpetual (Einmalkauf) und DACH-konform.

Kernnutzen:

• Universelles, originalgetreues Rendern über pdfium (Chrome-Grade), mit Reparaturschicht für beschädigte Dateien aus dem eigenen Rust-Core
• Vollständige Annotationen (Markup, Zeichnen, Notizen, Stempel, Messen) als Standard-PDF-Annotationen — Acrobat- und Preview-kompatibel
• Verlustfreie Seiten-Operationen (Merge, Split, Drehen, Zuschneiden, Löschen, Umordnen) über den Rust-Core
• Formulare (AcroForm): auslesen, ausfüllen, erstellen, abflachen, FDF/XFDF/CSV-Import und -Export
• Sicherheit: Passwort/Verschlüsselung (AES-128/256), digitale Signaturen (setzen, prüfen, verwalten), echte Redaction
• Standards: PDF/A-1b-Validierung und -Konvertierung, PDF/X- und PDF/UA-Grundprüfung, OCR-Texterkennung on-device, Scan-Bereinigung, PDF aus Bildern, Bild-/Text-Export
• Suite-Integration: Automatisierung über die MCP-Schnittstelle (pdf.*-Tools), Beispieldokument, „In AnnexPDF öffnen"

AnnexPDF ist Teil der AnnexCREATE-Suite („Creative OS"): Die Apps teilen ein Design-System, gemeinsame Module und die Automatisierungsschnittstelle MCP, lassen sich aber modular einsetzen. PDF ist das native Format — es gibt kein proprietäres Lock-in.

2. Installation & Aktivierung

AnnexPDF wird über AnnexHub installiert und aktualisiert — die Zentrale der Suite für Apps, Lizenzen, Updates und Assets. Die Lizenzverwaltung läuft zentral über AnnexHub; AnnexPDF selbst ist offline-first: Alle Kernfunktionen arbeiten ohne Serververbindung.

3. Grundworkflow

1. PDF öffnen: Datei ▸ Öffnen… (⌘O) oder Drag & Drop ins Fenster. Zuletzt geöffnete Dokumente erscheinen im Öffnen-Menü. Beschädigte Dateien versucht AnnexPDF automatisch zu reparieren.
2. Navigieren: Links im Navigator zwischen Miniaturen (skalierbar, Drag&Drop-Umordnung, Mehrfachselektion), Gliederung und Kommentarliste wechseln. Sidebar und Inspector lassen sich ein-/ausblenden (⌘⌥L / ⌘⌥I).
3. Lesen: Zoom, Einzel-/Fortlauf-/Doppelseiten-/Buch-Ansicht im Viewer; Volltextsuche über die FindBar (⌘F) mit Treffer-Navigation und -Hervorhebung.
4. Speichern: Datei ▸ Sichern (⌘S) schreibt Änderungen in das Dokument; Datei ▸ Sichern unter… legt eine Kopie an. Annotationen werden als Standard-PDF-Objekte gespeichert.

4. Werkzeug-Register im Detail

Oben im Fenster wählst du den Arbeitsmodus:

• Lesen: Auswahl, Hand-Werkzeug, Text-Werkzeug, Suche.
• Anmerken: Markierung (Hervorheben, Unterstreichen, Durchstreichen, Wellenlinie, Ersetzung), Zeichnen (Freihand, Linie, Pfeil, Rechteck, Ellipse, Polygon, Cloud), Notiz, Text, Stempel, Messen. Farbe, Deckkraft und Linienstärke pro Anmerkung; Kommentarliste mit Review-Status (Akzeptiert/Abgelehnt/Abgeschlossen/Abgebrochen); XFDF-Import/-Export.
• Seiten: Merge, Split, Drehen, Zuschneiden (Cut-Tool mit Seitenverhältnis-Vorgaben), Löschen, Umordnen — verlustfrei über den Rust-Core, mit Vorschau vor dem Anwenden.
• Bearbeiten: Text hinzufügen, URI-Links, Bilder ersetzen/entfernen, Optimieren, Linearisieren (Fast Web View).
• Formular: AcroForm-Felder anzeigen, ausfüllen (mit Zurückschreiben ins PDF), erstellen (Text, Checkbox, Radio, Combo-/List-Box), abflachen sowie Import/Export über FDF, XFDF und CSV.
• Schützen: Dokument signieren (PKCS#12, sichtbares Widget), Signaturen prüfen, Verschlüsseln (AES-128/256 mit Berechtigungen), Entschlüsseln, Redaction anwenden.
• Exportieren: OCR (Texterkennung on-device via Vision, unsichtbarer Textlayer), PDF aus Bildern, Seite als Bild (PNG/JPEG/TIFF), Text exportieren, Seiten automatisch drehen, Scans geradestellen (Deskew).

5. Formular-Editor

Wähle im oberen Werkzeug-Register Formular, um bestehende AcroForm-Felder einer PDF zu bearbeiten. Der Editor zeigt alle Felder direkt auf der Seite an und erlaubt Layout-Änderungen ohne Neuerstellung.

Felder verschieben und skalieren

• Klicke ein Feld an, um es auszuwählen. Zieh es an die gewünschte Position.
• Ziehe die Anfasser an Ecken und Kanten, um die Größe zu ändern. Die Seitenverhältnisse werden dabei beibehalten, wo das Feldformat es sinnvoll erlaubt.
• Halte beim Klicken die Umschalttaste gedrückt, um mehrere Felder auszuwählen. Du kannst die Auswahl gemeinsam verschieben oder über die Anfasser proportional skalieren.

Felder ausrichten

Wenn mehrere Felder ausgewählt sind, bietet die Werkzeugleiste Ausrichtungsbefehle an:

• Links / Rechts / Oben / Unten ausrichten
• Horizontal zentrieren oder Vertikal zentrieren

Die Ausrichtung bezieht sich auf das zuletzt aktive Feld oder das gemeinsame Begrenzungsrechteck der Auswahl.

Automatische Berechnungen

Im Formular-Logik-View (rechter Bereich des Registers) kannst du Felder als berechnet kennzeichnen. Für Summenfelder wie Preis_Gesamt werden die Quellfelder hinterlegt und das Ergebnis beim Ausfüllen automatisch aktualisiert. Öffne das Feld im Logik-View, um die Berechnungsformel zu prüfen oder anzupassen.

Tab-Reihenfolge

Die Reihenfolge, in der ein Benutzer die Felder mit der Tabulatortaste durchläuft, ist im Formular-Logik-View als sortierbare Liste dargestellt. Ziehe Einträge per Drag & Drop an die gewünschte Position. Die geänderte Reihenfolge wird beim Sichern in das PDF übernommen.

Hinweis: Zum Erstellen neuer AcroForm-Felder (Text, Checkbox, Radio, Listen) sowie zum Abflachen, Import/Export über FDF/XFDF/CSV verwendest du weiterhin das Werkzeug-Register Formular. Der Formular-Editor ergänzt diese Funktionen um die Bearbeitung bestehender Felder.

6. Inspector: Dokument-, Prepress- und Standards-Infos

Der rechte Inspector zeigt kontextsensitiv:

• Dokument: PDF-Version, Seitenzahl, aktuelle Seite, Seitengröße, Drehung, Farbraum, Überdruck, MediaBox.
• PDF/A: Validierungsstatus (konform / nicht konform / keine Kennung), deklarierte Variante, Anzahl der Verstöße, nicht eingebettete Schriften — inklusive „Nach PDF/A-1b konvertieren"-Button (schreibt XMP-Kennung und sRGB-OutputIntent, mit Re-Validierung).
• PDF/X: Grundprüfung (GTS_PDFX-Kennung, OutputIntent, /Trapped, TrimBox/ArtBox, DeviceRGB-Verbot für PDF/X-1a).
• PDF/UA: Grundprüfung (Kennung, Markierungen, Strukturbaum, Sprache).
• Signaturen: Übersicht aller Signaturfelder mit Verifikationsstatus (gültig, ungültig, abgelaufen, nicht vertrauenswürdig).

7. OCR- und Scan-Bereinigung

Das Werkzeug-Register Exportieren enthält die Werkzeuge für gescannte Dokumente. Die Texterkennung läuft on-device über die Vision-Frameworks von macOS.

7.1 OCR-Workflow

• OCR einzeln oder als Batch: Wähle OCR für die aktuelle Seite oder Batch-OCR für das gesamte Dokument. Der Batch-Dialog zeigt Fortschritt und erlaubt den Abbruch.
• Sprachen: Lege bevorzugte Sprachen pro Dokument fest; mehrere Sprachen werden in einem Lauf erkannt.
• Textkorrektur-Modus: Nach dem OCR öffnet sich eine Seitenansicht mit dem erkannten Text neben der Seite. Zweifelhafte Wörter werden markiert; du korrigierst sie direkt.
• PDF/A-Ausgabe: Speichere das Ergebnis direkt als PDF/A-1b oder PDF/A-2u über den Inspector oder den Export-Dialog.

7.2 Scan-Bereinigung

Für gescannte Seiten stehen im Register Exportieren folgende Bereinigungen bereit:

Die Bereinigungen können einzeln oder kombiniert angewendet werden. Das Ergebnis ist jederzeit widerrufbar, bis du das Dokument sicherst.

8. Automatisierung (MCP)

Über den MCP-Host in AnnexHub stehen agentische Werkzeuge bereit: pdf.open_document, pdf.merge, pdf.split, pdf.export_images, pdf.fill_form, pdf.sign, pdf.to_pdfa, pdf.redact sowie suite.run_smoke AnnexPDF. Alle Tools wirken echt auf Dateien (Pfade als Argumente, JSON-Ergebnisse) und benötigen keine laufende AnnexPDF-App.

9. Diagnostik & Support

Fehler und Aktionen werden lokal über AnnexLog protokolliert (rotierende JSON-Logs unter ~/Library/Logs/AnnexCREATE/AnnexPDF/, ohne personenbezogene Dateipfade). Beispieldatei: docs/examples/SampleDocument.pdf. Tutorial: docs/tutorials/de/AnnexPDF.md.