> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jylhis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting & FAQ

> Common issues and questions for Marchyo systems

## 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](/guides/migration).
* **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](/configuration/dictation).
* **A key does nothing / I don't know the shortcut.** The full shipped bind set
  is on the [Keybindings](/usage/hotkeys) 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](/guides/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](/configuration/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](/configuration/default-apps).

**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](/usage/updating).