euri-packages/README.md

# Euri Linux Packages

*(formerly Antergos NeXT)*

Custom package repository for Euri Linux ISO builds.

## Packages

| Package | Description |
|---------|-------------|
| `calamares` | Universal installer framework (Qt6) — [upstream](https://codeberg.org/calamares/calamares) |
| `calamares-branding-euri` | Euri Calamares branding + netinstall-based installer + launcher |
| `euri-keyring` | GPG keyring for the `[euri-pkgs]` repo |
| `euri-mirrorlist` | Mirror list for `[euri-pkgs]` |
| `euri-release` | Euri Linux `/etc/os-release` |
| `euri-lsb-release` | LSB release info |
| `euri-desktop-settings` | Plasma/GTK theme, dconf/plasma-settings defaults |
| `euri-xfce-theme` | XFCE desktop theme |
| `euri-layan-theme` | Layan theme variant |
| `euri-wallpapers` | Desktop wallpapers |
| `euri-grub-theme` | GRUB theme |
| `euri-welcome` | Welcome screen + support tool |
| `euri-live` | Live session configuration |
| `euri-i3-config` | Dark Euri i3 configuration |
| `euri-sway-config` | Dark Euri Sway configuration |
| `euri-hyprland-config` | Dark Euri Hyprland configuration (Lua) |
| `pixie-sddm-git` | SDDM theme (pixie) |
| `tela-circle-icon-theme-git` | Tela Circle icon theme |
| `kwin-zones` | KWin tiling zones |
| `oh-my-posh-bin` | Prompt theme engine |
| `pacseek` | Pacman TUI browser |
| `yay` | AUR helper — [AUR](https://aur.archlinux.org/packages/yay) |
| `downgrade` | Pacman package downgrade tool — [AUR](https://aur.archlinux.org/packages/downgrade) |

## Usage

Add to `/etc/pacman.conf` (before `[system]` to take priority):

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

Then:

```sh
pacman -Sy
pacman -S calamares calamares-branding-euri euri-wallpapers
```

## Calamares installer

`calamares-branding-euri` is the main branding component with:

- **Packagechooser + netinstall** — DE selector (KDE, GNOME, XFCE, i3, Sway, Hyprland, Budgie, Cinnamon, MATE) and DM selector (SDDM, LightDM, GDM, Ly, greetd), with basestrap-based package groups
- **Launcher** (`calamares-next`) — launches Calamares with online settings
- **Animated space slideshow** — rocket, stars, comet, moon with smooth 700ms transitions

## How it works

On each push to `master` (or weekly Monday), GitHub Actions:

1. Builds all packages from `packages.yaml` inside an Artix Linux container
2. Creates a pacman repo database (`repo-add`)
3. Generates a browsable package index (`generate-index.py`)
4. Deploys to [the package repo](https://antergos-nas.taild4360b.ts.net/pkgs/)

The repo serves as both a pacman repository and a web-based package browser.

## Contributing

See [CONTRIBUTING.md](https://github.com/Euri-Linux/euri-packages/blob/master/CONTRIBUTING.md).

## License

GPL-3.0