KDE-Client (Linux)
Der KDE-Client zeigt den Editor in einem eigenen Programmfenster statt im Browser. Er startet das Programm omnipressix selbst im Hintergrund und beendet es beim Schließen wieder, oder er verbindet sich mit einem OmniPressix-Server. Er ist mit Qt 6 gebaut und fügt sich in KDE Plasma ein, läuft aber auch unter anderen Linux-Oberflächen.
Was anders ist als im Browser:
- Eigenes Fenster mit Symbol im Startmenü und in der Fensterleiste. Ein zweiter Start holt das offene Fenster nach vorn.
.opx-Dateien (Layouts und Vorlagen, siehe Dateiformat) sind dem Programm zugeordnet: Ein Doppelklick im Dateimanager öffnet das Layout im Editor (läuft das Programm schon, im vorhandenen Fenster), ebensoomnipressix-desktop datei.opx. Das gilt auch für das Flatpak (die Datei kommt über das Dokumentenportal). Nach einer Installation von Hand ggf.update-mime-database ~/.local/share/mime.- Speichern (Layout, PDF, Beispiel-CSV) fragt mit dem Speichern-Dialog des Systems nach dem Ort.
- Drucken öffnet den Druckdialog des Systems mit allen Einstellungen des Druckers. Papiergröße und Ausrichtung sind schon passend zur Karte bzw. zum A4-Bogen vorgewählt.
- Vorlagen und Fotos liegen in
~/.local/share/omnipressix(Unterordnervorlagenundfotos; bis 4.0 hieß der Ordner~/.local/share/omnipressixfreeund wird beim ersten Start automatisch umbenannt, ebenso~/.config/omnipressixfree), das Druckprotokoll dort indruckprotokoll.jsonl. - Einstellungen des Editors, Druckprofile und die Anmeldung am Server bleiben über Neustarts erhalten.
- Links auf andere Seiten öffnen sich im normalen Browser.
- Kamera für „Foto mit der Kamera aufnehmen“ ist für den Editor ohne Nachfrage freigegeben, auch bei der Verbindung zu einem Server; andere Seiten bekommen sie nicht. Das Flatpak braucht dafür Zugriff auf die Geräte (
--device=all).
Bauen und installieren#
Fedora:
sudo dnf install gcc-c++ cmake golang qt6-qtbase-devel qt6-qtwebengine-devel qt6-qtwebchannel-devel qt6-qtpdf-devel
Debian/Ubuntu (ab Ubuntu 24.04):
sudo apt install g++ cmake golang qt6-base-dev qt6-webengine-dev qt6-webchannel-dev qt6-pdf-dev
Im Projektordner:
cmake -S desktop/kde -B build-kde -DCMAKE_BUILD_TYPE=Release
cmake --build build-kde -j
./build-kde/omnipressix-desktop # ausprobieren
cmake --install build-kde --prefix ~/.local # installieren (nur für dich, ohne sudo)
Das Go-Programm omnipressix wird dabei mitgebaut und nach libexec/omnipressix/ installiert. Wer es schon anders installiert hat, schaltet das mit -DOMNIPRESSIX_BUILD_PROGRAM=OFF ab. Der Client sucht das Programm dann im PATH.
./build-all.sh kde baut den Client und packt ihn als dist/omnipressix-kde-linux-amd64.tar.gz. Ohne Angabe baut build-all.sh ihn mit, sobald cmake installiert ist. Das Archiv entpackt man so:
tar -xzf omnipressix-kde-linux-amd64.tar.gz -C ~/.local --strip-components=1
Das Archiv enthält kein Qt. Es läuft deshalb nur auf Systemen, deren Qt-Version mindestens so neu ist wie die des Rechners, auf dem es gebaut wurde (z. B. innerhalb derselben Fedora-Version). Für andere Systeme gibt es das Flatpak.
Als Flatpak#
Das Flatpak enthält Client und Programm und läuft auf jeder Linux-Distribution mit Flatpak. Es bringt Qt über die KDE-Laufzeit von Flathub mit.
flatpak install --user flathub org.flatpak.Builder # einmalig
./build-all.sh flatpak # ergibt dist/omnipressix-<version>.flatpak
Ohne Angabe baut ./build-all.sh das Flatpak mit, sobald flatpak-builder installiert ist.
Beim ersten Bauen lädt flatpak-builder die KDE-Laufzeit und die Qt-WebEngine-Grundlage (rund 2 GB); spätere Builds gehen schnell. Go lädt beim Bauen seine Bibliotheken, der Build braucht also Internet. Die Beschreibung steht in desktop/kde/flatpak/click.schmalle.OmniPressix.yml.
Installieren und starten, auf jedem Rechner:
flatpak install --user omnipressix-3.0.0.flatpak # holt die KDE-Laufzeit von Flathub, falls nötig
flatpak run click.schmalle.OmniPressix
Danach steht OmniPressix auch im Startmenü. Unterschiede zur normalen Installation:
- Vorlagen und Fotos liegen in
~/.var/app/click.schmalle.OmniPressix/data/omnipressix, die Einstellungen in~/.var/app/click.schmalle.OmniPressix/config/omnipressix. - Öffnen und Speichern gehen über die Dateidialoge von Flatpak („Portale“). Das Programm sieht nur die Dateien, die man dort auswählt.
- Drucken geht über CUPS, also an alle Drucker des Systems.
Wie man OmniPressix auf Flathub veröffentlicht, damit es in KDE Discover und GNOME Software erscheint, steht in Auf Flathub veröffentlichen.
Verbindung einstellen#
Beim ersten Start verbindet sich der Client lokal, wenn er das Programm findet. Sonst erscheint das Fenster Verbindung einstellen. Später erreicht man es mit Strg+Umschalt+,, per Rechtsklick auf das Symbol im Startmenü („Verbindung einstellen …“) oder mit omnipressix-desktop --einstellungen.
- Auf diesem Rechner: Der Client startet
omnipressixauf dem angegebenen Port (Standard 8090). Läuft dort schon ein OmniPressix, wird es mitbenutzt. Das Programm sucht er in dieser Reihenfolge: eingetragener Pfad, neben dem Client,../libexec/omnipressix/relativ zum Client, im Installationsordner, imPATH. - OmniPressix-Server: Adresse eintragen, z. B.
https://karten.example.org. Die Anmeldung erfolgt im Fenster. Bei einem selbst ausgestellten Zertifikat fragt der Client einmal je Start nach.
Die Angaben stehen in ~/.config/omnipressix/desktop.conf. Mit --server URL verbindet sich der Client nur für diesen Start mit einem Server.
Tasten#
| Taste | Wirkung |
|---|---|
Strg+Umschalt+, | Verbindung einstellen |
F5 | Editor neu laden |
F11 | Vollbild |
Strg+Q | Beenden |
Alle anderen Tasten gehören dem Editor (siehe Bedienung). „Programm beenden“ im Editor schließt auch das Fenster.
Aufbau#
Der Client (desktop/kde/src) ist ein Qt-Widgets-Programm mit Qt WebEngine:
backend.cppstartet und beendetomnipressix. Es erkennt ein laufendes OmniPressix am KopfX-OmniPressix-Apider Antwort auf/healthz.mainwindow.cppenthält Fenster, Profil, Speichern-Dialog, Zertifikatsabfrage und externe Links.printbridge.cppdruckt: Der Editor reicht das PDF über QWebChannel weiter (bridge.js, in jede Seite eingefügt, undprintBlobinweb/js/print.js). Die Seiten werden mit QtPdf in Druckerauflösung (höchstens 600 dpi) gerendert.- Die Versionsnummer liest
CMakeLists.txtausinternal/version/version.go.