{"id":34656667,"url":"https://github.com/xscriptordev/xos","last_synced_at":"2025-12-24T18:09:18.715Z","repository":{"id":319106257,"uuid":"1077499746","full_name":"xscriptordev/xos","owner":"xscriptordev","description":"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.","archived":false,"fork":false,"pushed_at":"2025-12-14T10:16:17.000Z","size":18981,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-16T12:37:57.918Z","etag":null,"topics":["archiso","archlinux","branding","custom","distro","iso","linux","linux-configuration","lnux","mkarchiso","postinstall","scripts","tools","xos"],"latest_commit_sha":null,"homepage":"https://dev.xscriptor.com/xos","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xscriptordev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-16T10:34:25.000Z","updated_at":"2025-12-14T08:49:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"b786671e-3506-40f1-8bda-c862009a6a50","html_url":"https://github.com/xscriptordev/xos","commit_stats":null,"previous_names":["xscriptor/xos","xscriptordev/xos"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/xscriptordev/xos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xscriptordev%2Fxos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xscriptordev%2Fxos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xscriptordev%2Fxos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xscriptordev%2Fxos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xscriptordev","download_url":"https://codeload.github.com/xscriptordev/xos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xscriptordev%2Fxos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28005981,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-24T02:00:07.193Z","response_time":83,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["archiso","archlinux","branding","custom","distro","iso","linux","linux-configuration","lnux","mkarchiso","postinstall","scripts","tools","xos"],"created_at":"2025-12-24T18:05:25.699Z","updated_at":"2025-12-24T18:09:18.706Z","avatar_url":"https://github.com/xscriptordev.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n\n# XOs Linux\n\n**XOs** is a custom Arch Linux–based distribution focused on simplicity, clean X branding, and reproducible builds.  \nThis repository contains the full ArchISO profile and post-installation assets used to generate the official XOs ISO image.\n\n\u003e **Project status:** Under active development  \n\n---\n\n## Overview\n\nXOs aims to provide a minimal yet polished Arch-based system with its own identity and branding.  \nIt is built entirely from official Arch repositories, using the standard `mkarchiso` workflow with a custom profile definition and post-install scripts.\n\n---\n\n## Project Structure\n\n```\n\nxos/\n├── profiledef.sh             # ArchISO profile definition\n├── pacman.conf               # Custom package configuration\n├── packages.x86_64           # Package list for ISO build\n├── airootfs/                 # Root filesystem (customized ArchISO overlay)\n│   ├── etc/\n│   ├── root/\n│   └── ...\n├── root/\n│   └── xos-assets/           # Branding, wallpapers, logos, postinstall scripts\n│       ├── xos-postinstall.sh\n│       ├── logos/\n│       ├── backgrounds/\n│       └── ...\n├── build.sh                  # Automated build script\n└── .gitignore\n\n````\n\n---\n\n## Building the ISO\n\nTo build the XOs ISO image locally, ensure you have `archiso` installed.\n\n```bash\nsudo pacman -S archiso\n````\n\nThen run the included build script:\n\n```bash\n./xbuild.sh\n```\n\nThe script will:\n\n1. Unmount any stale mounts from previous builds.\n2. Clean the `work/` and `out/` directories.\n3. Run `mkarchiso` with the provided configuration.\n4. Store the resulting `.iso` image inside `./out/`.\n\nExample output:\n\n```\nout/\n└── XOs-YYYY.MM.DD-x86_64.iso\n```\n\n---\n\n## Post-installation Customization\n\nAfter installing Arch via the generated ISO, execute the **XOs post-install script** to apply full system branding and configuration.\n\n```bash\nsudo /root/xos-assets/xos-postinstall.sh\n```\n\nThis script:\n\n* Rewrites `/etc/os-release` to identify the system as XOs Linux.\n* Installs wallpapers, logos, and GDM/GNOME branding.\n* Sets up post-install hooks and environment adjustments.\n\n---\n\n## Notes\n\n* The repository ignores build outputs (`work/`, `out/`, logs) for cleaner commits.\n* All configuration and assets required to reproduce the ISO are included.\n* For development or debugging, you can modify files under `airootfs/` and rebuild.\n\n---\n\n## License\n\nAll build scripts and configuration files are released under the MIT License,\nunless stated otherwise in subdirectories (e.g., artwork or third-party themes).\n\n---\n\n## Author\n\n**Xscriptor**\n[github.com/xscriptor](https://github.com/xscriptor)\n\n---\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxscriptordev%2Fxos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxscriptordev%2Fxos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxscriptordev%2Fxos/lists"}