Lua-Konfiguration und eigene Änderungen
Welche Datei welche Aufgabe hat und wie Vorgaben, Zustand und Monitorgeometrie zusammenspielen.
Auf dieser Seite
Einstiegspunkt und Aufteilung
Der gemeinsame Hyprland-Einstieg führt in die Lua-Dateien unter ~/.config/hypr/lua/. Die bisherige Konfiguration wurde in getrennte Aufgabenbereiche überführt.
| Datei | Aufgabe |
|---|---|
init.lua | Lädt Plugins, Optionen, Regeln, Belegungen und Autostart. |
reference.lua | Gemeinsame portable Basis. |
state.lua | Aktueller Benutzerzustand aus den Einstellungen. |
host.lua | Optionale persönliche Overrides. |
geometry.lua | Abgeleitete Bildschirm- und Fenstergeometrie. |
bindings.lua | Tasten- und Mausbelegungen. |
Vorrang beachten
Die gemeinsame Basis wird durch Benutzerzustand ergänzt. Persönliche Optionen werden nur übernommen, soweit der Benutzerzustand sie nicht bereits setzt. Bei Fensterregeln folgen auf die Basis persönliche Regeln, Benutzerzustand und zuletzt berechnete Geometrie. Ein Eintrag in host.lua überschreibt daher nicht pauschal jede andere Quelle.
Eigene Änderungen nachvollziehbar halten
Nutze für unterstützte Optionen zunächst die Oberfläche. Sichere vor manuellen Änderungen die betroffenen Dateien. Lokal veränderter verwalteter Code wird bei einem Paketabgleich als Konflikt erhalten; du musst neue Projektänderungen dann selbst abgleichen.
Die Shortcut-Tabelle beschreibt die mitgelieferte Belegung. Eigene Änderungen in bindings.lua können davon abweichen.
Stand: 9. November 2026 · Diese Hilfe beschreibt Version 0.1.0-27. Einzelne Funktionen und Bezeichnungen können sich ändern.
← Weitere HilfethemenEin Problem melden →