Skip to content
JROtto5Public

About

🐧 SITH OS: my own Arch Linux distro. archiso + Calamares installer, ~240 curated packages, 11 custom commands, themed end to end from bootloader to terminal.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Latest commit

Β 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Sith OS: The Dark Side of Linux

SITH OS

A custom Arch Linux distribution that ships a fully themed KDE Plasma desktop, from bootloader to terminal prompt, as an installable live ISO.

Release Arch Linux KDE Plasma 6 archiso Calamares License: MIT

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.

At a glance

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

Features

Full Boot Chain Theming

  • GRUB β€” Custom cyberpunk bootloader theme
  • Plymouth β€” Animated boot splash with pulsing Sith branding
  • SDDM β€” Themed login screen
  • KDE Plasma β€” Complete Cyber Neon desktop theme

Desktop Environment

  • 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

Terminal Experience

  • 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

Modern CLI Toolkit

eza Β· bat Β· dust Β· fd Β· fzf Β· zoxide Β· lazygit Β· yazi Β· glow Β· tldr

Eye Candy

cmatrix Β· lolcat Β· figlet Β· toilet

Gaming Ready

  • 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

Developer Ready

  • 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

System Protection

  • BTRFS automatic snapshots with Snapper
  • Boot-from-snapshot recovery via grub-btrfs
  • Firewalld firewall enabled by default
  • Fallback kernel (linux-lts)

Performance Optimized

  • Zram compressed swap
  • SSD TRIM automation
  • Tuned sysctl parameters
  • Parallel package downloads
  • Reflector mirror auto-ranking
  • Optimized makepkg for AUR builds

Custom Commands

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

Architecture

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

Building

Prerequisites

  • Arch Linux host system
  • archiso package installed
  • ~15GB free disk space
  • Internet connection (for package downloads)

Setup Local Repository

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.gz

Option 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 ..

Build

sudo mkarchiso -v -w ./work -o ./out ./archlive

You 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 /tmp as the work directory β€” it runs on tmpfs (RAM) and will run out of space. Use a disk-backed path like ./work instead.

The ISO will be output to out/sithos-YYYY.MM.DD-x86_64.iso

Test in QEMU

# UEFI mode (default)
./test.sh

# BIOS mode
./test.sh bios

Installation

  1. Flash the ISO to a USB drive:
    sudo dd if=out/sithos-*.iso of=/dev/sdX bs=4M status=progress
  2. Boot from USB
  3. The live desktop loads automatically with full theming
  4. Click "Install Sith OS" on the desktop, or run sithos-install in a terminal
  5. Follow the Calamares graphical installer

Color Palette

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

Technology Stack

  • 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

Skills Demonstrated

  • 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)

License

MIT


Peace is a lie. There is only passion.

About

🐧 SITH OS: my own Arch Linux distro. archiso + Calamares installer, ~240 curated packages, 11 custom commands, themed end to end from bootloader to terminal.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages