Troubleshooting & FAQ

Build & evaluation failures

• nixos-rebuild fails on a marchyo.inputMethod.* option. Those options were removed and now fail the build on purpose. Migrate to marchyo.keyboard.layouts — see the Migration guide.
• Formatting / lint errors in CI. Run just fmt (nixfmt, deadnix, statix, shellcheck, yamlfmt) before committing; CI enforces it.
• Check your config quickly without a full build. just check (or nix flake check) runs the fast evaluation-only test suite — it catches most option and module mistakes in seconds.

Desktop issues

• Dictation isn’t typing. Confirm marchyo.dictation.enable is set, that the daemon is up (systemctl --user status voxtype), and — for the F9 push-to-talk hotkey — that your user is in the input group (added automatically when pushToTalk.enable is on). See Dictation.
• A key does nothing / I don’t know the shortcut. The full shipped bind set is on the Keybindings page; the source of truth is spread across several modules/home/ files — most binds live in hyprland.nix, the rest in screenshot.nix, omarchy-binds.nix, menus.nix, utilities.nix, window-toggles.nix, keybindings-cheatsheet.nix, and webapps.nix.
• Display scaling / monitor layout is wrong. Override wayland.windowManager.hyprland.settings.monitor in your home config (the workstation template shows the pattern); the bundled hyprmon tool helps position monitors.
• Theme isn’t applied. Make sure marchyo.theme.enable = true. Marchyo themes several surfaces directly from the Jylhis design tokens; see Theming.

FAQ

How does Marchyo relate to Omarchy? Omarchy is DHH’s Arch + Hyprland distribution. Marchyo brings the same kind of opinionated Hyprland desktop to NixOS, but it is an independent, batteries- included Nix flake rather than an Arch install — you get it declaratively via marchyo.lib.mkNixosSystem. It is distinct from the community omarchy-nix port; Marchyo is its own configuration and toolset.

How do I change a default app? Set the relevant marchyo.defaults.* option (browser, editor, file manager, music player, email, etc.), or null to stop managing that category. The terminal itself isn’t a defaults category — it is always Ghostty. See Default Applications.

Where does my configuration live? Everything is declarative. You do not hand-edit files under ~/.config; those are generated by Home Manager from your Nix config. To change behaviour, set a marchyo.* option or override the underlying Home Manager module, then rebuild.

How do I undo a bad update? Roll back to the previous generation — see Updating & Rollback.