Installation, Start und Kommandozeilenoptionen
Voraussetzungen#
- Go ab Version 1.21
- Internetzugang beim ersten Mal, damit
go mod tidydie Bibliotheken laden kann - Ein aktueller Browser (Chrome, Edge, Firefox, Safari)
Verwendete Bibliotheken:
| Bibliothek | Zweck |
|---|---|
github.com/go-pdf/fpdf | PDF erzeugen |
github.com/boombuler/barcode | Strichcodes, DataMatrix und PDF417 berechnen |
github.com/piglig/go-qr | QR-Codes berechnen (mit Zeichensatz-Angabe für Umlaute) |
github.com/go-ldap/ldap/v3 | Anmeldung im Serverbetrieb |
github.com/esimov/pigo | Gesichtssuche für Passbilder |
golang.org/x/image | OpenType-Schriften lesen und umwandeln |
github.com/chromedp/chromedp | nur 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#
- Go installieren: Den Windows-Installer (
.msi) von https://go.dev/dl/ herunterladen und ausführen. Danach ein neues Terminal öffnen und mitgo versionprüfen, ob Go gefunden wird. - Ordner öffnen: Im Windows-Explorer in den Ordner
omnipressixwechseln, in die Adresszeilecmdoderpowershelltippen und Enter drücken. - Bauen: ``
go mod tidy go build -ldflags "-s -w" -o omnipressix.exe .`go mod tidylädt beim ersten Mal die Bibliotheken und braucht dafür Internet.-s -w` macht die Datei kleiner. - 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
.exeist 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/:
| Datei | System |
|---|---|
omnipressix-windows-amd64 | Windows 10/11, 64 Bit (Intel/AMD) |
omnipressix-windows-arm64 | Windows auf ARM (z. B. Surface Pro X) |
omnipressix-linux-amd64 | Linux, 64 Bit (Intel/AMD) |
omnipressix-linux-arm64 | Linux ARM 64 Bit (Raspberry Pi 4/5 mit 64-Bit-System, ARM-Server) |
omnipressix-linux-armv7 | Linux ARM 32 Bit (Raspberry Pi mit 32-Bit-System) |
omnipressix-macos-intel | macOS mit Intel-Prozessor |
omnipressix-macos-apple-silicon | macOS mit Apple Silicon (M1 und neuer) |
omnipressix-freebsd-amd64 | FreeBSD, 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:
| Aufruf | Wirkung |
|---|---|
bash build-all.sh windows | nur Windows bauen |
bash build-all.sh linux macos | mehrere Systeme (windows, linux, macos, freebsd) |
bash build-all.sh --no-archive | nur bauen, nichts verpacken |
bash build-all.sh --list | alle Ziele anzeigen |
bash build-all.sh --clean | Ordner 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 omnipressixausführen und dann./omnipressixstarten. 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 omnipressixausführen. - Windows: Doppelklick auf
omnipressix.exe. Zur Warnung von SmartScreen siehe Für Windows kompilieren. - Raspberry Pi: Welche Variante passt, zeigt
uname -m:aarch64bedeutetlinux-arm64,armv7lbedeutetlinux-armv7.
Kommandozeilenoptionen#
| Option | Standard | Bedeutung |
|---|---|---|
-addr | 127.0.0.1:8080 | Adresse und Port des Editors |
-no-browser | aus | Browser nicht automatisch öffnen |
-app-fenster | an | Editor in einem eigenständigen Fenster ohne Adressleiste/Tabs öffnen, siehe Als eigenständiges Fenster starten |
-auto-beenden | an | Programm automatisch beenden, wenige Sekunden nachdem das Editor-Fenster geschlossen wurde. Aus mit -auto-beenden=false |
-auto-beenden-nach | 2m | Fallback-Wartezeit für -auto-beenden, falls das Schließen selbst nicht erkannt wird, z. B. 90s oder 5m (mindestens 30s) |
-templates-dir | templates | Ordner für gespeicherte Vorlagen, siehe Vorlagenverwaltung |
-vorlagen-staende | 20 | Wie viele frühere Stände je Vorlage aufgehoben werden (0 = keine), siehe Frühere Stände |
-fotos-dir | fotos | Ordner für hochgeladene Fotos (OMNIPRESSIX_PHOTOS_DIR), siehe Bildfelder |
-druckprotokoll | druckprotokoll.jsonl | Datei für das Druckprotokoll (OMNIPRESSIX_PRINT_LOG), aus schaltet es ab |
-druckprotokoll-mb | 20 | Größe in MB, ab der das Druckprotokoll beiseitegelegt und neu begonnen wird (OMNIPRESSIX_PRINT_LOG_MAX_MB), 0 = nie |
-server | aus | Serverbetrieb 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 |
-sitzung | 12h | Höchstdauer einer Anmeldung |
-proxy | aus | Hinter 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 |
-wallet | aus | Digitaler 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=falsebekommst 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.