What is hyprconf2lua?

Hyprland is a tiling window manager for Linux, and version 0.55 changed how it reads its configuration file. The old format (hyprlang) is being dropped, replaced by Lua, which is a small scripting language. If you have an existing Hyprland setup, your config file will eventually stop working unless you convert it. This tool automates that conversion. You point it at your old hyprland.conf file, it reads through all your settings, keybinds, window rules, monitor configurations, and startup programs, and writes out an equivalent Lua file. The project claims about 97% of a standard config converts cleanly without any manual editing. The remaining few percent, things like plugin-specific settings that require plugin-specific Lua APIs, get marked with a comment saying TODO so you know exactly where to look. Installation is straightforward: you can run pip install hyprconf2lua and then call it from the command line, or you can clone the repository and run it directly with Python without installing anything at all. There is also a check mode for automated setups, where the tool exits with a specific code if anything in your config needs manual attention, which makes it usable in scripts or git hooks. The tool handles a wide range of Hyprland features: key bindings including all the bind variants, window rules with regex matching, autostart commands, environment variables, animations, device sections, gestures, and workspace rules. Nested config sections and variable references are also converted. The author wrote it after Hyprland 0.55 broke the configs of existing users who needed a working migration path. The codebase is around 400 lines of Python and is MIT licensed. A similar converter written in Go exists, but this one requires no compile step and handles more edge cases according to the project's own comparison.