LuaBill · Dokumentation

LuaBill installieren und aktualisieren

Das Anwendungspaket und die externen Dokumentwerkzeuge werden getrennt eingerichtet. Der Assistent hilft bei den Komponenten für Ihre Ausgabeformate.

Windows

Starten Sie LuaBill-Setup-0.1.31-win64.exe unter Windows 10 ab Version 1809 oder Windows 11, x64. Die Installation gilt für den aktuellen Benutzer und enthält Python, PySide6/Qt und Mustang. Python muss nicht separat installiert werden.

Wählen Sie, ob eine Desktopverknüpfung und die Zuordnung von .luabill-Dateien eingerichtet werden sollen. Am Ende der Installation können Sie den Komponentenassistenten öffnen. Für ein Update schließen Sie LuaBill und installieren die neue Version in den vorhandenen Anwendungsordner; Projekte und Benutzereinstellungen werden separat aufbewahrt.

Windows-Installer herunterladen →

Linux

Entpacken Sie das vollständige Linux-Archiv und starten Sie das Installationsskript in dessen Ordner. Benötigt werden ein kompatibles Python 3.10–3.15 mit venv und pip sowie Internetzugang für PySide6/Qt. Das Skript erstellt eine eigene Umgebung und registriert den Menüeintrag und die .luabill-Dateien für Ihren Benutzer.

Die festgelegten Qt-Wheels benötigen ein unterstütztes Desktop-Linux mit glibc und die Qt-Systembibliotheken. Beachten Sie die Downloadvoraussetzungen für Ihre Architektur. Native Installation und grafischer Start wurden in der aktuellen Windows-Buildumgebung noch nicht geprüft.

sh install.sh

sh install.sh --setup-components --language de

macOS

Installieren Sie unter macOS 14.4 oder neuer ein kompatibles Python 3.10–3.15 mit venv und pip, entpacken Sie das vollständige ZIP und öffnen Sie Install_LuaBill.command. Intel und Apple Silicon verwenden dieselben Anwendungsquellen; pip wählt die passenden PySide6/Qt-Wheels.

Die Anwendungsdateien liegen normalerweise unter ~/Library/Application Support/LuaBill; der lokal erzeugte Starter befindet sich unter ~/Applications/LuaBill.app. Es handelt sich um eine Installation aus Quellen mit eigener Python-Umgebung. Der Starter ist weder mit einer Developer ID signiert noch notarisiert; ein nativer macOS-Start wurde hier nicht geprüft.

sh Install_LuaBill.command

sh Install_LuaBill.command --setup-components --language de

Externe Werkzeuge und Aktualisierungen

Bereiten Sie LuaLaTeX/texlua, Schriften und TeX-Pakete für alle Dokumente vor. Für XML-Prüfungen kommt Java 17+ hinzu, für ZUGFeRD Ghostscript. Hilfe → Komponenten und Installation erläutert fehlende Werkzeuge und verlinkt ihre offiziellen Installationsseiten.

Der Assistent kann vorhandene Werkzeuge verwenden und zeigt Aktionen, die ein Terminal oder Administratorpasswort benötigen. Starten Sie LuaBill nach Änderungen an PATH oder der Installation einer Komponente neu und prüfen Sie erneut. Hilfe → E-Rechnungsstandards und Aktualisierungen prüft auf Wunsch veröffentlichte Regelversionen; Updates werden nicht automatisch installiert.

Installations- oder Kompilierungsprobleme lösen →Versionshinweise der Anwendung →

← Zurück zur Dokumentation

Die Werkzeuge hinter Ihren Dokumenten

Der Einrichtungsassistent bereitet die Komponenten für die gewählten Formate vor. Prüfen Sie den Plan und starten Sie die Vorbereitung ausdrücklich; das bloße Öffnen des Assistenten oder der Start von LuaBill lädt nichts herunter.

LuaLaTeX + texlua

Für die Dokumenterstellung erforderlich

Verwenden Sie eine TeX-Distribution mit lualatex und texlua. Unter Windows kann der Assistent Basic MiKTeX installieren und die 19 direkten Vorlagenpakete samt Abhängigkeiten und Sprachdaten für EN/DE/FR/IT/RU vorbereiten. Geeignetes vorhandenes TeX wird weiterverwendet. Eine LuaHBTeX-Versionsmeldung ist normal; verwenden Sie weiterhin lualatex.

MiKTeX ↗TeX Live ↗MacTeX ↗

Ghostscript

Für ZUGFeRD erforderlich; bei normalem PDF optional

Ghostscript bereitet PDF/A-3 für ZUGFeRD vor und kann normale PDFs komprimieren. Der Assistent ergänzt es bei Bedarf für das ZUGFeRD-Profil und verwendet eine geeignete vorhandene Installation.

Offizielle Downloads ↗

Java 17+

Für XML, XRechnung und ZUGFeRD erforderlich

Ein kompatibles Java ab 17 führt die enthaltene Mustang-Prüfung und Verpackung aus. Für eine neue Windows-Einrichtung wird Temurin JRE 21 angeboten; der Homebrew-Weg unter macOS verwendet das Temurin-21-JDK. Normale PDF-Erzeugung benötigt kein Java.

Eclipse Temurin ↗

Python + PySide6/Qt

Unter Windows enthalten; unter Linux/macOS separat eingerichtet

Python führt die Anwendung aus, PySide6/Qt stellt Fenster und Menüs bereit. Die Linux/macOS-Installer erzeugen eine eigene Umgebung, benötigen ein vorhandenes kompatibles Python und laden PySide6 während der Einrichtung herunter.

Python herunterladen ↗

Private Noto-Dokumentschriften

Für alle fünf Dokumentsprachen vorbereitet

Der Assistent lädt einen geprüften Satz Noto Sans und Noto Sans Mono mit der ursprünglichen Lizenz in den LuaBill-Benutzerdatenordner. Die Schriften werden direkt aus diesen Dateien geladen und nicht im Betriebssystem registriert. Vorhandene Systemschriften bleiben als Rückfalloption nutzbar.

Noto-Schriften ↗

Der Installer enthält kein vollständiges TeX-System. Bei der ersten Vorbereitung können TeX-Werkzeuge, Pakete, Schriften und je nach Format Java/Ghostscript heruntergeladen werden. Der Assistent prüft alle fünf Sprachen und ein Beispieldokument des gewählten Profils. Der reine Komponentenbericht bestätigt nur einen Teil der Voraussetzungen.

Kompakter Installer, geführte Dokumenteinrichtung

LuaBill 0.1.27 ergänzt einen mehrsprachigen Einrichtungsassistenten. Bereiten Sie die Werkzeuge einmal vor und erstellen Sie Ihre Dokumente danach lokal; eine vollständige LaTeX-Distribution gehört nicht in den LuaBill-Installer.

Gewünschte Formate wählen
Öffnen Sie Hilfe → Dokumenterstellung vorbereiten oder lassen Sie die Vorbereitungsoption am Ende von Windows-Setup aktiviert. Wählen Sie PDF, XML/XRechnung oder ZUGFeRD.
Vorhandene Werkzeuge prüfen
Der Assistent erkennt geeignete TeX-, Java- und Ghostscript-Installationen und zeigt den Vorbereitungsplan. Ausgewählte Komponenten vorbereiten startet Downloads und Installation.
Pakete und Schriften vorbereiten
Windows kann mit Basic MiKTeX beginnen. Der Assistent bereitet die 19 direkten LaTeX-Pakete samt Abhängigkeiten und fünf Dokumentsprachen sowie private Noto-Sans- und Noto-Sans-Mono-Dateien vor. Java und Ghostscript richten sich nach dem Profil.
Geprüftes Beispiel erzeugen
Der Assistent übersetzt den separaten LaTeX-Test zweimal und erzeugt eine fiktive Rechnung über den gewählten Ausgabepfad. Öffnen Sie anschließend das Test-PDF. Bei einem Fehler können Sie den Protokollordner öffnen oder Diagnoseangaben kopieren.

Kompakter Installer, geführte Dokumenteinrichtung — LuaBill 0.1.31 · Beispieldokument

PDF

LuaLaTeX, texlua, die Vorlagenpakete und passende Schriften. Java und Ghostscript sind für normale PDF-Erzeugung nicht erforderlich.

PDF + XML / XRechnung

Die PDF-Komponenten und Java 17+ für die Mustang-XML-Prüfung. Für eine neue Windows-Einrichtung wird die kleinere Temurin JRE 21 angeboten.

ZUGFeRD

Die PDF/XML-Komponenten und Ghostscript für PDF/A-3 mit eingebetteter XML; der fertige Container wird validiert.

Das Anwendungspaket bleibt kompakt; fehlende Werkzeuge benötigen weiterhin separate Internetdownloads. Alle drei Erstellungsprofile wurden unter Windows mit installierten Werkzeugen erfolgreich geprüft. Die vollständige Einrichtung auf einem leeren Windows-PC und native Linux/macOS-Installationen sind noch gesondert zu verifizieren.

Separaten LaTeX-Test herunterladen ↓

Der separate Test funktioniert ohne LuaBill: LuaLaTeX wählen und zweimal übersetzen. Er prüft alle 19 direkten Pakete, fünf Sprachen, Formeln, Symbole, Tabellen und Schriften. MiKTeX kann fehlende TeX-Pakete bei aktivierter Nachinstallation laden; Systemschriften benötigen außerhalb des Assistenten eine separate Installation. SHA-256-Prüfsummen

Aktualisieren, Komponenten prüfen und entfernen

Installieren Sie die aktuelle Version über der vorhandenen LuaBill-Installation und prüfen Sie die aktiven Rechnungsregeln im Hilfemenü. Sieben bearbeitbare Beispiele mit fertigen PDFs sind in der Anwendung und als vollständiges ZIP enthalten.

Neue Version darüber installieren

Schließen Sie LuaBill und starten Sie den neuen Installer über der vorhandenen Installation. Ein vorheriges Deinstallieren ist nicht nötig.

Unter Windows den von Setup vorgeschlagenen bisherigen Ordner beibehalten.
Unter Linux/macOS denselben --prefix für einen selbst gewählten Ordner verwenden.
Projekte, Ergebnisse und Einstellungen in persönlichen Ordnern bleiben erhalten.

Linuxsh install.sh

macOSsh Install_LuaBill.command

Manuelle Programmänderungen separat sichern. Unter Linux/macOS stoppt ein Dateikonflikt die Aktualisierung. Prüfen Sie nach dem Update die Regelversionen unter Hilfe → E-Rechnungsstandards und Aktualisierungen. Ein älterer Stand sollte nicht über einen neueren installiert werden.

Komponenten vorbereiten und Beispiel prüfen

Öffnen Sie Hilfe → Dokumenterstellung vorbereiten, um ein Profil zu wählen, vorhandene Werkzeuge zu prüfen und fehlende Komponenten vorzubereiten.

Das Windows-Paket enthält Python/Qt. Linux/macOS verwendet ein vorhandenes Python und installiert Qt in eine eigene Umgebung.
PDF benötigt TeX und Schriften; XML/XRechnung zusätzlich Java 17+; ZUGFeRD außerdem Ghostscript.
Die Vorbereitung übersetzt den separaten LaTeX-Test für fünf Sprachen zweimal und prüft danach den tatsächlichen Erstellungs- und Validierungsweg des gewählten Profils.

Beim Öffnen wird nur geprüft. Ausgewählte Komponenten vorbereiten startet Downloads und Installation; alternativ können Sie die vorhandene Einrichtung testen. Protokolle und Test-PDFs lassen sich im Assistenten öffnen.

Programmdateien entfernen

Der Uninstaller eines neuen Archivs kann eine ältere Installation ohne Neuinstallation von LuaBill entfernen.

LuaBill schließen und bei eigener Installation denselben --prefix angeben.
Dokumente, Einstellungen sowie geänderte oder unbekannte Dateien bleiben erhalten.
Warnungen und die abschließende Liste verbleibender Dateien prüfen.

Linuxsh uninstall.sh

macOSsh Uninstall_LuaBill.command

Auch das kleine separate Archiv entfernt bestehende Installationen. Systemwerkzeuge TeX, Java und Ghostscript sowie heruntergeladene Paketordner bleiben erhalten.

Separater Uninstaller für Linux/macOS ↓ ZIP · 23 KB

SHA-256-Prüfsummen

Benutzerhandbuch ↗