A custom Arch Linux distribution that ships a fully themed KDE Plasma desktop, from bootloader to terminal prompt, as an installable live ISO.
Sith OS is built with archiso and packages a hand-crafted "Sith Cyberpunk" desktop into a bootable live ISO with a Calamares graphical installer. The theme covers every stage: GRUB, the Plymouth boot splash, the SDDM login screen, KDE Plasma and the terminal. It ships about 240 curated packages, a root-filesystem overlay of about 190 files (including 30+ preconfigured app and KDE configs in /etc/skel), and 11 custom sith-* / sithos-* commands.
| What it is | An archiso profile (archlive/) that is the distro: package list, pacman config, boot configs and a root-filesystem overlay |
| Output | A hybrid BIOS/UEFI live ISO: out/sithos-YYYY.MM.DD-x86_64.iso |
| Install path | Live desktop, then the Calamares installer, then a first-boot personalization wizard |
| CI | A GitHub Actions workflow (.github/workflows/build-iso.yml) runs mkarchiso in a privileged archlinux container on version tags and uploads the ISO as an artifact |
- GRUB β Custom cyberpunk bootloader theme
- Plymouth β Animated boot splash with pulsing Sith branding
- SDDM β Themed login screen
- KDE Plasma β Complete Cyber Neon desktop theme
- KDE Plasma with Cyber Neon color scheme
- Kvantum Qt theme engine
- Breeze window decorations with Sith color accents
- Papirus-Dark icon theme
- 4 virtual desktops: KORRIBAN, MALACHOR, DROMUND, EXEGOL
- KWin effects: blur, glide, wobbly windows, magic lamp
- 5 curated cyberpunk wallpapers
- Kitty terminal with translucent Sith color scheme
- Starship prompt with custom Sith Cyberpunk palette
- Fastfetch with Sith pyramid ASCII art and Star Wars-themed labels
- btop with custom Sith Cyberpunk theme
- Conky desktop HUD with GPU monitoring and Sith quotes
- CAVA audio visualizer with purple-to-cyan gradient
- lazygit, yazi, bat β all themed to match
eza Β· bat Β· dust Β· fd Β· fzf Β· zoxide Β· lazygit Β· yazi Β· glow Β· tldr
cmatrix Β· lolcat Β· figlet Β· toilet
- Steam + Proton pre-installed
- Lutris for GOG/Epic/other launchers
- MangoHud FPS overlay
- GameMode automatic performance optimization
- Wine Staging for Windows apps
- 32-bit Vulkan/Mesa support
- Docker + Docker Compose
- Python, Node.js, Rust (rustup), Go, CMake
- Git with delta side-by-side diffs
- Neovim with Sith Cyberpunk theme
- Paru AUR helper pre-installed
- BTRFS automatic snapshots with Snapper
- Boot-from-snapshot recovery via grub-btrfs
- Firewalld firewall enabled by default
- Fallback kernel (linux-lts)
- Zram compressed swap
- SSD TRIM automation
- Tuned sysctl parameters
- Parallel package downloads
- Reflector mirror auto-ranking
- Optimized makepkg for AUR builds
| Command | Description |
|---|---|
sith-fetch |
Custom system info display with Sith pyramid ASCII art |
sith-theme |
Apply or reset the Sith Cyberpunk theme |
sith-wallpaper |
Cycle through or select curated cyberpunk wallpapers |
sith-showcase |
Automated desktop showcase / screenshot tour |
sithos-welcome |
Interactive welcome app with system overview |
sithos-install |
Launch the Calamares graphical installer |
sithos-first-boot |
One-time post-install personalization wizard |
sithos-hwdetect |
Detect GPU and recommend/install appropriate drivers |
sithos-drivers |
Driver manager: GPU auto-config, NVIDIA install/remove, NVIDIA-on-Wayland, Bluetooth/printer support, fwupd, video acceleration |
sithos-maintain |
System maintenance: updates, cache cleanup, snapshots |
sithos-setup-sounds |
Configure desktop sound theme on first boot |
sith-os/
βββ archlive/ # archiso profile
β βββ profiledef.sh # ISO metadata & build config
β βββ packages.x86_64 # ~240 curated packages
β βββ pacman.conf # Package manager config
β βββ airootfs/ # Root filesystem overlay
β β βββ etc/
β β β βββ skel/ # Default user home template
β β β β βββ .config/ # 30+ themed app & KDE configs
β β β β β βββ kitty/ bat/ btop/ cava/
β β β β β βββ conky/ fastfetch/ lazygit/
β β β β β βββ nvim/ yazi/ tmux/ Kvantum/
β β β β β βββ gtk-3.0/ autostart/
β β β β β βββ ...
β β β β βββ .local/ # Plasma theme, color scheme
β β β β βββ .bashrc # Themed shell with modern CLI
β β β βββ calamares/ # Graphical installer config
β β β β βββ settings.conf
β β β β βββ branding/
β β β β βββ modules/
β β β βββ sddm.conf.d/ # Display manager config
β β β βββ plymouth/ # Boot splash config
β β β βββ sysctl.d/ # Kernel tuning parameters
β β β βββ pacman.d/ # Mirrorlist & hooks
β β β βββ systemd/ # Service enablement
β β β βββ xdg/ # XDG autostart entries
β β βββ usr/
β β βββ share/
β β β βββ sddm/themes/cyberpunk/
β β β βββ plymouth/themes/cyberpunk/
β β β βββ wallpapers/sithos/
β β β βββ sithos/ # Branding assets
β β β βββ icons/ # Icon overrides
β β βββ local/bin/ # 11 custom Sith OS commands
β βββ grub/ # GRUB bootloader config
β βββ syslinux/ # BIOS boot config
β βββ efiboot/ # UEFI boot config
βββ .github/workflows/ # CI: ISO build on version tags
βββ docs/ # README images
βββ build.sh # ISO build script
βββ test.sh # QEMU test script
βββ CONTRIBUTING.md # Contributor guide
βββ LICENSE # MIT License
βββ README.md
- Arch Linux host system
archisopackage installed- ~15GB free disk space
- Internet connection (for package downloads)
The build requires a local package repository containing Calamares, paru, and chaotic keyring packages. You can either download the pre-built repo from the latest release, or build it yourself:
Option A β Download pre-built (recommended):
git clone https://github.com/JROtto5/sith-os.git
cd sith-os
# Download localrepo.tar.gz from the latest release
gh release download v1.0.0 --pattern 'localrepo.tar.gz'
tar xzf localrepo.tar.gzOption B β Build from scratch:
git clone https://github.com/JROtto5/sith-os.git
cd sith-os
mkdir -p localrepo
# Install paru (AUR helper) if not already installed
sudo pacman -S --needed base-devel
git clone https://aur.archlinux.org/paru.git /tmp/paru-build
cd /tmp/paru-build && makepkg -s
cp /tmp/paru-build/paru-*.pkg.tar.zst ~/sith-os/localrepo/
cd ~/sith-os
# Get Calamares from Chaotic-AUR (or build from AUR)
# Option 1: Setup Chaotic-AUR temporarily
./setup-chaotic-aur.sh
sudo pacman -Sw --cachedir localrepo/ calamares chaotic-keyring chaotic-mirrorlist
# Build the repo database
cd localrepo
repo-add sithos-local.db.tar.gz *.pkg.tar.zst
cd ..sudo mkarchiso -v -w ./work -o ./out ./archliveYou can also run sudo ./build.sh, a wrapper that does pre-flight checks first (root, archiso installed, local repo present, free disk space). Note that it uses /tmp/sithos-build as its work directory, so check the tmpfs note below before you use it.
Note: Do not use
/tmpas the work directory β it runs on tmpfs (RAM) and will run out of space. Use a disk-backed path like./workinstead.
The ISO will be output to out/sithos-YYYY.MM.DD-x86_64.iso
# UEFI mode (default)
./test.sh
# BIOS mode
./test.sh bios- Flash the ISO to a USB drive:
sudo dd if=out/sithos-*.iso of=/dev/sdX bs=4M status=progress - Boot from USB
- The live desktop loads automatically with full theming
- Click "Install Sith OS" on the desktop, or run
sithos-installin a terminal - Follow the Calamares graphical installer
| Name | Hex | Usage |
|---|---|---|
| Deep Void | #080112 |
Primary background |
| Dark Purple | #0f031e |
Secondary background |
| Sith Purple | #1a0535 |
Tertiary background |
| Neon Purple | #b400ff |
Primary accent |
| Sith Red | #ff0033 |
Alerts |
| Hot Pink | #ff0050 |
Cursor / highlights |
| Neon Cyan | #00ffc8 |
Secondary accent |
| Amber | #ffaa00 |
Warnings |
| Lavender | #e6dcff |
Primary text |
- Build system: archiso (mkarchiso)
- Desktop: KDE Plasma 6 / Wayland
- Display manager: SDDM
- Installer: Calamares
- Boot splash: Plymouth (custom script theme)
- Bootloaders: live ISO boots via syslinux (BIOS) and systemd-boot (UEFI); the installed system uses GRUB
- Audio: PipeWire
- Shell: Bash + Starship prompt
- Theming: Kvantum, Breeze, custom KDE color scheme
- Snapshots: Snapper + grub-btrfs
- Firewall: Firewalld
- Linux systems engineering (initramfs, bootloaders, systemd services)
- Desktop environment packaging and distribution
- Shell scripting and automation
- UI/UX theming across 15+ applications
- Build system configuration (archiso/mkarchiso)
- System architecture and file system overlay design
- CI/CD pipeline with GitHub Actions (containerized Arch ISO build)
MIT
Peace is a lie. There is only passion.