Zum Inhalt springen
PenBlitz
← Entwickler

Kommandozeile

penblitz-server erledigt alles ohne Fenster: die API bereitstellen, Vorschauen rechnen, drucken und Assistenten einrichten.

Wo es liegt

Das Programm steckt in der App. Ruf es mit vollem Pfad auf oder leg einen Verweis darauf an einer Stelle in deinem PATH an.

/Applications/PenBlitz.app/Contents/MacOS/penblitz-server --help

Befehle

BefehlWas er tut
serveStellt die REST-API bereit. Optionen: --port, --bind, --api-key, --printer.
renderSchreibt Vorschauen als SVG (mit --gcode auch G-Code) in einen Ordner.
printDruckt ein Dokument oder einen Seriendruck und wartet, bis er fertig ist.
templatesListet die gespeicherten Vorlagen.
exampleGibt Beispieldaten für den Seriendruck als CSV aus, mit --json als JSON.
traceMacht aus dem Bild einer Unterschrift ein SVG mit einer einzelnen Linie.
discoverSucht im lokalen Netzwerk nach Druckern.
mcpLäuft als MCP-Server für KI-Assistenten.
mcp-installTrägt den MCP-Server ein: claude-code, codex, claude-desktop, cursor oder all.
openapiGibt die OpenAPI-Beschreibung der API aus.

Beispiele

# Vorschauen eines Seriendrucks, ein SVG pro Zeile
penblitz-server render --template voucher-qr --csv kunden.csv --out vorschau/

# einen kurzen Brief sofort drucken
penblitz-server print --text "Liebe Anna, vielen Dank!"

# einen Platzhalter von der Kommandozeile
penblitz-server print --template letter --set text="Hallo"

# die API ohne Drucker, zum Entwickeln
penblitz-server --mock serve --port 8787

# ein Foto der Unterschrift als Stiftlinie
penblitz-server trace unterschrift.png unterschrift.svg

Optionen für jeden Befehl

  • --mock simuliert den Drucker; es ist kein Gerät nötig.
  • --data-dir verwendet einen anderen Ordner für Einstellungen, Vorlagen und Aufträge.

penblitz-server serve und die App nicht gleichzeitig laufen lassen: Beide würden dieselben Einstellungen und denselben Drucker verwenden.