HyprLS

A LSP server for Hyprland configuration files.

Features

Not checked means planned / work in progress.

• [x] Auto-complete
• [x] Hover
  • [ ] TODO: Documentation on hover of categories?
• [x] Go to definition
• [x] Color pickers
• [x] Document symbols
• [ ] Diagnostics
• [ ] Formatting
• [ ] Semantic highlighting

Installation

With go install

go install github.com/ewen-lbh/hyprls/cmd/hyprls@latest

From source

• Required: Just (paru -S just on Arch Linux (btw))

git clone --recurse-submodules https://github.com/ewen-lbh/hyprls
cd hyprls
# installs the binary to ~/.local/bin. 
# Make sure that directory exists and is in your PATH
just install 

Usage

With Neovim

Combine with The tree-sitter grammar for Hyprlang for syntax highlighting.

Add this to your init.lua:

-- Hyprlang LSP
vim.api.nvim_create_autocmd({'BufEnter', 'BufWinEnter'}, {
        pattern = {"*.hl", "hypr*.conf"},
        callback = function(event)
                print(string.format("starting hyprls for %s", vim.inspect(event)))
                vim.lsp.start {
                        name = "hyprlang",
                        cmd = {"hyprls"},
                        root_dir = vim.fn.getcwd(),
                }
        end
})

VSCode

Official Marketplace (VisualStudio Marketplace)

Install it from the marketplace.

[!TIP] You can use the Hyprland extension pack to also get syntax highlighting.

Open VSX (for VSCodium & others)

Install it on OpenVSX