Complete Guide to Configuring Hyprland 0.55 with Lua

Introduction to Hyprland 0.55

Hyprland 0.55 represents one of the most significant updates to the Wayland compositor, introducing numerous advanced features and technical improvements. This update is particularly useful for advanced users and developers seeking more granular and customizable control over their desktop environment. Among the most notable new features are Lua-based configuration, user-defined layouts, ICC profiles for outputs, improvements in scrolling management, and changes in rendering and color management.

Why It's Useful

• Lua-based Configuration: Allows greater flexibility and power in customizing the desktop environment.
• Layout API: Enables the definition of custom window layouts, applicable globally, per workspace, or per monitor.
• Improved Scrolling: Integrates full-screen windows into scrolling and introduces native gestures for trackpads.
• ICC Profile for Output: Supports color profile management for each display, improving color accuracy.
• Advanced Color Management: Uses FP16 precision and improved color management pipelines for an optimized visual experience.
• New Window Management Features: Includes tags for devices, advanced layout options, and new window decorations.

Who It's For

This update is primarily aimed at technical users, developers, and power users who want more detailed and customized control over their Wayland desktop environment. Users who use Hyprland for professional purposes or who need advanced window and color management will find the new features particularly useful.

Prerequisites

• Hardware: A system compatible with Wayland
• Software: Hyprland version 0.55
• Software: Lua for configuration
• Software: ICC profile for color management (optional)

Procedure: Migrating to Lua Configuration in Hyprland 0.55

By the end of this guide, you will have configured Hyprland 0.55 using the new Lua format, leveraging the new features of custom layouts and improvements in color management.

• Step 1: Backup of the Existing Configuration
• Step 2: Consulting the Documentation
• Step 3: Creating the Lua Configuration File
• Step 4: Defining Custom Layouts

  Use the new Layout API to define custom layouts directly in the Lua configuration file. Example:

   return { -- Definition of a custom layout layouts = { mylayout = { -- Layout configuration } } } 

• Step 5: Configuring ICC Profiles for Each Monitor

  Add the configuration for ICC profiles for each output (monitor) using the icc option in the Lua file. Example:

   return { -- ICC profile configuration icc = { ["DP-1"] = "/path/to/icc/profile1.icc", ["HDMI-1"] = "/path/to/icc/profile2.icc" } } 

• Step 6: Configuring Scrolling Options

  Configure the new scrolling options such as scrollmove, expel, consume, and consumeorexpel in the Lua file. Example:

   return { -- Scrolling options configuration scrollmove = true, binds = { { key = "SUPER+Shift+Up", command = "expel" } } } 

• Step 7: Verification and Launch of Hyprland
• Step 8: Troubleshooting

Verification and Troubleshooting

By the end of this guide, you will be able to test the correct functioning of Hyprland 0.55 and resolve any configuration issues.

Functionality Test

• Verification of Lua Configuration: Start Hyprland with the new Lua configuration. If the startup is successful without errors, the configuration is correct.
• Testing Custom Layouts: Apply a custom layout to a specific workspace or monitor. Verify that the windows are arranged as expected.
• Testing Scrolling: Open a full-screen window and verify that scrolling works correctly. Also try trackpad gestures if available.
• Testing ICC Profiles: Load an ICC profile for each display using the configuration. Verify that colors are managed correctly on each monitor.
• Testing New Window Management Features: Try the new options such as confinepointer, moveintoorcreate_group and rotatesplit. Verify that they behave as expected.

Troubleshooting

• Lua Configuration Errors: If Hyprland does not start correctly, check the Lua configuration file for syntax errors. Use the traditional configuration file as a reference.
• Non-Functioning Layouts: If custom layouts do not work, verify that they are defined correctly in the configuration. Also check for conflicts with other layouts.
• Scrolling Issues: If scrolling does not work, verify that the scrolling options are configured correctly. Also check that full-screen windows are included in the scrolling tape.
• Color Management Issues: If colors are not managed correctly, verify that ICC profiles are loaded correctly. Also check that FP16 precision is enabled.

For more details, consult the Hyprland wiki or the changelog on GitHub.

By the end of this guide, you will have understood the main new features introduced by Hyprland 0.55 and how to leverage them to improve your experience with this Wayland compositor.

Educational Summary

• Lua Configurations: Hyprland 0.55 introduces Lua-based configurations, offering greater flexibility and control.
• ICC Profiles: Color profile management for each display with the setting icc = "path".
• Color Management: FP16 precision and improved pipelines for more accurate color management.
• New Features: Device tags, confinepointer, moveintoorcreate_group, rotatesplit, live pinch cursor zoom, and glow window decoration.
• Breaking Changes: Removal of some options and relocation of others to optimize performance.

Call to Practice

Explore the new features of Hyprland 0.55 and experiment with Lua configurations to best customize your work environment. For more details, consult the official guide, the announcement, or the changelog on GitHub.