Glazewm Config Editor

Visual editor for GlazeWM window manager config

#config-editor #glazewm #svelte #tauri #tiling-wm #windows

Download

GlazeWM Config Editor

A desktop GUI for editing GlazeWM YAML configuration files — no more hand-crafting YAML.

📋 Table of Contents

💡 Why this editor?
⬇️ Download
✨ Features
📸 Screenshots
📦 Installation
🚀 Usage
🛠️ Tech Stack
🧑‍💻 Development
🗂️ Project Structure
🗺️ Roadmap
❓ FAQ
🤝 Contributing
🔒 Security
📄 License
🙏 Acknowledgements

💡 Why this editor?

GlazeWM is configured entirely through a YAML file. That's powerful — but it also means you need to know the exact key names, allowed values, and nesting rules before you can change anything. One typo silently breaks your window manager.

GlazeWM Config Editor puts a form-based GUI in front of that file so you can tweak gaps, keybindings, workspace assignments, and window rules without ever touching raw YAML. It validates your changes inline, previews the resulting YAML in real time, and backs up your current config before every save.

Available since v0.1.0 · Built with Tauri 2 + SvelteKit + Rust.

⬇️ Download

macOS note: Builds are currently unsigned (no Apple Developer certificate). On first launch, right-click the app → Open to bypass Gatekeeper, or run:
xattr -d com.apple.quarantine /Applications/GlazeWM\ Editor.app

✨ Features

Feature	Details
General settings editor	Visual controls for `general`, `gaps`, and behaviour flags
Window effects editor	Configure border colours, opacity, and focus effects for tiled and floating windows
Layout settings	Adjust tiling layout and window sizing behaviour
Keybinding editor	Full keybinding UI with real-time conflict detection
Workspace & monitor config	Assign workspaces to monitors, set display names and keep-alive; drag-to-reorder rows
Window rule builder	Match by process, title, or class; live window picker overlay (click any open window to capture its properties); live search highlighting
Raw YAML editor	Full CodeMirror editor with one-dark theme for direct YAML editing
Live YAML preview	Preview pane stays in sync with every form change
Live mode	Auto-saves and reloads the GlazeWM config on every field blur
Read / edit mode toggle	Clean review mode on all major sections
In-app updater	Notified of new releases; installs without leaving the app (passive install on Windows)
Automatic backups	Previous config is backed up alongside the file on every save
i18n support	UI available in English, Portuguese (BR), German, Spanish, French, Italian, and Chinese
Native menu bar	File, Edit, View, and Help menus with an About dialog showing the app version

📸 Screenshots

No screenshots have been captured yet. To contribute: run deno task tauri dev, resize the window to 1280 × 800 px, and capture each panel listed below. Place images in docs/screenshots/ and open a pull request.

General settings & gaps panel

Keybinding editor with conflict detection

Window rule builder

Raw YAML editor

📦 Installation

🧹 Scoop (recommended for Windows)

scoop bucket add glazewm-config-editor https://github.com/eduardohilariodev/scoop-glazewm-config-editor
scoop install glazewm-config-editor

🪟 Winget

# Coming soon
winget install eduardohilariodev.GlazeWMConfigEditor

📥 Manual

Download the latest installer from the Releases page and run it. Windows ships an NSIS .exe installer, an MSI package, and a portable .zip (no installation required); use whichever fits your deployment. macOS ships as a .dmg disk image.

💼 Portable (Windows)

Grab the glazewm-editor-<version>-x64-portable.zip asset from the Releases page, extract it anywhere, and run glazewm-editor.exe — no installation or admin rights needed. Settings and state are stored in %APPDATA%\com.glazewm.editor.

🚀 Usage

Launch GlazeWM Config Editor from the Start menu or Applications folder.
Open your config file — the default path is:
- Windows: %UserProfile%\.glzr\glazewm\config.yaml
Edit settings through the UI; watch the YAML preview update as you go.
Save. The previous file is backed up automatically next to the config.

GlazeWM picks up changes the next time it reloads its configuration.

🛠️ Tech Stack

Layer	Technology
Frontend	SvelteKit 2 · Svelte 5 · TypeScript 6 · Tailwind CSS v4
Desktop runtime	Tauri 2
Backend / native	Rust (stable)
Runtime / tasks	Deno v2+
Package management	Deno + npm interop
CI	GitHub Actions

🧑‍💻 Development

📋 Prerequisites

Tool	Minimum version	Install
Rust (stable)	`rustup show`	rustup.rs
Deno	v2.0	deno.com
Tauri v2 prerequisites	—	v2.tauri.app/start/prerequisites

Windows: You also need the Visual C++ Build Tools and WebView2 (pre-installed on Windows 10/11).

⚙️ Setup

# Install dependencies (including git hooks via Husky)
deno install --allow-scripts=npm:husky

🔧 Common tasks

deno task tauri dev      # Run the desktop app in watch/dev mode
deno task tauri build    # Produce a release bundle
deno task check          # Type-check + lint the frontend
deno fmt                 # Format all source files
deno lint                # Lint TypeScript/Svelte sources

Before pushing, also run the Rust checks:

cargo fmt --manifest-path src-tauri/Cargo.toml
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings

Or via VS Code: Terminal → Run Task (dev / build), or Ctrl+Shift+B for build.

🧪 Running tests

No automated test suite exists yet. Contributions that add tests are welcome.

Frontend: add *.test.ts / *.spec.ts files alongside components and run with deno task test (Vitest, once configured).
Rust: add #[test] blocks inside src-tauri/src/ and run with cargo test --manifest-path src-tauri/Cargo.toml.

🗂️ Project Structure

.
├── src/                        # SvelteKit frontend (TypeScript, Tailwind v4)
│   ├── app/
│   │   └── App.svelte          # Root application component
│   ├── features/               # Feature panels (one directory per tab)
│   │   ├── effects/            # Window effects editor
│   │   ├── gaps/               # Gap settings editor
│   │   ├── general/            # General settings editor
│   │   ├── keybindings/        # Keybinding editor with conflict detection
│   │   ├── layout/             # Layout settings editor
│   │   ├── raw-yaml/           # CodeMirror YAML editor
│   │   ├── rules/              # Window rule builder
│   │   ├── settings/           # App settings (language, live mode, …)
│   │   └── workspaces/         # Workspace & monitor config
│   ├── routes/
│   │   ├── +layout.svelte      # Shell with menu bar and tab nav
│   │   ├── +page.svelte        # Main editor page
│   │   └── picker/             # Transparent window-picker overlay
│   └── shared/                 # Cross-cutting utilities
│       ├── i18n/               # Internationalisation (en, pt-BR, de, es, fr, it, zh)
│       ├── store/              # Svelte stores (config state, UI state)
│       ├── tauri/              # Typed wrappers around Tauri commands
│       ├── types/              # Shared TypeScript types
│       ├── ui/                 # Reusable UI components
│       ├── utils/              # Helper functions
│       └── yaml/               # YAML serialisation / deserialisation
├── src-tauri/                  # Rust backend (Tauri 2)
│   └── src/
│       ├── commands/
│       │   ├── config.rs       # read_config, write_config, default_config_path,
│       │   │                   # path_exists, validate_regex, reload_glazewm, get_mtime
│       │   ├── shell.rs        # open_with_default, reveal_in_explorer
│       │   └── window_picker.rs# start_window_pick
│       ├── services/           # Business logic (config I/O, process, validation)
│       ├── error.rs            # Unified AppError type
│       └── lib.rs              # Tauri builder & command registration
├── static/                     # Static assets served by SvelteKit
├── scripts/                    # Helper scripts
├── deno.json                   # Deno tasks and compiler config
└── package.json                # Node-side dependencies

🗺️ Roadmap

🪟 Winget publish (winget install eduardohilariodev.GlazeWMConfigEditor)
🐧 Linux support (once GlazeWM supports Linux)
🔍 Config diff viewer (before/after on save)
📁 Multiple config profile support
🧪 Automated test suite (Vitest + Rust unit tests)

Have a feature request? Open an issue.

❓ FAQ

Q: Does this modify GlazeWM itself?
No. The editor only reads and writes your config.yaml. GlazeWM must be installed and running separately.

Q: Where is my config backed up?
A timestamped copy (e.g. config.yaml.2024-06-01T12-00-00.bak) is placed in the same directory as your config file before every save.

Q: The app says my config is invalid — what do I do?
Open the file in a text editor and compare it against the GlazeWM config documentation. The inline validation messages in the editor indicate the exact field and the expected value type.

Q: Why is macOS unsigned?
Code-signing for macOS requires an Apple Developer account ($99/yr). The .dmg is safe to run; follow the Gatekeeper bypass instructions in the Download section.

Q: Which GlazeWM versions are supported?
GlazeWM v3.x is fully supported. Older versions may work but are not actively tested.

Q: Is there a portable (no-install) version?
Yes. Grab the glazewm-editor-<version>-x64-portable.zip asset from the Releases page, extract it, and run glazewm-editor.exe directly. No installation or admin rights required. Use Scoop for an equivalent no-UAC, auto-updating experience.

🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md before opening a pull request.

Key points:

Bugs → open an issue with reproduction steps.
Features → open an issue first to discuss before writing code.
PRs → create a branch from main (git checkout -b feat/short-description); keep commits focused and follow Conventional Commits style (feat:, fix:, docs:, etc.).
No CLA is required.

🔒 Security

To report a vulnerability, follow the process in SECURITY.md.

📄 License

Released under the MIT License.

🙏 Acknowledgements

GlazeWM — the tiling window manager this editor targets.
Tauri — the desktop application framework.
SvelteKit — the frontend framework.
Deno — runtime and task runner.
js-yaml — YAML parsing and serialisation.
CodeMirror 6 — raw YAML editor with one-dark theme.
Phosphor Icons (phosphor-svelte) — icon set used throughout the UI.
country-flag-icons — flag emoji in the language picker.

Top categories

tailwind daisyui admin template popup mdsvex portfolio blog form ecommerce ui carousel auth dark seo image routing