Prateek-squadron

Prateek-squadron / hyprconf2lua

Public

Convert Hyprland .conf to Lua for v0.55+ — drop-in replacement for deprecated hyprlang. ~97% auto-conversion, 0% guesswork.

19
0
89% credibility
Found May 26, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

hyprconf2lua is a migration tool that automatically converts Hyprland configuration files from the old text-based format to the new Lua scripting format required by Hyprland 0.55 and later. It handles about 97% of settings automatically, flagging the remaining 3% (mostly plugin configurations and special cases) with clear markers so users know exactly what to review manually. The tool is designed to make the format transition painless for everyday Hyprland users who don't want to manually rewrite their entire configuration.

How It Works

1
🔧 Your window manager needs an upgrade

You love using Hyprland, but just learned that the latest version changed how your settings work. Your old configuration file won't work anymore.

2
🔍 Finding the migration tool

You search online and discover hyprconf2lua — a tool that automatically translates your old settings into the new format.

3
⚡ Converting your settings in one click

You point the tool at your configuration file and watch it transform everything into the new format automatically.

4
📋 Checking what needs attention

The tool shows you exactly which settings need a quick manual review — usually just a handful of special cases like plugins.

5
Different paths for different users
📁
Multiple config files

If you have several config files that work together, the tool can convert all of them at once.

✅
Single config file

If you only have one main config file, you can move on to testing right away.

6
🎉 Everything works perfectly

You restart your window manager and all your settings, keybinds, and customizations work exactly as before — just in the new format.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 19 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is hyprconf2lua?

Hyprconf2lua is a Python converter that transforms your existing Hyprland `.conf` configuration files into the new Lua format required by Hyprland 0.55 and later. The old hyprlang format is being deprecated, so this tool handles the migration automatically. You run a single command, point it at your config file, and get a ready-to-use `.lua` file. Anything that can't be auto-converted gets flagged with `-- TODO` comments so you know exactly what needs manual attention.

Why is it gaining traction?

The hook is simple: Hyprland 0.55 broke everyone's setup, and rewriting configs by hand is painful. This tool handles ~97% of standard configs automatically, including keybinds, monitors, window rules, animations, and nested sections. It runs without a compile step—just `pip install` or even plain `python3 -m`. The `--check` mode exits with code 3 if anything needs review, making it CI-friendly for automated pipelines. Compared to the Go alternative, it has better coverage for complex setups and a lower barrier to contribution.

Who should use this?

Hyprland users currently on versions below 0.55 who plan to upgrade. If you have a mature config with dozens of binds, window rules, and sourced files, this saves hours of manual work. Plugin users should note that `plugin { }` blocks still need manual handling since plugin APIs vary. The tool works best for standard desktop setups—Omarchy-style configs are supported but may dip closer to 90% coverage.

Verdict

This is the migration path for Hyprland users who want automation over manual rewrites. With a 0.899% credibility score and only 19 stars, it's early-stage and community-dependent—but the Python codebase is approachable and the coverage claims are backed by a detailed feature table. Back up your config, run the converter, and review the TODOs. For most users, this is faster than starting from scratch.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.