Configuration

zlaunch is configured via a TOML file:

~/.config/zlaunch/config.toml

Create this file if it doesn't exist. All settings are optional with sensible defaults.

Example Configuration

theme = "one-dark"
launcher_size = [800.0, 500.0]
enable_backdrop = true
enable_transparency = true
hyprland_auto_blur = true

default_modes = ["combined", "emojis", "clipboard"]
combined_modules = ["calculator", "windows", "applications", "actions"]

[fuzzy_match]
show_best_match = true

[[search_providers]]
name = "GitHub"
trigger = "!gh"
url = "https://github.com/search?q={query}"

Reloading

Configuration is automatically watched for changes. For a full reload, run zlaunch reload.

zlaunch can be declaratively configured in Nix using Home Manager using the settings attribute. The written Nix configuration is directly translated to TOML, so the same settings are used with a minimum adaptation for Nix syntax.

{
  services.zlaunch = {
    enable = true;

    settings = {
      theme = "one-dark";
      launcher_size = [ 800.0 500.0 ];
      enable_backdrop = true;
      enable_transparency = true;
      hyprland_auto_blur = true;

      default_modes = ["combined" "emojis" "clipboard"];
      combined_modules = ["calculator" "windows" "applications" "actions"];

      fuzzy_match = {
        show_best_match = true;
      };

      search_providers = [
        {
          name = "GitHub";
          trigger = "!gh";
          url = "https://github.com/search?q={query}";
        }
      ];
    };
  };
}