Home

margo wiki

margo is a Rust + Smithay Wayland tiling compositor in the dwl/mango tradition — tags instead of workspaces, an 11-layout catalogue, spring/bezier animations, and a complete first-party desktop stack (shell, locker, login manager with a GTK4 greeter, screenshot, power manager, Mullvad VPN control, calendar, on-screen keyboard).

Start here

• Features — a one-page tour of the whole stack: compositor, shell, and every companion tool, with links to the detailed guides.
• Bar Widgets — every bar pill explained (what each does, its config token, how to place it, and how to define a custom one).
• Configuration — the complete config guide: layouts, the full dispatch-action catalogue (setlayout, switch_layout, switch_proportion_preset, summon, focusapp, …), keybindings, touchpad gestures, and window/tag/layer rules.
• Full annotated reference — every knob with inline commentary: https://kenanpelit.github.io/margo/config-reference/ (rendered from margo/src/config.example.conf).
• Companion tools — mctl, mlayout, mscreenshot, mvpn (Mullvad VPN), mcal (calendar), mtune (music player), mkeys (on-screen keyboard), mpicker, mlock, mlogind + mgreet (login manager + GTK4 greeter), mpower, mdots: https://kenanpelit.github.io/margo/companion-tools/.
• Install — https://kenanpelit.github.io/margo/install/.

At a glance

• Config lives at ~/.config/margo/config.conf (plain key = value, hot-reloadable with mctl reload).
• Validate offline before reloading: mctl check-config.
• Discover everything the running compositor accepts: mctl actions --verbose.

The website (https://kenanpelit.github.io/margo/) is the canonical, always-current documentation. This wiki mirrors the configuration guide for quick browsing on GitHub.