euri-iso/docs/packages.md

---
title: Packages
layout: default
nav_order: 6
---

# Custom Packages

Custom PKGBUILDs live in the [euri-packages](https://antergos-nas.taild4360b.ts.net/Euri-Linux/euri-packages) repo. Built and published via CI to GitHub Pages as a pacman repository.

## Repo setup

```ini
[euri-pkgs]
SigLevel = Optional TrustAll
Server = https://antergos-nas.taild4360b.ts.net/pkgs
```

## Package list

Built and published in this order (from `packages.yaml` in `euri-packages`):

| Package | Purpose |
|---------|---------|
| `euri-lsb-release` | LSB release identification |
| `euri-desktop-settings` | Default desktop settings for the live session |
| `euri-keyring` | GPG keyring for the `[euri-pkgs]` repo |
| `euri-mirrorlist` | Mirror list for `[euri-pkgs]` |
| `euri-release` | `/usr/lib/os-release` with "Euri Linux" identification |
| `pixie-sddm-git` | Material Design 3 SDDM theme (from AUR) |
| `euri-wallpapers` | Default wallpapers for KDE and other DEs |
| `euri-welcome` | "About Euri Linux" welcome app (KF6 + Qt6) |
| `euri-grub-theme` | GRUB boot theme |
| `euri-live` | Live session meta package (per-init: `euri-live-base`, `euri-live-dinit`, `euri-live-openrc`) |
| `pipewire` (forked) | Patched `artix-pipewire-launcher` for dinit support + XDG autostart entry |
| `calamares` | Built with `packagechooser` module enabled |
| `calamares-branding-euri` | Branding: slideshow, `branding.desc`, launcher script, packagechooser configs |
| `euri-xfce-theme` | Xfce theme |
| `downgrade` | AUR package (downgrade helper) |
| `yay` | AUR helper |
| `euri-layan-theme` | Layan theme suite: KDE configs, Kvantum, SDDM theme, plasmoids, video wallpaper |
| `tela-circle-icon-theme-git` | Icon theme (from AUR) |
| `kwin-zones` | KWin window tiling zones |
| `oh-my-posh-bin` | Shell prompt (from AUR) |
| `pacseek` | Package search GUI (from AUR) |
| `euri-i3-config` | i3 configuration |
| `euri-sway-config` | Sway configuration |
| `euri-hyprland-config` | Hyprland configuration |

## PKGBUILD notes

### calamares

- `_skip_modules` includes `dracut`, `initramfs`, `initramfscfg` — these are systemd-holdovers not needed on Artix (uses mkinitcpio)
- **`-DCMAKE_DISTRIBUTION_NAME` is a no-op** — Calamares ignores it completely. The "for \<distro\>" text in the about dialog comes from `versionedName` in the active branding component at runtime. Do NOT add this flag.

### calamares-branding-euri

- Ships `calamares-next.sh` — installed as `/usr/bin/calamares-next`, the online installer launcher
- Ships the online settings file as `/etc/calamares-online/settings.conf`. It also ships an `settings_offline.conf` installed as `/etc/calamares-offline/settings.conf` (with `/etc/calamares/settings.conf` symlinked to it by default) — but this is **unused**: the launcher's `SetConfig()` always replaces it with the online config at runtime. Calamares is online-only.
- Ships module configs to `/etc/calamares/modules/`: `unpackfs.conf`, `initcpiocfg.conf`, `initcpio.conf`, `netinstall.conf`, `netinstall.yaml`, `packagechooser_de.conf`, `packagechooser_dm.conf`, `services-artix.conf`, `welcome.conf`
- Also overwrites `/usr/share/calamares/branding/default/` so the Artix default branding can't sneak in
- `SetConfig()` must `rm -f` the symlink at `/etc/calamares/settings.conf` before copying, otherwise `cp` follows the symlink and overwrites the wrong file

### pipewire (forked)

- Ships `pipewire.desktop` at `/etc/xdg/autostart/` so installed systems get the XDG autostart entry
- Patches `artix-pipewire-launcher`: sets `dinit|runit|s6) SUPPORT='YES'` (upstream only supported `openrc`/`systemd`). Without this, the launcher silently exits on dinit systems and pipewire never starts.

### euri-wallpapers

- Installs to `/usr/share/wallpapers/euri-wallpaper/contents/images/` with `metadata.desktop` for KDE picker support
- Also available at `/usr/share/backgrounds/euri/` for other DEs
- Ships three wallpapers: original Antergos PNG (default), Adwaita Morning, and antergos-darkest-hour

## File conflicts

| Package 1 | Package 2 | File | Resolution |
|-----------|-----------|------|------------|
| `calamares` | `calamares-branding-euri` | `/usr/share/calamares/branding/default/branding.desc`, `show.qml` | `--overwrite='*'` in `./buildiso` |
| `filesystem` | `euri-release` | `/usr/lib/os-release` | `euri-release` in basestrap operations list (uses `--overwrite`) |

## Build system

Packages are built and published via CI in the `euri-packages` repo. Build order is defined in `packages.yaml`. AUR packages (`yay`, `downgrade`, `pixie-sddm-git`, etc.) are included with retry logic for transient clone failures. The repo index is generated as `euri-pkgs.db` / `euri-pkgs.files` under `euri-pkgs/os/x86_64/` by `repo-add` (adjust the Server URL with `/os/x86_64` if the repo is served as a full arch tree) and served from the package server at `https://antergos-nas.taild4360b.ts.net/pkgs/euri-pkgs/`.