Files
euri-iso/docs/launcher.md
T
c-ludenberg 9fe5174cc7 feat: add GitHub Pages docs site (Just the Docs), split packagechooser, disable IA upload
- docs/: new 13-page Jekyll site with Just the Docs theme
  - Home, Building, Installer, Packages, CI/CD, Development
  - Desktop Environments (with GNOME joke), Wallpapers, Launcher
  - Overlays, Root Overlay, Live Overlay
- .github/workflows/pages.yml: build & deploy docs from docs/ on
  push to master (only when docs/ changes)
- .github/workflows/build.yml: temporarily disable Internet Archive
  upload (if: false) until ISO is stable
- live-overlay/settings.conf: add instances section for init + desktop
  packagechooser instances
- live-overlay/modules/packagechooser_init.conf: init system selector
  (OpenRC, Runit, S6, Dinit) via netinstall-add method
- live-overlay/modules/packagechooser_desktop.conf: DE selector
  (Plasma, Xfce, Cinnamon, MATE, LXQt, i3, Sway, Hyprland + No Desktop)
  via legacy method
- README.md, AGENTS.md: fix sudo buildiso -> sudo ./buildiso, add note
  about system buildiso lacking --overwrite='*'
- .gitignore: add docs/_site/
2026-06-29 21:27:46 +02:00

1.5 KiB

title, layout, nav_order
title layout nav_order
Launcher default 9

Calamares Launcher

The calamares-next script (calamares-next.sh) handles the installer boot flow.

Flow

  1. Mode picker — Dialog asking Offline or Online install
  2. Configuration — Copies the appropriate settings.conf (offline or online) to /etc/calamares/settings.conf
  3. Launch — Runs calamares with the selected config

Launcher location

Installed by calamares-branding-antergos-next to /usr/bin/calamares-next.

Desktop entry

/usr/share/applications/calamares.desktop in the live-overlay launches with:

Exec=sudo -E calamares-next

Note: sudo -E preserves environment variables (required for WAYLAND_DISPLAY, XDG_CURRENT_DESKTOP, etc. when launched from the SDDM session).

Mode picker (dialog)

A simple kdialog or zenity dialog:

  • Offline — No internet required, installs KDE Plasma from squashfs
  • Online — Init system selector + DE selector via packagechooser, downloads packages from the internet

Config switching

SetConfig() in calamares-next.sh:

  1. Removes existing symlink at /etc/calamares/settings.conf (must rm -f first, not overwrite, or cp follows the symlink)
  2. Copies the selected settings file
  3. Calamares reads the config on launch

Hiding "Install Artix"

The live-overlay includes calamares-config-switcher.desktop with NoDisplay=true — this hides the upstream Artix launcher while keeping the binary available.