Overview/X Linux (distro)
X distribution repository
This is the documentation index for the x repository (xlnux/x), the home
of the X distribution (formerly known as X Linux / x-linux). X is a
custom Arch Linux spin focused on simplicity, clean branding, and reproducible
builds. It ships its own package repository (x-repo) so X-specific packages
can be installed directly with pacman.
Overview
The repository contains the distribution build source, not a user-facing product on its own. It provides:
- An archiso profile that produces the bootable live ISO.
- A text installer that runs automatically in the live environment (no graphical installer; Calamares was removed).
- Provisioning of the installed system through the
x-scriptspayload, shipped offline inside the ISO. - Helpers to build WSL-importable root filesystem tarballs.
The ISO uses the standard mkarchiso workflow. A custom [x] pacman
repository is declared in pacman.conf and is used both at build time and on
the installed system, so X branding and tooling packages (x-release,
x-dev) install with pacman.
Project status
The distribution is under active development. The current work is the reboot
initiative (script-based provisioning in the style of Omarchy, with X's own
decisions and tooling). See ROADMAP.md for the roadmap and
docs/project-state.md for a state snapshot.
How this repository maps to the organization
The workspace groups each xlnux repository under x-lnux/. Repo names were
renamed at some point, so older references to x-linux (the distro) or to an
x scripts repo must be read with this mapping in mind:
| Repository | Role |
|---|---|
xlnux/x | The distro (this repo). archiso profile, live ISO, text installer, WSL rootfs builds. |
xlnux/scripts | Provisioning payload and the x CLI (x setup, x theme, ...). Packaged as x-scripts and installed by the text installer. |
xlnux/x-repo | X binary package repository (hosted on GitHub Pages, [x] in pacman.conf) plus the package portal. |
xlnux/xpm | X package manager (Rust). |
xlnux/xpkg | X packaging tool for developers (Rust). |
xscriptor-colors/hyprland | External source of the Hyprland/kitty/nvim configuration, consumed read-only by the Hyprland setup tool in scripts. |
Related documentation in this repository:
Highlights
- Branding. Identity applied to GRUB (
GRUB_DISTRIBUTOR="X"), the ISO label/publisher, MOTD, and installed packages. - Text installer.
configurator.shcollects options and writes a JSON plan;install.shpartitions (GPT/btrfs), runspacstrap, configures the base system, provisions withx-scripts, and installs a bootloader. - Unattended install. Kernel cmdline
xauto=1plus a disk labeledcidatacontainingx-install.jsontriggers the autoinstall path. - Offline provisioning payload. The
x-scriptspackage and the Hyprland config snapshot ship inside the ISO, so provisioning does not depend on downloading them during install. - WSL support.
xbuildwsl.sh/xbuildwslc.shproduce rootfs tarballs.
Development model
mainis the branch described by this documentation.- The reboot initiative is developed on the
x/rebootbranch of each repo (origin/x/reboot). - Older remote branches (
checkpoint/calamares-installer-v1,dev) are historical and do not reflect the current installer.
Scope
Everything in this repository is part of the xlnux organization. Only
references related to building, installing, and provisioning X live here;
user-facing setup logic lives in the x-scripts payload.