Prerequisites

Regardless of your installation method, MangoWC requires a Wayland-capable environment. If you are building from source, ensure you have the following dependencies:

Build Dependencies

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

Install Guide

Choose your distribution below for specific installation instructions.

MangoWC is available in the Arch User Repository (AUR).

You can install it using an AUR helper like yay or paru:

yay -S mangowc-git

This package pulls the latest git version, ensuring you have the newest features and fixes.

The package is hosted in the community-maintained GURU repository.

Add the GURU repository

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

Unmask packages Add the required packages to your package.accept_keywords file:

gui-libs/scenefx
gui-wm/mangowc

Install MangoWC

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

The repository provides a Flake with a NixOS module and a Home Manager module.

Example flake.nix configuration:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    home-manager = {
      url = "github:nix-community/home-manager";
      inputs.nixpkgs.follows = "nixpkgs";
    };
    mango = {
      url = "github:DreamMaoMao/mango";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = inputs@{ self, nixpkgs, mango, ... }: {
    nixosConfigurations.hostname = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [
        mango.nixosModules.mango
        {
          programs.mango.enable = true;
        }
      ];
    };
  };
}

MangoWC is available in the PikaOS package repository.

You can install it using the pikman package manager:

pikman install mangowc

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

Requires sudo privileges

Both commands require root privileges. Use sudo if needed.

dnf install --nogpgcheck --repofrompath 'terra,https://repos.fyralabs.com/terra$releasever' terra-release

Then, install the package:

dnf install mangowc

If your distribution isn't listed, you can build MangoWC from source. You will need to build wlroots and scenefx manually as well.

Build wlroots Clone and install the specific version required (check README for latest version).

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

Build scenefx This library handles the visual effects.

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

Build MangoWC Finally, compile the compositor itself.

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

Installation

Prerequisites

Install Guide

On this page