Marchyo is a declarative NixOS desktop: Hyprland, a Quickshell shell, a
matched theme and a curated set of apps, configured through marchyo.*
options in a single flake.
Read more at marchyo.org.
Start from the template:
nix flake init -t github:Jylhis/marchyo#workstationor add Marchyo as your only input:
{
inputs.marchyo.url = "github:Jylhis/marchyo";
outputs = { marchyo, ... }: {
nixosConfigurations.myhost = marchyo.lib.mkNixosSystem {
system = "x86_64-linux";
modules = [
./hardware-configuration.nix
{
marchyo.desktop.enable = true;
marchyo.users.me = { fullname = "Your Name"; email = "you@example.com"; };
}
];
};
};
}The manual lives in manual/, which is its authoritative source.
The Basics
- Getting Started
- Coming from Other Distros
- Navigation
- The Top Bar
- Themes
- Hotkeys
- The Marchyo CLI
- Default Apps
Configuration
The Rest
The full option reference is at marchyo.org/docs.
Contributors start at docs/ and AGENTS.md.
Marchyo is released under the MIT License.