OmniPressix

Installation, Start und Kommandozeilenoptionen

Voraussetzungen#

  • Go ab Version 1.21
  • Internetzugang beim ersten Mal, damit go mod tidy die Bibliotheken laden kann
  • Ein aktueller Browser (Chrome, Edge, Firefox, Safari)

Verwendete Bibliotheken:

BibliothekZweck
github.com/go-pdf/fpdfPDF erzeugen
github.com/boombuler/barcodeStrichcodes, DataMatrix und PDF417 berechnen
github.com/piglig/go-qrQR-Codes berechnen (mit Zeichensatz-Angabe für Umlaute)
github.com/go-ldap/ldap/v3Anmeldung im Serverbetrieb
github.com/esimov/pigoGesichtssuche für Passbilder
golang.org/x/imageOpenType-Schriften lesen und umwandeln
github.com/chromedp/chromedpnur für die Oberflächentests (steuert einen Browser), nicht im Programm

Installation und Start#

Im Projektordner (dort, wo go.mod und main.go liegen):

cd omnipressix
go mod tidy
go run .

Der Editor öffnet sich automatisch im Browser unter http://127.0.0.1:8080. Beenden mit Strg+C im Terminal.

Als einzelne Programmdatei bauen (die Oberfläche ist darin eingebettet):

go build -o omnipressix .

Für Windows kompilieren#

  1. Go installieren: Den Windows-Installer (.msi) von https://go.dev/dl/ herunterladen und ausführen. Danach ein neues Terminal öffnen und mit go version prüfen, ob Go gefunden wird.
  2. Ordner öffnen: Im Windows-Explorer in den Ordner omnipressix wechseln, in die Adresszeile cmd oder powershell tippen und Enter drücken.
  3. Bauen: `` go mod tidy go build -ldflags "-s -w" -o omnipressix.exe . ` go mod tidy lädt beim ersten Mal die Bibliotheken und braucht dafür Internet. -s -w` macht die Datei kleiner.
  4. Starten: Doppelklick auf omnipressix.exe. Es öffnet sich ein Terminalfenster und der Editor im Browser. Zum Beenden das Terminalfenster schließen.

Einfacher geht es mit der mitgelieferten Datei build-windows.bat. Ein Doppelklick darauf führt die beiden Befehle aus und erzeugt omnipressix.exe.

Hinweise:

  • Die .exe ist eigenständig. Sie enthält die Oberfläche (index.html) und braucht keine weiteren Dateien und keine Go-Installation. Du kannst sie auf andere Windows-Rechner kopieren.
  • Beim ersten Start warnt Windows („SmartScreen“) eventuell vor einer unbekannten App, weil die Datei nicht signiert ist. Mit „Weitere Informationen“ und „Trotzdem ausführen“ startest du sie.
  • Das Programm lauscht nur auf 127.0.0.1. Die Windows-Firewall fragt deshalb normalerweise nicht nach. Falls doch, reicht „Abbrechen“, es braucht keinen Netzwerkzugriff.
  • Das Terminalfenster zeigt Meldungen wie die PDF-Anfrage-Zeilen. Wer das Fenster ausblenden will, kann mit -ldflags "-H=windowsgui" bauen. Dann lässt sich das Programm aber nur noch über den Task-Manager beenden, deshalb ist das nicht empfohlen.

Von einem anderen System aus für Windows bauen: Das Programm braucht kein C und lässt sich deshalb unter Linux oder macOS direkt für Windows bauen:

GOOS=windows GOARCH=amd64 go build -ldflags "-s -w" -o omnipressix.exe .

Für Windows auf ARM (z. B. Surface Pro X) nimmst du GOARCH=arm64.

Für alle Systeme bauen (Linux)#

Das Skript build-all.sh baut das Programm in einem Rutsch für alle wichtigen Systeme und verpackt die Ergebnisse. Es läuft unter Linux (und macOS) und braucht nur Go.

bash build-all.sh

(Alternativ einmal chmod +x build-all.sh und dann ./build-all.sh.)

Die fertigen Dateien liegen danach im Ordner dist/:

DateiSystem
omnipressix-windows-amd64Windows 10/11, 64 Bit (Intel/AMD)
omnipressix-windows-arm64Windows auf ARM (z. B. Surface Pro X)
omnipressix-linux-amd64Linux, 64 Bit (Intel/AMD)
omnipressix-linux-arm64Linux ARM 64 Bit (Raspberry Pi 4/5 mit 64-Bit-System, ARM-Server)
omnipressix-linux-armv7Linux ARM 32 Bit (Raspberry Pi mit 32-Bit-System)
omnipressix-macos-intelmacOS mit Intel-Prozessor
omnipressix-macos-apple-siliconmacOS mit Apple Silicon (M1 und neuer)
omnipressix-freebsd-amd64FreeBSD, 64 Bit

Für jedes System entstehen ein Ordner mit dem Programm, der README und der Dokumentation (docs/) sowie ein Archiv (.zip für Windows und macOS, .tar.gz für Linux und FreeBSD). Dazu kommt die Datei SHA256SUMS.txt mit den Prüfsummen der Archive.

Weitere Aufrufe:

AufrufWirkung
bash build-all.sh windowsnur Windows bauen
bash build-all.sh linux macosmehrere Systeme (windows, linux, macos, freebsd)
bash build-all.sh --no-archivenur bauen, nichts verpacken
bash build-all.sh --listalle Ziele anzeigen
bash build-all.sh --cleanOrdner dist/ löschen

Weitere Ziele fügst du in der Liste TARGETS am Anfang des Skripts als neue Zeile hinzu. Welche Kombinationen Go kennt, zeigt go tool dist list. Ist ein Ziel fehlgeschlagen, nennt das Skript es am Ende und beendet sich mit einem Fehlercode. Die anderen Ziele werden trotzdem gebaut. Für das Verpacken als .zip braucht das Skript das Programm zip. Fehlt es, werden Windows und macOS als .tar.gz verpackt.

Hinweise zum Start auf den Zielsystemen:

  • Linux, macOS, FreeBSD: Nach dem Entpacken einmal chmod +x omnipressix ausführen und dann ./omnipressix starten. Der Browser öffnet sich automatisch.
  • macOS: Die Datei ist nicht bei Apple signiert. Beim ersten Start blockiert macOS sie deshalb eventuell („Entwickler nicht verifiziert“). Rechtsklick auf die Datei, „Öffnen“ und bestätigen, oder im Terminal xattr -d com.apple.quarantine omnipressix ausführen.
  • Windows: Doppelklick auf omnipressix.exe. Zur Warnung von SmartScreen siehe Für Windows kompilieren.
  • Raspberry Pi: Welche Variante passt, zeigt uname -m: aarch64 bedeutet linux-arm64, armv7l bedeutet linux-armv7.

Kommandozeilenoptionen#

OptionStandardBedeutung
-addr127.0.0.1:8080Adresse und Port des Editors
-no-browserausBrowser nicht automatisch öffnen
-app-fensteranEditor in einem eigenständigen Fenster ohne Adressleiste/Tabs öffnen, siehe Als eigenständiges Fenster starten
-auto-beendenanProgramm automatisch beenden, wenige Sekunden nachdem das Editor-Fenster geschlossen wurde. Aus mit -auto-beenden=false
-auto-beenden-nach2mFallback-Wartezeit für -auto-beenden, falls das Schließen selbst nicht erkannt wird, z. B. 90s oder 5m (mindestens 30s)
-templates-dirtemplatesOrdner für gespeicherte Vorlagen, siehe Vorlagenverwaltung
-vorlagen-staende20Wie viele frühere Stände je Vorlage aufgehoben werden (0 = keine), siehe Frühere Stände
-fotos-dirfotosOrdner für hochgeladene Fotos (OMNIPRESSIX_PHOTOS_DIR), siehe Bildfelder
-druckprotokolldruckprotokoll.jsonlDatei für das Druckprotokoll (OMNIPRESSIX_PRINT_LOG), aus schaltet es ab
-druckprotokoll-mb20Größe in MB, ab der das Druckprotokoll beiseitegelegt und neu begonnen wird (OMNIPRESSIX_PRINT_LOG_MAX_MB), 0 = nie
-serverausServerbetrieb für mehrere Benutzer (Standardadresse dann 0.0.0.0:8080, kein Browser, kein automatisches Beenden), siehe Serverbetrieb
-anmeldung–ldap oder keine; im Serverbetrieb Pflicht
-sitzung12hHöchstdauer einer Anmeldung
-proxyausHinter einem Reverse Proxy: X-Forwarded-For/-Proto vertrauen
-tls-cert, -tls-key–HTTPS direkt im Programm (PEM-Dateien)
-healthcheck–Prüft, ob ein laufendes OmniPressix antwortet (für Docker), und beendet sich
-walletausDigitaler Ausweis (Wallet-Pass) anbieten
-wallet-apple-cert, -wallet-apple-key, -wallet-apple-wwdr–Apple Pass-Type-ID-Zertifikat samt Schlüssel und Apple-WWDR-Zwischenzertifikat (PEM-Dateien); ohne sie bleibt der Apple-Pass unsigniert
-wallet-apple-team, -wallet-apple-type, -wallet-apple-org–Apple Team Identifier, Pass Type Identifier und Organisationsname
-wallet-google-sa–Pfad zur JSON-Datei eines Google-Cloud-Dienstkontos (Google Wallet API); ohne sie bleibt Google Wallet aus
-wallet-google-issuer, -wallet-google-class–Google-Wallet-Issuer-ID und -Klasse

Die Optionen des Serverbetriebs lassen sich auch über Umgebungsvariablen setzen (siehe Einstellungen).

Beispiel: go run . -addr 127.0.0.1:9000 -no-browser

Das Programm lauscht nur auf dem eigenen Rechner (127.0.0.1). Kundendaten verlassen ihn nicht.

Automatisch beenden, wenn das Fenster geschlossen wird#

OmniPressix beendet sich standardmäßig (-auto-beenden) von selbst, sobald kein Editor-Fenster mehr offen ist – normalerweise wenige Sekunden nach dem Schließen:

  • Der Editor meldet dem Programm beim Schließen, Neuladen oder Verlassen der Seite kurz Bescheid. War das ein echtes Schließen und kein einfaches Neuladen (F5), wartet das Programm nur wenige Sekunden und beendet sich dann.
  • Ein Neuladen der Seite lässt sich technisch nicht von einem Schließen unterscheiden, deshalb wartet das Programm diese kurze Zeit ab: Lädt sich die Seite in der Zeit neu, meldet sie sich sofort wieder, und das Beenden wird abgebrochen.
  • Hast du mehrere Tabs oder Fenster mit dem Editor gleichzeitig offen, beendet sich das Programm erst, wenn wirklich keines davon mehr offen ist.
  • -auto-beenden-nach (Standard 2 Minuten) ist nur die Rückfalllösung für Fälle, in denen das Schließen selbst nicht erkannt wird, z. B. wenn der Browser abstürzt oder der Rechner in den Ruhezustand geht.

Soll das Programm auch ohne offenes Fenster im Hintergrund weiterlaufen (z. B. auf einem Server, den mehrere Personen zu unterschiedlichen Zeiten nutzen), startest du es mit -auto-beenden=false. Beenden geht dann weiterhin jederzeit über den Button „Programm beenden“ im Editor oder mit Strg+C.

Als eigenständiges Fenster starten#

Standardmäßig (-app-fenster ist an) sucht OmniPressix beim Start nach Chrome, Edge, Chromium oder Brave. Findet es einen davon, öffnet sich der Editor ohne Adressleiste und ohne Tabs – wie ein eigenständiges Programm, nicht wie eine Browser-Registerkarte. Technisch ist es weiterhin derselbe Browser, nur im sogenannten „App-Modus“ (--app=…), den Chromium-basierte Browser mitbringen.

  • Ist keiner dieser Browser installiert, öffnet sich stattdessen ganz normal der Standardbrowser mit Adressleiste, z. B. Firefox oder Safari – die kennen diesen App-Modus nicht. Der Editor funktioniert dort genauso, sieht nur weniger nach eigenständiger App aus.
  • Mit -app-fenster=false bekommst du immer die normale Browser-Ansicht mit Adressleiste.
  • Die lokale Version wird nicht als App (PWA) des Browsers installiert: Sie läuft nur, solange das Programm läuft, und hat dafür das eigene App-Fenster oben. Für ein Startmenü-Symbol legt man eine Verknüpfung auf das Programm an (bzw. nutzt den KDE-Client). Die Installation als App gibt es im Serverbetrieb, siehe unten.

Installation als App (PWA, nur Serverbetrieb)#

Im Serverbetrieb (-server, siehe Serverbetrieb) lässt sich der Editor in Chrome, Edge und anderen Chromium-Browsern als App installieren: Er bekommt ein eigenes Symbol im Startmenü bzw. Dock und öffnet sich in einem eigenen Fenster ohne Adressleiste. Dazu im Editor oben auf das Symbol „Pfeil in Schale“ („Datei“) und dort auf „OmniPressix als App installieren“. Der Knopf erscheint nur, wenn der Browser das anbietet (also nicht in Firefox oder Safari und nicht, wenn die App schon installiert ist). Alternativ geht es über das Browser-Menü („App installieren“ bzw. „Diese Seite als App installieren“).

Die App ist nur die Oberfläche: Das Programm (der Server) muss zum Arbeiten weiterhin laufen. Läuft es nicht, zeigt die App eine Hinweisseite („Das OmniPressix-Programm läuft nicht“), die den Editor von selbst lädt, sobald das Programm gestartet ist. Die Installation gilt für die Adresse, unter der sie gemacht wurde – bei einem anderen Port (-addr) muss sie neu erfolgen.