Mango

Mango is a lightweight, modern Wayland compositor based on dwl. Mango provides features like animations, IPC, different layouts and visual effects.

Installation

As of August 2026, the mango module is not present by default in NixOS and Home Manager and needs to be imported using Flakes.

Here is an example flake:

❄︎ flake.nix

{
  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs?ref=nixos-unstable";
	mango = {
      url = "github:mangowm/mango";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = { self, nixpkgs, mango, ... } @ inputs: 
  {
	nixosConfigurations.HOSTNAME = nixpkgs.lib.nixosSystem {
	  specialArgs = { inherit inputs; };
	  modules = [ ./configuration.nix ];
	};
  };
}

Configuration

After adding the new input, mango can be configured using Home Manager:

❄︎ home.nix

{ config, pkgs, inputs, ... }:
{
  imports = [
    inputs.mango.hmModules.mango
  ];
  wayland.windowManager.mango= {
    enable = true;
    settings = {
      animations = 0;
      bordercolor="0x595959aa";
      bind = [
        "SUPER,r,reload_config"
        "SUPER,space,spawn,fuzzel"
        "SUPER,Return,spawn,foot"
      ];
    };
  };
}

Extra documentation can be found on the official website.