mangowc

name	mangowc
version	1
description	MangoWC Skill

MangoWC Skill

A specialized skill for configuring and customizing MangoWC Wayland compositor in NixOS using Home Manager, providing expert guidance on tag-based window management, animations, effects, and declarative configuration.

Skill Overview

Purpose: Provide comprehensive support for MangoWC configuration, customization, and ecosystem integration in NixOS.

Invoke When:

• Setting up MangoWC Wayland compositor
• Configuring MangoWC via Home Manager or NixOS module
• Customizing keybindings and window behavior
• Setting up animations and visual effects (scenefx)
• Configuring tags, layouts, and scratchpads
• Integrating waybar, launchers, and other tools
• Troubleshooting MangoWC issues
• Migrating from DWM or other window managers
• Optimizing MangoWC performance

Core Capabilities

1. What is MangoWC?

MangoWC is a fast, lightweight, modern Wayland compositor based on wlroots and scenefx. It's described as "dwm but Wayland" and provides:

• Tag-based window management (not workspaces)
• Rich animations for windows, tags, and layers
• Scenefx effects: blur, shadows, rounded corners, opacity
• Excellent XWayland support
• Scratchpad functionality (Sway-like)
• IPC support for external program communication
• Hot-reload configuration
• Nine layout options
• Minimal resource footprint

Project: DreamMaoMao/mangowc (1.5k+ stars) Website: mangowc.vercel.app

2. Installation and Configuration

NixOS Flake Setup (Recommended)

# flake.nix
{
  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";

    home-manager = {
      url = "github:nix-community/home-manager";
      inputs.nixpkgs.follows = "nixpkgs";
    };

    # Add MangoWC flake
    mangowc = {
      url = "github:DreamMaoMao/mangowc";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = { nixpkgs, home-manager, mangowc, ... }:
    {
    nixosConfigurations.hostname = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [
        # Import MangoWC NixOS module
        mangowc.nixosModules.default

        # Your NixOS configuration
        {
          # Enable MangoWC system-wide
          programs.mango.enable = true;

          # Essential packages
          environment.systemPackages = with pkgs;
            [
            foot          # Terminal
            wmenu         # Launcher
            wl-clipboard  # Clipboard
            grim          # Screenshots
            slurp         # Region select
            swaybg        # Wallpaper
            firefox       # Browser
          ];
        }

        # Home Manager with MangoWC
        home-manager.nixosModules.home-manager
        {
          home-manager.useGlobalPkgs = true;
          home-manager.useUserPackages = true;

          home-manager.users.username = {
            imports = [ mangowc.homeManagerModules.default ];

            # MangoWC configuration
            wayland.windowManager.mango = {
              enable = true;

              # Configuration file content
              settings = ''
                # Your config.conf content here
              '';

              # Autostart script content
              autostart_sh = ''
                # Your autostart.sh content here
              '';
            };
          };
        }
      ];
    };
  };
}

NixOS Module Only (System-wide)

# configuration.nix
{ config, pkgs, ... }:
{
  # Import MangoWC module from flake
  programs.mango.enable = true;

  # Essential packages
  environment.systemPackages = with pkgs;
    [
    # Core tools
    foot
    wmenu
    wl-clipboard
    grim
    slurp
    swaybg

    # Optional but recommended
    waybar
    dunst
    rofi-wayland
    swaylock
    swayidle
    playerctl
    brightnessctl
    pamixer
  ];
}

Home Manager Module (Per-User)

# home.nix
{ config, pkgs, ... }:
{
  wayland.windowManager.mango = {
    enable = true;

    # Configuration file (~/.config/mango/config.conf)
    settings = ''
      # See section 3 for complete configuration
    '';

    # Autostart script (~/.config/mango/autostart.sh)
    autostart_sh = ''
      # Launch waybar
      waybar -c ~/.config/mango/config.jsonc -s ~/.config/mango/style.css >/dev/null 2>&1 &

      # Set wallpaper
      swaybg -i ~/Pictures/Wallpapers/default.png >/dev/null 2>&1 &

      # Notification daemon
      dunst >/dev/null 2>&1 &

      # Network manager applet
      nm-applet --indicator >/dev/null 2>&1 &

      # Bluetooth manager
      blueman-applet >/dev/null 2>&1 &
    '';
  };
}

3. Complete Configuration (config.conf)

Full config.conf Example

# MangoWC Configuration
# Format: bind=MODIFIER,KEY,ACTION,PARAMETERS

# ============ Modifiers ============
# SUPER  - Windows/Super key
# ALT    - Alt key
# CTRL   - Control key
# SHIFT  - Shift key

# ============ Applications ============
# Terminal
bind=SUPER,Return,spawn,foot

# Application launcher
bind=SUPER,d,spawn,wmenu-run -l 10
bind=SUPER,Space,spawn,rofi -show drun

# Browser
bind=SUPER,b,spawn,firefox

# File manager
bind=SUPER,e,spawn,thunar

# Screenshot
bind=,Print,spawn,grim -g "$(slurp)" - | wl-copy
bind=SUPER,Print,spawn,grim -g "$(slurp)" ~/Pictures/Screenshots/$(date +%Y-%m-%d_%H-%M-%S).png
bind=SUPER_SHIFT,Print,spawn,grim - | wl-copy

# Clipboard history
bind=SUPER,v,spawn,cliphist list | rofi -dmenu | cliphist decode | wl-copy

# Lock screen
bind=SUPER,l,spawn,swaylock -f -c 000000

# ============ Window Management ============
# Close window
bind=SUPER,q,killclient

# Toggle fullscreen
bind=SUPER,f,togglefullscreen

# Toggle floating
bind=SUPER_SHIFT,f,togglefloating

# Toggle fakefullscreen
bind=SUPER_CTRL,f,togglefakefullscreen

# Cycle window focus
bind=SUPER,Tab,focusstack,1
bind=SUPER_SHIFT,Tab,focusstack,-1

# Focus window by direction
bind=SUPER,h,focusdir,left
bind=SUPER,j,focusdir,down
bind=SUPER,k,focusdir,up
bind=SUPER,l,focusdir,right
bind=SUPER,Left,focusdir,left
bind=SUPER,Down,focusdir,down
bind=SUPER,Up,focusdir,up
bind=SUPER,Right,focusdir,right

# Move window by direction
bind=SUPER_SHIFT,h,movewindow,left
bind=SUPER_SHIFT,j,movewindow,down
bind=SUPER_SHIFT,k,movewindow,up
bind=SUPER_SHIFT,l,movewindow,right
bind=SUPER_SHIFT,Left,movewindow,left
bind=SUPER_SHIFT,Down,movewindow,down
bind=SUPER_SHIFT,Up,movewindow,up
bind=SUPER_SHIFT,Right,movewindow,right

# Resize window
bind=SUPER_CTRL,h,resizeactive,-50,0
bind=SUPER_CTRL,j,resizeactive,0,50
bind=SUPER_CTRL,k,resizeactive,0,-50
bind=SUPER_CTRL,l,resizeactive,50,0
bind=SUPER_CTRL,Left,resizeactive,-50,0
bind=SUPER_CTRL,Down,resizeactive,0,50
bind=SUPER_CTRL,Up,resizeactive,0,-50
bind=SUPER_CTRL,Right,resizeactive,50,0

# Master/stack ratio
bind=SUPER,equal,setmfact,0.05
bind=SUPER,minus,setmfact,-0.05

# Promote window to master
bind=SUPER,Return,zoom

# ============ Tags (Workspaces) ============
# Switch to tag
bind=SUPER,1,view,1
bind=SUPER,2,view,2
bind=SUPER,3,view,3
bind=SUPER,4,view,4
bind=SUPER,5,view,5
bind=SUPER,6,view,6
bind=SUPER,7,view,7
bind=SUPER,8,view,8
bind=SUPER,9,view,9

# Move window to tag
bind=SUPER_SHIFT,1,tag,1
bind=SUPER_SHIFT,2,tag,2
bind=SUPER_SHIFT,3,tag,3
bind=SUPER_SHIFT,4,tag,4
bind=SUPER_SHIFT,5,tag,5
bind=SUPER_SHIFT,6,tag,6
bind=SUPER_SHIFT,7,tag,7
bind=SUPER_SHIFT,8,tag,8
bind=SUPER_SHIFT,9,tag,9

# Toggle tag view
bind=SUPER_CTRL,1,toggleview,1
bind=SUPER_CTRL,2,toggleview,2
bind=SUPER_CTRL,3,toggleview,3
bind=SUPER_CTRL,4,toggleview,4
bind=SUPER_CTRL,5,toggleview,5
bind=SUPER_CTRL,6,toggleview,6
bind=SUPER_CTRL,7,toggleview,7
bind=SUPER_CTRL,8,toggleview,8
bind=SUPER_CTRL,9,toggleview,9

# Toggle window on tag
bind=SUPER_ALT,1,toggletag,1
bind=SUPER_ALT,2,toggletag,2
bind=SUPER_ALT,3,toggletag,3
bind=SUPER_ALT,4,toggletag,4
bind=SUPER_ALT,5,toggletag,5
bind=SUPER_ALT,6,toggletag,6
bind=SUPER_ALT,7,toggletag,7
bind=SUPER_ALT,8,toggletag,8
bind=SUPER_ALT,9,toggletag,9

# View all tags
bind=SUPER,0,view,~0
bind=SUPER_SHIFT,0,tag,~0

# ============ Layouts ============
# Cycle through layouts
bind=SUPER,t,setlayout,tile
bind=SUPER,m,setlayout,monocle
bind=SUPER,g,setlayout,grid
bind=SUPER,s,setlayout,scroller
bind=SUPER,c,setlayout,center_tile
bind=SUPER,n,cyclelayout,1
bind=SUPER_SHIFT,n,cyclelayout,-1

# Available layouts:
# - tile: Master-stack tiling
# - scroller: Scrolling layout
# - monocle: One window fullscreen
# - grid: Grid layout
# - deck: Deck layout
# - center_tile: Centered master
# - vertical_tile: Vertical tiling
# - vertical_grid: Vertical grid
# - vertical_scroller: Vertical scrolling

# ============ Scratchpad ============
# Toggle scratchpad
bind=SUPER,grave,togglescratch,0

# Named scratchpads
bind=SUPER,F1,togglescratch,terminal
bind=SUPER,F2,togglescratch,music
bind=SUPER,F3,togglescratch,notes

# ============ Overview ============
# Show overview (all windows)
bind=SUPER,o,toggleoverview

# ============ Monitors ============
# Focus monitor
bind=SUPER,comma,focusmon,left
bind=SUPER,period,focusmon,right

# Move window to monitor
bind=SUPER_SHIFT,comma,tagmon,left
bind=SUPER_SHIFT,period,tagmon,right

# ============ Window States ============
# Minimize
bind=SUPER,x,minimize

# Maximize
bind=SUPER,z,maximize

# Overlay mode
bind=SUPER,a,overlay

# Global (show on all tags)
bind=SUPER_SHIFT,g,global

# Swallow windows
bind=SUPER_SHIFT,s,swallow

# ============ Media Keys ============
# Volume
bind=,XF86AudioRaiseVolume,spawn,pamixer -i 5
bind=,XF86AudioLowerVolume,spawn,pamixer -d 5
bind=,XF86AudioMute,spawn,pamixer -t

# Media playback
bind=,XF86AudioPlay,spawn,playerctl play-pause
bind=,XF86AudioPause,spawn,playerctl pause
bind=,XF86AudioNext,spawn,playerctl next
bind=,XF86AudioPrev,spawn,playerctl previous

# Brightness
bind=,XF86MonBrightnessUp,spawn,brightnessctl set 10%+
bind=,XF86MonBrightnessDown,spawn,brightnessctl set 10%-

# ============ System ============
# Reload configuration
bind=SUPER_SHIFT,r,reloadconfig

# Quit MangoWC
bind=SUPER_SHIFT,q,quit

# ============ Mouse Bindings ============
# SUPER + left click: move window
# SUPER + right click: resize window
# These are built-in and don't need configuration

# ============ Window Rules ============
# Format: rule=CLASS,TITLE,COMMAND
# Commands: float, tile, fullscreen, tag:N, monitor:N

# Float specific windows
rule=pavucontrol,,float
rule=nm-connection-editor,,float
rule=blueman-manager,,float

# Picture-in-Picture
rule=.*,Picture-in-Picture,float,pin

# Assign to tags
rule=firefox,,tag:2
rule=code,,tag:3
rule=discord,,tag:4
rule=spotify,,tag:5

# ============ Animations ============
# Enable animations
animations=true

# Animation duration (ms)
animation_duration=300

# Animation curve (bezier)
# Format: x1,y1,x2,y2
animation_curve=0.25,0.1,0.25,1.0

# ============ Visual Effects (scenefx) ============
# Corner radius
corner_radius=10

# Blur
blur=true
blur_radius=8
blur_passes=2

# Shadows
shadow=true
shadow_radius=15
shadow_offset_x=0
shadow_offset_y=0
shadow_color=#000000
shadow_opacity=0.6

# Opacity
inactive_opacity=0.95
active_opacity=1.0

# ============ Gaps ============
# Outer gaps
gaps_outer=10

# Inner gaps
gaps_inner=5

# ============ Borders ============
# Border width
border_width=2

# Border colors
border_active=#89b4fa
border_inactive=#313244
border_urgent=#f38ba8

# ============ General Settings ============
# Focus follows mouse
focus_follows_mouse=true

# Click to focus
click_to_focus=true

# Smart gaps (disable when only one window)
smart_gaps=true

# Smart borders (disable when only one window)
smart_borders=true

# Repeat rate (keyboard)
repeat_rate=25
repeat_delay=300

# Cursor theme
cursor_theme=Adwaita
cursor_size=24

# ============ Monitor Configuration ============
# Format: monitor=NAME,RESOLUTION@REFRESH,POSITION,SCALE
monitor=DP-1,3840x2160@144,0x0,1
monitor=HDMI-A-1,1920x1080@60,3840x0,1
monitor=,preferred,auto,1  # Fallback

# ============ XWayland ============
# Enable XWayland
xwayland=true

# ============ IPC ============
# Enable IPC socket
ipc=true
ipc_socket=/tmp/mango-ipc.sock