Skip to main content

​
Installation via Guix Channel

Mango provides a Guix channel with package definitions for easy installation.
1

Add Mango channel

Add the Mango channel to your channels.scm file:
~/.config/guix/channels.scm
;; In $HOME/.config/guix/channels.scm
(cons (channel
        (name 'mangowm)
        (url "https://github.com/mangowm/mango.git")
        (branch "main"))
      ... ;; Your other channels
      %default-channels)
2

Update channels

Run guix pull to update your channels:
guix pull
This will download the channel and make the Mango package available.
3

Install Mango

After updating, you can install Mango in two ways:
Install directly to your user profile:
guix install mangowm
4

Launch Mango

After installation, you can start Mango from a TTY:
mango
Or select it from your display manager’s session list.

​
System Configuration Example

Here’s a complete example of adding Mango to your system configuration:
/etc/config.scm
(use-modules
  (gnu)
  (gnu system)
  (gnu packages wm)
  (mangowm))  ;; Import mangowm module

(operating-system
  (host-name "my-system")
  (timezone "UTC")
  (locale "en_US.utf8")
  
  ;; Add Mango and related packages
  (packages (cons*
              mangowm-git
              foot            ;; Terminal emulator
              rofi            ;; Application launcher
              waybar          ;; Status bar
              swaybg          ;; Wallpaper setter
              %base-packages))
  
  ;; ... rest of your configuration
  )

​
Dependencies

Guix will automatically install these dependencies:
  • wayland (>=1.23.1)
  • wayland-protocols
  • libinput (>=1.27.1)
  • libxkbcommon
  • pcre2
  • pixman
  • wlroots (0.19.x)
  • scenefx (0.4.x)
  • xwayland (for X11 app support)
  • libxcb

​
Suggested Packages

Add these packages for a complete Wayland environment: 
(packages (cons*
            mangowm-git
            
            ;; Terminal emulator
            foot
            
            ;; Application launcher
            rofi
            
            ;; Status bar
            waybar
            
            ;; Wallpaper
            swaybg
            
            ;; Clipboard
            wl-clipboard
            
            ;; Screenshots
            grim
            slurp
            
            ;; Notifications
            mako
            
            ;; Authentication
            polkit
            
            %base-packages))

​
Next Steps

Configuration

Configure Mango to your preferences

Keybindings

Learn default keybindings and create custom ones

Build docs developers (and LLMs) love

Get started for freeTalk to us