A native control plane for Hyprland

Steer your desktop.
Keep your config.

One clear place to inspect and change your Hyprland setup—with verified transactions, exact rollback, and zero interest in replacing your dotfiles.

Download for Arch View source

MPL-2.0
No daemon
No telemetry

HHelm

YOUR DESKTOP

Everything on course.

Synced

8/ 8

Supported components ready

Helm audited this session without changing configuration.

◐APPEARANCENord CurrentApplied safely

▤DISPLAY2560 × 1440144 Hz · Scale 1×

⌨KEYBINDINGS24 activeNo conflicts

↺LAST CHANGETheme updatedRollback available

✓

TRANSACTIONVerified & saved

↺

SAFETY NETExact rollback ready

Built for the tools already on your desktop

HyprlandAlacrittyYaziWaybarQuickshellhyprpaper

One helm, the whole desktop

Settings without the scattered files.

Common controls stay approachable. Exact paths, ownership, capabilities, and effects remain visible when you need them.

Immediate, verified changes

Every edit moves through validation, application, runtime verification, and durable history. Success means the persisted and effective state agree.

Plan ✓Write ✓Reload ✓Verify ●

↺

History that can undo

Restore exact bytes without erasing the record. Every undo is a new, attributable transaction.

⌁

Cooperative by design

Owned fragments and lossless targeted edits keep comments, ordering, and unknown syntax intact.

⌘

GUI first. CLI equal.

Use the native GTK interface day to day, or the versioned JSON CLI for scripts and repeatable profiles.

Safety is the architecture

Your configuration stays yours.

Helm is deliberately local, user-scoped, and conservative. It refuses ambiguous changes instead of guessing.

✓
Conflict-aware writesExternal edits are detected before anything is replaced.
✓
Byte-identical rollbackA failed verification restores every touched target.
✓
Sandboxed pluginsBubblewrap isolates extensions with no network or home access.
✓
Private, local stateNo account, telemetry, root helper, or background service.

Read the safety model

helm-settings — transaction

$ helm-settings profiles apply work.json

01  Resolving targets          done
02  Comparing fingerprints    done
03  Staging exact snapshots   done
04  Reloading Hyprland        done
05  Verifying effective state done

● Applied profile “Work”
  Transaction 19af-helm-01
  Rollback checkpoint retained

Native integrations

Bring the desktop together.

Curated adapters understand each tool's real configuration format and ownership boundary.

Hyprland

Lua settings, displays, bindings, and rules

Alacritty

Lossless TOML theme imports

Yazi

Installed flavor discovery and selection

Waybar

Managed JSONC and CSS layouts

Quickshell

Cooperative named shell configuration

hyprpaper

Validated per-output wallpapers

Using a legacy hyprland.conf? Helm keeps it read-only. Follow the official Hyprland migration guide .

Helm 0.1.0

Ready to take the helm?

Built for Arch Linux on x86-64 with Hyprland 0.56.2 or newer.

sudo pacman -S helm-settings

One-time repository setup

Import and locally trust the published release key:

curl -LO https://helm-settings.vercel.app/helm-release-signing-key.asc
sudo pacman-key --add helm-release-signing-key.asc
sudo pacman-key --lsign-key F65AE51D27C02E4B

Add this repository to /etc/pacman.conf, then run a full system refresh:

[helm]
SigLevel = Required DatabaseOptional
Server = https://helm-settings.vercel.app/repo/$arch

sudo pacman -Syu

ARCH LINUX · X86-64

helm-settings 0.1.0

Native package · signed checksums

Set up repository

Source archive Checksums Signing key

Steer your desktop.Keep your config.