Guix System Installation

Install Mango Wayland Compositor on Guix System

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:

   User Profile

   Install directly to your user profile:

   guix install mangowm
   

   System Configuration

   Add to your system configuration:

   /etc/config.scm

   (use-modules (mangowm)) ;; Add mangowm module
   
   (operating-system
     ;; ... your other configuration
     
     ;; Add mangowm to packages list
     (packages (cons*
                 mangowm-git
                 ... ;; Other packages you specified
                 %base-packages)))
   

   Then reconfigure your system:

   sudo guix system reconfigure /etc/config.scm
   
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