This project's development is based on dwl.

1. Lightweight & Fast Build

   • Mango is as lightweight as dwl, and can be built completely within a few seconds. Despite this, Mango does not compromise on functionality.

2. Feature Highlights

   • In addition to basic WM functionality, Mango provides:
     • Excellent xwayland support.
     • Base tags not workspaces (supports separate window layouts for each tag)
     • Smooth and customizable complete animations (window open/move/close, tag enter/leave,layer open/close/move)
     • Excellent input method support (text input v2/v3)
     • Flexible window layouts with easy switching (scroller, master-stack, monocle,center-master, etc.)
     • Rich window states (swallow, minimize, maximize, unglobal, global, fakefullscreen, overlay, etc.)
     • Simple yet powerful external configuration(support shortcuts hot-reload)
     • Sway-like scratchpad and named scratchpad
     • Ipc support(get/send message from/to compositor by external program)
     • Hycov-like overview
     • Window effects from scenefx (blur, shadow, corner radius, opacity)

Master-Stack Layout

Scroller Layout

Layer animation

mangowc

• tile
• scroller
• monocle
• grid
• deck
• center_tile
• vertical_tile
• vertical_grid
• vertical_scroller

• glibc
• wayland
• wayland-protocols
• libinput
• libdrm
• libxkbcommon
• pixman
• git
• meson
• ninja
• libdisplay-info
• libliftoff
• hwdata
• seatd
• pcre2
• xorg-xwayland
• libxcb

The package is in the Arch User Repository and is availble for manual download here or through a AUR helper like yay:

yay -S mangowc-git

The package is in the community-maintained repository called GURU. First, add GURU repository:

emerge --ask --verbose eselect-repository
eselect repository enable guru
emerge --sync guru

Then, add gui-libs/scenefx and gui-wm/mangowc to the package.accept_keywords.

Finally, install the package:

emerge --ask --verbose gui-wm/mangowc

The package is in the third-party Terra repository. First, add the Terra Repository.

Then, install the package:

dnf install mangowc

git clone -b 0.19.2 https://gitlab.freedesktop.org/wlroots/wlroots.git
cd wlroots
meson build -Dprefix=/usr
sudo ninja -C build install

git clone -b 0.4.1 https://github.com/wlrfx/scenefx.git
cd scenefx
meson build -Dprefix=/usr
sudo ninja -C build install

git clone https://github.com/DreamMaoMao/mangowc.git
cd mangowc
meson build -Dprefix=/usr
sudo ninja -C build install

• dms-shell

• Application launcher (rofi, bemenu, wmenu, fuzzel)
• Terminal emulator (foot, wezterm, alacritty, kitty, ghostty)
• Status bar (waybar, eww, quickshell, ags), waybar is preferred
• Wallpaper setup (swww, swaybg)
• Notification daemon (swaync, dunst,mako)
• Desktop portal (xdg-desktop-portal, xdg-desktop-portal-wlr, xdg-desktop-portal-gtk)
• Clipboard (wl-clipboard, wl-clip-persist, cliphist)
• Gamma control/night light (wlsunset, gammastep)
• Miscellaneous (xfce-polkit, wlogout)

• alt+return: open foot terminal
• alt+space: open rofi launcher
• alt+q: kill client
• alt+left/right/up/down: focus direction
• super+m: quit mango

• Dependencies

yay -S rofi foot xdg-desktop-portal-wlr swaybg waybar wl-clip-persist cliphist wl-clipboard wlsunset xfce-polkit swaync pamixer wlr-dpms sway-audio-idle-inhibit-git swayidle dimland-git brightnessctl swayosd wlr-randr grim slurp satty swaylock-effects-git wlogout sox

• Dependencies

yay -S foot xdg-desktop-portal-wlr swaybg wl-clip-persist cliphist wl-clipboard sway-audio-idle-inhibit-git brightnessctl grim slurp satty matugen-bin dms-shell-git

• use my dms config

git clone -b dms https://github.com/DreamMaoMao/mango-config.git ~/.config/mango

• use my daily config

git clone https://github.com/DreamMaoMao/mango-config.git ~/.config/mango

Refer to the repo wiki wiki

or the website docs docs

The repo contains a flake that provides a NixOS module and a home-manager module for mango. Use the NixOS module to install mango with other necessary components of a working Wayland environment. Use the home-manager module to declare configuration and autostart for mango.

Here's an example of using the modules in a flake:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    home-manager = {
      url = "github:nix-community/home-manager";
      inputs.nixpkgs.follows = "nixpkgs";
    };
    flake-parts.url = "github:hercules-ci/flake-parts";
    mango = {
      url = "github:DreamMaoMao/mango";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };
  outputs =
    inputs@{ self, flake-parts, ... }:
    flake-parts.lib.mkFlake { inherit inputs; } {
      debug = true;
      systems = [ "x86_64-linux" ];
      flake = {
        nixosConfigurations = {
          hostname = inputs.nixpkgs.lib.nixosSystem {
            system = "x86_64-linux";
            modules = [
              inputs.home-manager.nixosModules.home-manager

              # Add mango nixos module
              inputs.mango.nixosModules.mango
              {
                programs.mango.enable = true;
              }
              {
                home-manager = {
                  useGlobalPkgs = true;
                  useUserPackages = true;
                  backupFileExtension = "backup";
                  users."username".imports =
                    [
                      (
                        { ... }:
                        {
                          wayland.windowManager.mango = {
                            enable = true;
                            settings = ''
                              # see config.conf
                            '';
                            autostart_sh = ''
                              # see autostart.sh
                              # Note: here no need to add shebang
                            '';
                          };
                        }
                      )
                    ]
                    ++ [
                      # Add mango hm module
                      inputs.mango.hmModules.mango
                    ];
                };
              }
            ];
          };
        };
      };
    };
}

To package mango for other distributions, you can check the reference setup for:

• nix
• arch.
• gentoo

You might need to package scenefx for your distribution, check availability here.

If you encounter build errors when packaging mango, feel free to create an issue and ask a question, but Read The Friendly Manual on packaging software in your distribution first.

• https://gitlab.freedesktop.org/wlroots/wlroots - Implementation of Wayland protocol

• https://github.com/dqrk0jeste/owl - Basal window animation

• https://codeberg.org/dwl/dwl - Basal dwl feature

• https://github.com/swaywm/sway - Sample of Wayland protocol

• https://github.com/wlrfx/scenefx - Make it simple to add window effect.