Skip to main content

​
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 modules/home/hyprland.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, terminal, file manager, etc.), or null to stop managing that category. 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.
Last modified on July 18, 2026