Visu: Niri Keymap Visualizer

Visu is a tool for visualizing keyboard shortcuts for the niri window manager. It parses your config.kdl and displays an interactive keyboard layout to browse configured bindings.

Features

• Interactive Layout: Physical keyboard visualization with modifier highlighting.
• Search: Filter bindings by action or key name.
• Binding Details: View specific actions and configuration options (e.g. hotkey-overlay-title).
• Views: Toggle between physical keyboard and list view modes.
• Parser: Rust-based KDL parser compiled to WebAssembly.

Getting Started

Development

If you have Nix installed:

• Clone the repository.
• Run nix develop.
• Run just install.
• Run just dev.
• In a separate terminal, run just watch-rust.

Commands

| Command | Description | | :--- | :--- | | just install | Install dependencies | | just dev | Start development server | | just watch-rust | Rebuild WASM on changes | | just build | Production build | | just test | Run tests | | just fmt | Format source code |

Project Structure

• src/: Elm source files.
• parser/: Rust parser source.
• flake.nix: Nix development environment.
• justfile: Project task definitions.

Technical Stack

• Frontend: Elm
• Parser: Rust (WASM)
• Styling: Tailwind CSS
• Build: Vite
• Tasks: Just
• Environment: Nix (optional)