https://github.com/xscriptordev/xos
XOs Linux is a minimal Arch-based distribution with custom branding, a clean X identity, and reproducible ISO builds. This repository provides the full ArchISO profile, assets, and post-install scripts used to generate the official XOs image.
https://github.com/xscriptordev/xos
archiso archlinux branding custom distro iso linux linux-configuration lnux mkarchiso postinstall scripts tools xos
Last synced: 3 months ago
JSON representation
XOs Linux is a minimal Arch-based distribution with custom branding, a clean X identity, and reproducible ISO builds. This repository provides the full ArchISO profile, assets, and post-install scripts used to generate the official XOs image.
- Host: GitHub
- URL: https://github.com/xscriptordev/xos
- Owner: xscriptordev
- Created: 2025-10-16T10:34:25.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-12-14T10:16:17.000Z (3 months ago)
- Last Synced: 2025-12-16T12:37:57.918Z (3 months ago)
- Topics: archiso, archlinux, branding, custom, distro, iso, linux, linux-configuration, lnux, mkarchiso, postinstall, scripts, tools, xos
- Language: Shell
- Homepage: https://dev.xscriptor.com/xos
- Size: 18.1 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# XOs Linux
**XOs** is a custom Arch Linux–based distribution focused on simplicity, clean X branding, and reproducible builds.
This repository contains the full ArchISO profile and post-installation assets used to generate the official XOs ISO image.
> **Project status:** Under active development
---
## Overview
XOs aims to provide a minimal yet polished Arch-based system with its own identity and branding.
It is built entirely from official Arch repositories, using the standard `mkarchiso` workflow with a custom profile definition and post-install scripts.
---
## Project Structure
```
xos/
├── profiledef.sh # ArchISO profile definition
├── pacman.conf # Custom package configuration
├── packages.x86_64 # Package list for ISO build
├── airootfs/ # Root filesystem (customized ArchISO overlay)
│ ├── etc/
│ ├── root/
│ └── ...
├── root/
│ └── xos-assets/ # Branding, wallpapers, logos, postinstall scripts
│ ├── xos-postinstall.sh
│ ├── logos/
│ ├── backgrounds/
│ └── ...
├── build.sh # Automated build script
└── .gitignore
````
---
## Building the ISO
To build the XOs ISO image locally, ensure you have `archiso` installed.
```bash
sudo pacman -S archiso
````
Then run the included build script:
```bash
./xbuild.sh
```
The script will:
1. Unmount any stale mounts from previous builds.
2. Clean the `work/` and `out/` directories.
3. Run `mkarchiso` with the provided configuration.
4. Store the resulting `.iso` image inside `./out/`.
Example output:
```
out/
└── XOs-YYYY.MM.DD-x86_64.iso
```
---
## Post-installation Customization
After installing Arch via the generated ISO, execute the **XOs post-install script** to apply full system branding and configuration.
```bash
sudo /root/xos-assets/xos-postinstall.sh
```
This script:
* Rewrites `/etc/os-release` to identify the system as XOs Linux.
* Installs wallpapers, logos, and GDM/GNOME branding.
* Sets up post-install hooks and environment adjustments.
---
## Notes
* The repository ignores build outputs (`work/`, `out/`, logs) for cleaner commits.
* All configuration and assets required to reproduce the ISO are included.
* For development or debugging, you can modify files under `airootfs/` and rebuild.
---
## License
All build scripts and configuration files are released under the MIT License,
unless stated otherwise in subdirectories (e.g., artwork or third-party themes).
---
## Author
**Xscriptor**
[github.com/xscriptor](https://github.com/xscriptor)
---