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.
- 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.
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.
For manual setup, ensure you have Rust (wasm32 target), wasm-pack, Elm, Node.js, and pnpm.
| 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 |
src/: Elm source files.parser/: Rust parser source.flake.nix: Nix development environment.justfile: Project task definitions.
- Frontend: Elm
- Parser: Rust (WASM)
- Styling: Tailwind CSS
- Build: Vite
- Tasks: Just
- Environment: Nix (optional)