Description

Adding a feature to install on Ubuntu 26.04 systems.

Changes

• Feature
• Bug Fixes
• Improved
• Documentation
• Other

Context

As it stands, there is currently no official way to install ML4W on Ubuntu. This PR seeks to change this.

This has both features and fixes for said feature.

Features:

• Add preflight/post/packages scripts for Ubuntu, matching the existing Arch/Fedora/openSUSE pattern
• Build quickshell, awww, walker, elephant, and nwg-dock-hyprland from source (no apt packages)
• Start hyprpolkitagent explicitly and hide mate-polkit's autostart entry so it wins the polkit-agent race
• Theme hyprpolkitagent's dialogue via a new matugen template (hyprtoolkit.conf)
• Quiet noisy apt/cargo/cmake/go build output behind a gum spinner, with a sudo keep-alive loop

Fixes:

• Missing QML modules, missing Font Awesome icons, quickshell not autostarting, apt package name mismatches, missing libzstd-dev breaking quickshell's cmake configure
• Unmask swaync.service on Ubuntu and gate autostart.lua's swaync exec-once to Ubuntu specifically via /etc/os-release's ID (not /etc/debian_version, which also matches Mint/Pop!_OS/other Debian derivatives that don't have this Ubuntu-specific D-Bus-activation setup and would otherwise never get swaync started at all)
• Add gnome-themes-extra-data, gnome-themes-ubuntu, imagemagick, and pipx to packages-ubuntu; drop uwsm (unused on Ubuntu)
• Remove a systemctl mask call that targeted the wrong (nonexistent) snapd-desktop-integration unit name; the real protection was always the ConditionEnvironment drop-in below it
• JetBrains Mono Nerd Font and Font Awesome 7 installs no longer leave an empty destination directory on a partial failure, which permanently blocked retry on every future run
• Oh My Posh install no longer silently reports success when the curl download fails
• Charm apt keyring self-heals after a failed download instead of treating a stale empty keyring as present forever
• ML4W Settings App's sed patch on the downloaded upstream script now validates its anchor point instead of silently mis-patching or no-op'ing
• preflight-ubuntu.sh and post-ubuntu.sh now use set -euo pipefail instead of set -e / no explicit option at all

Refactor:

• Collapse the quickshell/nwg-dock-hyprland/Walker/Elephant from-source build blocks into a shared build_from_source helper
• Collapse the JetBrains Mono/Font Awesome zip installs into a shared install_font_zip helper

How Has This Been Tested?

• Tested on Arch Linux/Based Distro.
• Tested on Fedora Linux/Based Distro.
• Tested on openSuse.
• Tested on Ubuntu 26.04

Tested directly in a Virtual Machine during building, then a clean install on bare metal.

Checklist

• My code follows the style guidelines of this project.
• I have performed a self-review of my code.
• I have commented on my code, particularly in hard-to-understand areas.
• My changes do not introduce new warnings.
• I have added tests that prove my fix is effective or that my feature works.
• I have made corresponding changes to the documentation
• New and existing unit tests pass locally with my changes.

Screenshots

Additional Notes

Will also need to create a PR for the installer script to incorporate the required changes.