Hyprland Just Leveled Up: The LUA Configuration Guide 🛠️

Added: 2026-05-11

[00:00:00]Hello everyone and welcome back to my channel. In this video I will show you the new way to configure Hyperland and you see it here in the blog post. It's based on Lua the programming language.

[00:00:13]Lure is now the way how to configure Hyperland and this has been announced and when I scroll down you see that um a lot of changes are coming with that. So this will have an effect on all hyperland users and hyperland developers and hyperland module developers or other applications that are intended to work on hyperland for example way for example NWG doc hyperland and so on. So everyone needs to implement the new configuration of Hyperlind. And um here is announced that um the old way to configure Hyperland will continue to be supported for the next one or two releases and you know how fast Hyperland development cycles are. That's why I really would suggest that you learn the new way to configure hyperlink and that of course also affect me because um my Linux for work OS um is heavily based on the old way to configure hyperland and I also have to switch to the new way with Lua. When I scroll down here on my repository, there is a new branch lure migration and here I have started to develop um the newer configuration of my L for work OS. When you click here on dot files config and then select hyper and you scroll down you see that every file nearly every file is available in a conf version. So the legacy way and the new way Lua and in this video I will share some first insights about the upcoming implementation of the Lua Hyperland setup for my Linux for work OS. This is Visual Studio Code and in the split screen I want to show you the on the left side the new Lua based configuration and on the right side the legacy configuration with confiles.

[00:02:24]A very good practice is always to separate complex configurations into separate files. And this is also possible with Lua. On the old side, you see with the command source, I could refer and load another configuration file. In Lua, you need to use the word require require monitors.

[00:02:48]And you see here the monitors.la.

[00:02:51]And when I write require monitors, the monitors.la file will be loaded. And you see every file has a lure file ending.

[00:03:00]When a lure file for hyperlend, the hyperlink.la file exists, hyperlend will use the new way for configuration. If this is not there, hyperland will use the old way for the configuration. I open the monitors.lure lure and in parallel I load an old configuration and you see already the new syntax. So this is how to define the new monitor section. The mode is preferred output you define the preferred monitor output the position auto and scale can be defined like that.

[00:03:44]So this is the new way the new syntax of Lua. The next is the input section. You see there are kind of similar there are details where you have to take care of.

[00:03:55]So hyperland.config and the section input is the way to define the keyboard configuration and uh the touchpads. But overall it looks very familiar. It's just a new syntax that you have to learn for lure.

[00:04:12]Let's jump back here to the auto start conf.

[00:04:18]When you combine uh the configuration file with a folder, you have to use the dot to jump into the folder conf and then load the file auto start. So let's open the auto start file and the auto start conf.

[00:04:38]Also here you see the new syntax with hyperlend on on hyperlend.st start. This is the hook that will be loaded here and the listener and then the following commands will be executed.

[00:04:54]Um I load for example the um bibbata morang cursor theme or I run the listeners.sh file. You see here how it was defined in with the legacy configuration with hyperland.xec command you execute a shell script or an application. The next is colors and you see the how the colors are defined is just a a variable definition with the RGBA color code and this is then also how you have to create a template for example in Moto Genen to generate the colors automatically based on your wallpaper. then go back to the hyperlind lure again because next I want to show you the decoration part and how this can be set up with um decoration variations in the new way. So I go to conf and open decoration lure and you see again in this file is a reference to conf.decorations.default and I open here the folder conf.deor decorations.default and this is then the file that will be loaded to um define the window decorations and the routings. For example, active opacity, inactive opacity, full screen opacity, similar to the old way. Here is the old way. Yeah, there was a different syntax, but overall the properties that you have to set are nearly the same. Yeah, I think you see already it's worth to look into the documentation and what I can tell you is that it's very well documented.

[00:06:48]So when we go here to get started then we enter the manual from the latest git version which is from 0.55 in configuration start. You see here already that looking for the old hyperlang syntax you can here go back to the old wiki pages but since hyperland 0.55 hyperlang is deprecated in favor of lua and this is here how it generally works and you can also find here an example configuration yeah where you have all important commands in one file not separated into subfiles.

[00:07:39]where for example can also load and set variables. The auto start is here. Here you can see how to set environment variables. Gaps in gaps out the decoration part. And here is the animation part. I'm still working on that for my Linux work OS. What I want to show you when I scroll down are the key bindings. because also here it's a new syntax. Here's a general local definition of the variable main mod with super which is the Windows key. And then you see the syntax with HL.bind.

[00:08:22]Main mod means super plus the Q key and then you execute a command. Yeah.

[00:08:30]Hiberland.dsp.x X command terminal and terminal is a variable that has been set here on top.

[00:08:42]Here it is. Here is terminal. But you can of course also enter the launch command directly. Here are ways how to move the focus. Here are the key bindings to switch between the workspaces. It's new but if you are familiar with configuring hyperland in the hyperland.com you will learn this very fast and lua is now a programming language. I expect here a lot of smart and new configurations coming up in the next months or so from many developers outside. So as I said I am working already on the new lure configuration.

[00:09:28]This will take a bit more time. Of course, I will also take the opportunity to clean up a bit, but you will find the link to that branch in the video description, and then you can follow my development. And I'm happy to hear your recommendations and ideas for the upcoming version of my Linux for OS based on Lure.