Skip to main content
When marchyo.desktop.enable = true, the marchyo.defaults.* options control which applications are installed and registered as system defaults. Set any option to null to skip management for that category.

​
Options

OptionDefaultChoices
marchyo.defaults.browser"google-chrome""brave", "google-chrome", "firefox", "chromium"
marchyo.defaults.editor"jotain""emacs", "jotain", "vscode", "vscodium", "zed"
marchyo.defaults.terminalEditor"jotain""emacs", "jotain", "neovim", "helix", "nano"
marchyo.defaults.videoPlayer"mpv""mpv", "vlc", "celluloid"
marchyo.defaults.audioPlayer"mpv""mpv", "cmus", "vlc", "amberol"
marchyo.defaults.musicPlayer"spotify-player""spotify-player", "ncspot", "spotify"
marchyo.defaults.fileManager"nautilus""nautilus", "thunar"
marchyo.defaults.terminalFileManager"yazi""yazi", "ranger", "lf"
marchyo.defaults.imageEditor"pinta""pinta", "gimp", "krita"
marchyo.defaults.email"aerc""aerc", "neomutt", "gmail", "outlook"

​
Example

marchyo.defaults = {
  browser = "firefox";
  editor = "vscode";
  terminalEditor = "neovim";
  videoPlayer = "mpv";
  audioPlayer = "mpv";        # or "cmus" for a TUI library player
  musicPlayer = "spotify-player";  # TUI Spotify client (floating terminal)
  fileManager = "nautilus";
  terminalFileManager = "yazi";
  imageEditor = "gimp";
  email = "aerc";             # TUI mail client; requires account config
};

​
Skipping management

Set any option to null to prevent Marchyo from installing or configuring that category: 
marchyo.defaults = {
  browser = null;        # Don't manage browser
  musicPlayer = null;    # Don't install a music player
};

​
Externally managed applications

Some choices are “externally managed” — Marchyo does not install a package for them:
  • "gmail" and "outlook" (email) — Web applications opened in the default browser. No package is installed.

​
Jotain editor

"jotain" is the default editor and terminalEditor — Jylhis’s Emacs config, distributed as a flake. When selected, Marchyo enables its services.jotain Home-Manager module (installing the Emacs build, the jotain-editor/jotain-visual wrappers, and jotain-client.desktop) and sets $EDITOR/$VISUAL to those wrappers. Switch editor to "emacs"/"vscode"/… or terminalEditor to "emacs"/"neovim"/… to use a standard editor instead. The two selectors resolve independently, so you can mix (e.g. editor = "jotain" with terminalEditor = "neovim").
jotain is itself a full Emacs distribution, so it cannot share a home profile with another Emacs. Marchyo rejects (at evaluation) mixing "jotain" with "emacs" across the two selectors, and rejects marchyo.emacs.enable = true while either selector is "jotain" (both would run an Emacs daemon on the same socket). Use "jotain" for both selectors, or "emacs" for both — not one of each.
The TUI music (spotify-player, ncspot) and mail (aerc, neomutt) clients are installed but require account configuration before use. The music clients launch in a floating terminal under Hyprland (Super+M).

​
How defaults work

When a default is set, Marchyo:
  1. Installs the package (unless externally managed)
  2. Registers MIME type associations — e.g., setting browser = "firefox" registers Firefox as the handler for text/html, x-scheme-handler/http, etc.
  3. Sets environment variables — e.g., editor sets $VISUAL, terminalEditor sets $EDITOR
Last modified on July 9, 2026