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 you can install X-specific packages directly with pacman.

Project status: Under active development

---

Table of Contents

Overview • Project Status • Project Composition • Quick Start • Related Repositories • Related Documents • X

---

Overview

X provides a minimal yet polished Arch-based system with its own identity. It is built with the standard mkarchiso workflow, layering a custom profile, branding assets, and post-install automation.

Key Features

• Custom branding — Identity applied to /etc/os-release, GRUB, MOTD, and wallpapers.
• X package repository — Dedicated [x] repo in pacman.conf for branding and tools.
• Preconfigured archinstall — Ships with predefined configuration files for streamlined installation.
• Post-install automation — Scripts to apply branding and setup tasks after installation.
• WSL support — Tools to build a WSL-importable root filesystem tarball.

---

Project Status

• Development stage: Active.
• Build model: Local mkarchiso flow for ISO and dedicated scripts for WSL rootfs.
• Automation: Roadmap-to-issues synchronization is configured in GitHub Actions.
• Focus areas: Package repository maturity, installer UX, documentation, and release pipeline hardening.

Detailed status report: Project State

---

Project Composition

• airootfs/: Root filesystem overlay (system config, branding, installer automation).
• profiledef.sh: ArchISO profile metadata, boot modes, and file permissions.
• packages.x86_64: Package manifest for ISO/rootfs builds.
• pacman.conf: Package manager configuration, including the [x] repository.
• xbuild.sh: ISO build script.
• xbuildwsl.sh / xbuildwslc.sh: WSL tarball build scripts.
• ROADMAP.md: Project roadmap used as issue-sync source.

Detailed structure reference: Project Structure

---

Quick Start

Build the ISO

sudo pacman -S archiso
./xbuild.sh

Output: ./out/*.iso

Build for WSL

sudo ./xbuildwsl.sh

Output: ./out-wsl/x-YYYY.MM.DD.tar.gz (or .tar.zst when using xbuildwslc.sh).

---

Related Repositories

• x: scripts post install to set up xdev environment.
• x-repo: X package repository for x.
• xfetch: official getter for system information created on rust for X but now running in any distro.
• xpm: X package manager for x.
• xpkg: X packager for x developers.

Related Documents

• Project State
• Project Structure
• Build ISO Guide
• Build WSL Guide
• X Repository Guide
• Default Installation Guide
• Legacy WSL Guide
• Roadmap
• Code of Conduct
• Contributions
• Security
• Support

X

& &