LuaBill — Installation guide

Deutsch · English · Français · Italiano · Русский

Windows: Installation und erster Start

LuaBill für Windows x64 enthält Python 3.12, PySide6 / Qt 6.12 und Mustang. Python muss nicht zusätzlich installiert werden. Python führt die App aus; PySide6/Qt zeichnet Fenster, Menüs und Tabellen. Diese private Laufzeit gehört nur zu LuaBill und ersetzt kein vorhandenes System-Python. Programmierkenntnisse sind nicht nötig. Unterstützt werden Windows 10 ab Version 1809 und Windows 11.

Starten Sie LuaBill-Setup-0.1.31-win64.exe. Die Installation erfolgt für Ihr Benutzerkonto, normalerweise unter %LOCALAPPDATA%\Programs\LuaBillDesktop.
Wählen Sie bei Bedarf Desktop-Verknüpfung erstellen. Diese Option ist zunächst ausgeschaltet. Die separate Option für .luabill-Dateien ist zunächst eingeschaltet.
Öffnen Sie LuaBill über das Startmenü, die Desktop-Verknüpfung oder eine zugeordnete .luabill-Datei. Falls bereits eine andere Standardanwendung gewählt ist, ändern Sie diese über die Windows-Dateieigenschaften.
Lassen Sie zum Abschluss Komponenten für die Dokumenterstellung vorbereiten ausgewählt, um den Assistenten zu öffnen. Auch die Schaltfläche unter dem Komponentenbericht und ein Startmenüeintrag öffnen ihn. Allein das Öffnen startet keinen Download.

Aktualisieren

Schließen Sie LuaBill und starten Sie den neuen Installer im bisherigen Programmordner. Der Installer übernimmt den vorherigen Pfad und die ausgewählten Aufgaben. Eine vorherige Deinstallation ist nicht nötig; Projekte, PDF/XML und Benutzereinstellungen bleiben erhalten. Downgrades werden nicht unterstützt. Python/PySide6 werden mit dem Windows-Paket aktualisiert; TeX, Java und Ghostscript bleiben separate Installationen.

Für die Dokumenterstellung zusätzlich installieren

Die Oberfläche kann sofort gestartet werden. Für Import, Berechnung und Dokumenterstellung werden folgende externe Programme benötigt:

MiKTeX oder TeX Live mit lualatex, texlua und den LaTeX-Paketen der Vorlage. Die Programme müssen über PATH erreichbar sein.
Noto Sans oder DejaVu Sans als Unicode-Schrift; Arial ist die Ausweichschrift unter Windows.
Java 17 oder neuer für XML-Prüfung, XRechnung und ZUGFeRD. Wählen Sie Windows, x64, JRE oder JDK; aktivieren Sie bei der Installation PATH oder JAVA_HOME.
Ghostscript für PDF-Komprimierung; für ZUGFeRD PDF/A-3 erforderlich.

Mustang ist bereits enthalten. Für normale PDF-Dateien ist Ghostscript optional; ohne Ghostscript entfällt nur die zusätzliche Komprimierung. Für ZUGFeRD ist es erforderlich. Wählen Sie auf der Downloadseite Windows 64 bit.

Öffnen Sie Hilfe → Dokumenterstellung vorbereiten. Wählen Sie PDF, PDF + XML/XRechnung oder ZUGFeRD, prüfen Sie den Plan und starten Sie die Vorbereitung. Geeignete vorhandene Werkzeuge werden weiterverwendet. Für eine neue TeX-Installation wird Basic MiKTeX mit den benötigten Paketen angeboten. Java JRE und Ghostscript werden nur für entsprechende Profile benötigt. Externe Installer können eigene Dialoge oder Administratorrechte benötigen.

Noto-Schriften werden als Dateien für LuaBill vorbereitet, ohne sie in den System-Schriftordner zu installieren. Nach der Vorbereitung erstellt der Assistent ein Testdokument; PDF und Protokoll lassen sich direkt öffnen. Weitere Hinweise: Komponentenvorbereitung.

Am Ende der Installation erscheint ein Komponentenbericht in DE/EN/FR/IT/RU mit Zweck und offiziellen Links. „Erneut prüfen“ aktualisiert den Bericht. Geprüft werden TeX-Befehle/Stildateien, Ghostscript und Java 17+. Dieser reine Informationsbericht installiert keine Programme und bestätigt nicht alle Pakete oder Schriftarten. Verwenden Sie Komponenten vorbereiten für die Einrichtung mit anschließender Testkompilierung. Bei stiller Installation wird der Assistent nicht geöffnet.

Bei MiKTeX bleibt die Dateisuche für Pakete ungeprüft, damit keine automatische Paketinstallation ausgelöst wird. Der separate Assistent bereitet Pakete erst nach Ihrem Startbefehl vor und prüft sie durch eine echte Kompilierung.

Assistent ohne Editor: LuaBill.exe --setup-components --language de.

Ein Bericht ohne GUI kann im Programmordner erstellt werden: LuaBill.exe --component-report report.txt --language de.

Projekte und Ergebnisse

Öffnen Sie über Datei ein Beispiel, ersetzen Sie die Angaben und speichern Sie Ihr eigenes .luabill-Projekt. Mit F7 prüfen Sie die Summen, mit F9 erstellen Sie PDF/XML. Nach Erfolg öffnet sich das PDF; die Ergebnisanzeige bietet weitere Schaltflächen zum Öffnen.

Projekte gehören außerhalb des Programmordners. Vorgeschlagen werden Dokumente/LuaBill/Projects und getrennt davon Dokumente/LuaBill/Output. Der zuletzt verwendete Projektordner wird gemerkt. Ausgabeordner und die Option „neben dem Projekt“ sind lokale Programmeinstellungen und werden nicht in .luabill gespeichert.

Die Deinstallation erhält Ihre Projekte, Ergebnisse und Benutzereinstellungen. Der Installer aktualisiert vorhandene LuaBillDesktop-Versionen im selben Ordner. Ein früherer separater .bill-Handler und seine Dateizuordnung bleiben unberührt.

Windows: install and start

LuaBill for Windows x64 includes Python 3.12, PySide6 / Qt 6.12 and Mustang. No separate Python installation is needed. Python runs the app; PySide6/Qt draws its windows, menus and tables. This private runtime belongs to LuaBill and does not replace an existing system Python. No programming skills are needed. Windows 10 version 1809 or newer, or Windows 11, is required.

Run LuaBill-Setup-0.1.31-win64.exe. It installs for your user account, normally in %LOCALAPPDATA%\Programs\LuaBillDesktop.
Select Create a desktop shortcut if wanted; this option starts unchecked. The separate .luabill file association option starts checked.
Start LuaBill from the Start menu, the desktop shortcut or an associated .luabill file. If Windows already uses another default application, change it in the file's Windows properties.
Leave Prepare document generation components selected on the final page to open the wizard. A button below the component report and a separate Start menu shortcut also open it. Opening the wizard starts no downloads.

Upgrade

Close LuaBill and run the new installer in the same program folder. The previous path and selected tasks are preselected. Uninstalling first is unnecessary; projects, PDF/XML and preferences are retained. Downgrades are unsupported. Python/PySide6 are updated with the Windows package; TeX, Java and Ghostscript remain separate installations.

Additional tools for document generation

The interface starts immediately. Importing, calculating and generating documents also require external tools:

MiKTeX or TeX Live, including lualatex, texlua and the template's LaTeX packages. The executables must be available on PATH.
Noto Sans or DejaVu Sans for Unicode text; Arial is the Windows fallback.
Java 17 or newer for XML validation, XRechnung and ZUGFeRD. Select Windows, x64 and JRE or JDK; enable PATH or JAVA_HOME during installation.
Ghostscript for PDF compression; required for ZUGFeRD PDF/A-3.

Mustang is already included. Ghostscript is optional for normal PDFs; without it, only the additional compression is skipped. It is required for ZUGFeRD. Select Windows 64 bit on its download page.

Open Help → Prepare document creation. Choose PDF, PDF + XML/XRechnung or ZUGFeRD, review the plan and start preparation. Suitable installed tools are reused. For a new TeX system, Basic MiKTeX with the required packages is offered. Java JRE and Ghostscript are needed only for the relevant profiles. External installers may show their own dialogs or request administrator rights.

Noto fonts are prepared as files for LuaBill without installing them in the system fonts directory. The wizard finishes by creating a test document; its PDF and logs can be opened directly. See the component setup guide for details.

Installation finishes with a component report in DE/EN/FR/IT/RU, explaining each tool and providing official links for missing tools. Use Check again to refresh it. This read-only report checks TeX commands/style files, Ghostscript and Java 17+ without installing anything. It does not confirm all packages or fonts. Use Prepare components for setup and a real test compilation. Silent installation does not open the wizard.

MiKTeX package-file lookup is left unverified to avoid triggering automatic package installation. The separate wizard prepares packages only after you start preparation, then verifies them by compiling a real document.

Open the wizard without the editor: LuaBill.exe --setup-components --language en.

To save a report without starting the GUI, run in the program folder: LuaBill.exe --component-report report.txt --language en.

Projects and results

Open an example in File, replace the details and save your own .luabill project. Press F7 to check totals and F9 to create PDF/XML. The PDF opens after successful generation; the result panel also provides buttons for opening files and their folder.

Keep projects outside the program folder. Suggested locations are Documents/LuaBill/Projects and, separately, Documents/LuaBill/Output. The last project folder is remembered. The output folder and the option to save beside the project are local app preferences, never stored in .luabill.

Uninstalling preserves your projects, output files and user preferences. The installer upgrades existing LuaBillDesktop versions in the same folder. An earlier separate .bill handler and its association are retained.

Windows : installation et préparation

Exécutez LuaBill-Setup-0.1.31-win64.exe sur Windows 10 version 1809 ou ultérieure, ou Windows 11, x64. Python, PySide6 / Qt et Mustang sont inclus. L’installation se fait pour votre compte, normalement dans %LOCALAPPDATA%\Programs\LuaBillDesktop. Le raccourci sur le bureau est facultatif ; l’association des fichiers .luabill est sélectionnée par défaut.

À la fin de l’installation, laissez cochée l’option Préparer les composants de création des documents pour ouvrir l’assistant. Le bouton sous le rapport des composants et un raccourci du menu Démarrer permettent également de l’ouvrir.
Dans LuaBill, utilisez Aide → Préparer la création des documents. Choisissez PDF, PDF + XML/XRechnung ou ZUGFeRD, puis vérifiez le plan.
Cliquez sur Préparer les composants choisis pour lancer les téléchargements et l’installation nécessaires. L’ouverture de l’assistant seule ne télécharge rien. Une connexion Internet est nécessaire ; certains installateurs peuvent demander des droits administrateur.
Les outils compatibles déjà installés sont réutilisés. Si TeX manque, l’assistant propose Basic MiKTeX avec les paquets nécessaires. Les profils XML nécessitent Java ; ZUGFeRD nécessite également Ghostscript. Une nouvelle Java pour Windows est fournie sous forme de Temurin JRE 21.
Les polices Noto sont téléchargées comme fichiers réservés à LuaBill, sans installation dans le dossier des polices système. La préparation se termine par la création d’un document de test. Utilisez Ouvrir le PDF de test ou, en cas d’erreur, Ouvrir le dossier du journal et Copier les détails.

Pour ouvrir seulement l’assistant : LuaBill.exe --setup-components --language fr. L’installation silencieuse ne lance pas l’assistant et n’installe pas les composants externes.

Mise à jour, projets et résultats

Fermez LuaBill et installez la nouvelle version dans le même dossier. Il n’est pas nécessaire de désinstaller auparavant. Les projets, PDF/XML et préférences sont conservés. Démarrez LuaBill depuis le menu Démarrer, le raccourci ou un fichier .luabill. Ouvrez un exemple dans Fichier, enregistrez votre propre projet, puis utilisez F7 pour les totaux et F9 pour créer les documents. Gardez vos projets hors du dossier du programme. Le dossier des résultats est un réglage local et n’est pas enregistré dans le projet.

LaTeX, Java et Ghostscript restent des composants séparés du paquet LuaBill. Le rapport Aide → Composants et installation reste disponible pour vérifier leur présence et consulter les liens officiels. Le test réel du profil sélectionné vérifie leur utilisation pour la création des documents.

Windows: installazione e preparazione

Esegui LuaBill-Setup-0.1.31-win64.exe su Windows 10 versione 1809 o successiva, oppure Windows 11, x64. Python, PySide6 / Qt e Mustang sono inclusi. L’applicazione viene installata per il tuo utente, normalmente in %LOCALAPPDATA%\Programs\LuaBillDesktop. Il collegamento sul desktop è facoltativo; l’associazione dei file .luabill è selezionata inizialmente.

Alla fine dell’installazione lascia selezionato Prepara i componenti per creare documenti per aprire la procedura. Puoi aprirla anche dal pulsante sotto il rapporto dei componenti o dal collegamento nel menu Start.
In LuaBill scegli Aiuto → Preparare la creazione dei documenti. Seleziona PDF, PDF + XML/XRechnung oppure ZUGFeRD e controlla il piano.
Premi Prepara i componenti selezionati per avviare i download e le installazioni necessari. Aprire la finestra non avvia alcun download. Serve Internet; alcuni programmi di installazione possono richiedere diritti di amministratore.
Gli strumenti compatibili già presenti vengono riutilizzati. Se TeX manca, viene proposto Basic MiKTeX con i pacchetti necessari. XML richiede Java; ZUGFeRD richiede anche Ghostscript. Per una nuova Java su Windows viene proposta Temurin JRE 21.
I caratteri Noto vengono scaricati come file di LuaBill, senza installarli nella cartella di sistema dei caratteri. La preparazione termina creando un documento di prova. Usa Apri PDF di prova; in caso di errore, usa Apri cartella del registro e Copia dettagli.

Per aprire solo la procedura: LuaBill.exe --setup-components --language it. L’installazione silenziosa non apre la procedura e non installa gli strumenti esterni.

Aggiornamenti, progetti e risultati

Chiudi LuaBill e installa la nuova versione nella stessa cartella. Non serve disinstallare prima. Progetti, PDF/XML e preferenze vengono conservati. Avvia LuaBill dal menu Start, dal collegamento o da un file .luabill. Apri un esempio da File, salva il tuo progetto, poi usa F7 per i totali e F9 per creare i documenti. Conserva i progetti fuori dalla cartella del programma. La cartella dei risultati è un’impostazione locale e non viene salvata nel progetto.

LaTeX, Java e Ghostscript restano componenti separati dal pacchetto LuaBill. Aiuto → Componenti e installazione permette ancora di controllare la loro presenza e aprire le pagine ufficiali. La verifica reale del profilo selezionato controlla la creazione dei documenti.

Windows: установка и подготовка

Запустите LuaBill-Setup-0.1.31-win64.exe на Windows 10 версии 1809 или новее либо Windows 11, x64. Python, PySide6 / Qt и Mustang уже включены. Программа устанавливается для текущего пользователя, обычно в %LOCALAPPDATA%\Programs\LuaBillDesktop. Ярлык рабочего стола можно включить по желанию; связь файлов .luabill изначально включена.

На последней странице оставьте отмеченным Подготовить компоненты для создания документов, чтобы открыть мастер. Он также доступен кнопкой под отчётом компонентов и отдельным ярлыком меню «Пуск».
В LuaBill выберите Справка → Подготовить создание документов. Выберите PDF, PDF + XML/XRechnung или ZUGFeRD и проверьте предложенный план.
Нажмите Подготовить выбранные компоненты для начала нужных загрузок и настройки. Само открытие окна ничего не скачивает. Нужен Интернет; некоторые внешние установщики могут запросить права администратора.
Подходящие установленные программы используются повторно. Если TeX отсутствует, предлагается Basic MiKTeX с нужными пакетами. Для XML нужна Java; для ZUGFeRD также Ghostscript. Для новой установки Java в Windows используется Temurin JRE 21.
Шрифты Noto загружаются как файлы для LuaBill без установки в системную папку шрифтов. Подготовка завершается созданием тестового документа. Нажмите Открыть тестовый PDF; при ошибке используйте Открыть папку журнала и Скопировать подробности.

Запуск только мастера: LuaBill.exe --setup-components --language ru. Тихая установка не запускает мастер и не устанавливает внешние компоненты.

Обновление, проекты и результаты

Закройте LuaBill и установите новую версию в ту же папку. Предварительное удаление не требуется. Проекты, PDF/XML и настройки сохраняются. Запускайте LuaBill из меню «Пуск», ярлыком или через .luabill. Откройте пример через Файл, сохраните собственный проект, затем используйте F7 для проверки сумм и F9 для создания документов. Храните проекты вне папки программы. Папка результатов относится к настройкам пользователя и не записывается в проект.

LaTeX, Java и Ghostscript остаются отдельными компонентами и не включены в пакет LuaBill. Окно Справка → Компоненты и установка сохраняет проверку наличия программ и официальные ссылки. Проверка выбранного профиля в мастере дополнительно проверяет реальное создание документа.

LaTeX-Pakete / LaTeX packages

LuaLaTeX; xcolor [table], fontspec, amsmath, fontawesome, babel (EN/DE/FR/IT/RU), csquotes, textcomp, geometry, tikz, fancyhdr, enumitem, hyperref [pdfa], soul, lastpage, textpos [absolute,overlay], luacode, ltablex, draftwatermark, eso-pic.

MiKTeX: Pakete über MiKTeX Console installieren. / Install packages using MiKTeX Console.

Source code and the build recipe are included in the application's source folder. The source project also supports macOS and Linux.