maomaowm/docs/index.md
2026-03-13 19:41:45 +08:00

2.6 KiB

title description
Introduction A lightweight and feature-rich Wayland compositor based on dwl.

mango is a Wayland compositor based on dwl. It aims to be as lightweight as dwl and can be built completely within a few seconds, without compromising on functionality.

Philosophy: Lightweight & Fast: mango is designed to be minimal yet functional. It compiles in seconds and offers a robust set of features out of the box.

Feature Highlights

Beyond basic window management, mangowm provides a rich set of features designed for a modern Wayland experience.

  • Animations — Smooth, customizable animations for opening, moving, closing windows and tag switching.
  • Layouts — Supports Scroller, Master-Stack, Monocle, Grid, Deck, and more, with per-tag layouts.
  • Visual Effects — Built-in blur, shadows, corner radius, and opacity effects powered by scenefx.
  • IPC & Scripting — Control the compositor externally with robust IPC support for custom scripts and widgets.

Additional Features

  • XWayland Support — Excellent compatibility for legacy X11 applications.
  • Tag System — Uses tags instead of workspaces, allowing separate window layouts for each tag.
  • Input Methods — Great support for text input v2/v3 (Fcitx5, IBus).
  • Window States — Rich states including swallow, minimize, maximize, fullscreen, and overlay.
  • Hot-Reload Config — Simple external configuration that supports hot-reloading without restarting.
  • Scratchpads — Support for both Sway-like and named scratchpads.

Community

  • Join the mangowm Discord — Chat with the community, get support, share your setup, and stay updated with the latest mangowm news.
  • Join the GitHub Discussions — Ask questions, request features, report issues, or share ideas directly with contributors and other users.

Acknowledgements

This project is built upon the hard work of several open-source projects:

  • wlroots — Implementation of the Wayland protocol.
  • mwc — Basal window animation reference.
  • dwl — Basal dwl features.
  • sway — Sample implementation of the Wayland protocol.
  • scenefx — Library to simplify adding window effects.