Installation
Install MangoWC on Arch, Fedora, Gentoo, Guix System, NixOS, PikaOS, or build from source.
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
glibcwaylandwayland-protocolslibinputlibdrmlibxkbcommonpixmangitmesonninjalibdisplay-infolibliftoffhwdataseatdpcre2xorg-xwaylandlibxcb
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-gitThis package pulls the latest git version, ensuring you have the newest features and fixes.
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-releaseThen, install the package:
dnf install mangowcThe package is hosted in the community-maintained GURU repository.
Add the GURU repository
emerge --ask --verbose eselect-repository
eselect repository enable guru
emerge --sync guruUnmask packages
Add the required packages to your package.accept_keywords file:
gui-libs/scenefxgui-wm/mangowc
Install MangoWC
emerge --ask --verbose gui-wm/mangowcThe package definition is described in the source repository.
Add mango channel
Add to $HOME/.config/guix/channels.scm:
(cons (channel
(name 'mangowc)
(url "https://github.com/mangowm/mango.git")
(branch "main"))
%default-channels)Install
After running guix pull, you can install MangoWC:
guix install mangowcOr add it to your system configuration using the mangowc module:
(use-modules (mangowc))
(packages (cons*
mangowc-git
... ;; Other packages
%base-packages))For more information, see the Guix System documentation.
The repository provides a Flake with a NixOS module.
1. Add flake input
# flake.nix
{
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
mangowc = {
url = "github:mangowm/mango";
inputs.nixpkgs.follows = "nixpkgs";
};
# other inputs ...
};
}2. Import the NixOS module
3. Enable the module
# configuration.nix (or any other file that you import)
{
programs.mango.enable = true;
}Extra options
programs.mango.package- the mango package to use, allows usage of custom mango drvsprograms.mango.addLoginEntry(default: true) - adds login entry to the display manager
MangoWC is available in the PikaOS package repository.
You can install it using the pikman package manager:
pikman install mangowcIf 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 installBuild 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 installBuild MangoWC Finally, compile the compositor itself.
git clone https://github.com/mangowm/mango.git
cd mangowc
meson build -Dprefix=/usr
sudo ninja -C build install