Omarchy is a comprehensive, opinionated Linux desktop distribution built on Arch Linux with Hyprland as the tiling window manager and a custom Quickshell-based (Qt QML) desktop shell. It provides a polished, keyboard-driven user experience with extensive theming, a plugin system for shell widgets/panels/services, system management CLI tools (updates, migrations, hardware detection, package management), AI agent integration, clipboard manager, notifications, OSD, and more. The architecture is monolithic around a long-lived QML process, with shell scripts handling system-level operations. The repo includes a full installer, migration scripts, default configurations, and a manual. It is actively maintained with a large test suite and demonstrates strong engineering practices in its QML component library, IPC patterns, and guard evaluation system. While not a research project, it contains utility scripts for audio tuning and disk/network speed tests.
A Python 3.14+ CLI tool (stdlib only) for detecting malware in packages from the Arch User Repository. It scans currently installed AUR packages, historical pacman logs, systemd services, eBPF rootkit artifacts, and npm/bun/yarn/pnpm caches against configurable campaign-based threat lists (e.g., the June 2026 atomic-lockfile attack, CHAOS RAT 2025, Russian spam campaigns). The architecture is modular: campaign configuration is data-driven (JSON), the scanner is split into focused mixin classes (PackageMixin, SystemMixin, CacheMixin) combined via the AurScanner class, and all results are typed dataclasses. The package runs with zero external dependencies, has comprehensive unit tests, and includes an integration layer (pacman hook + systemd timer) for continuous monitoring. The code demonstrates high craftsmanship: strict typing, defensive I/O, locale-safe date parsing, cache-efficient file scanning, and a clean exit-code scheme based on Nagios conventions.
archinstall is a Python application and library for automated and interactive installation of Arch Linux. In production it runs as a root-level CLI/TUI wizard via the `archinstall` console script, guiding users through disk partitioning, LUKS/LVM encryption, BTRFS subvolumes, bootloader installation (systemd-boot, GRUB, limine), network configuration, user/sudo creation, mirror selection, pacman settings, and desktop/server profile installation. The same core is exposed as a reusable library, with entry points in `archinstall/scripts/guided.py`, `minimal.py`, and `only_hd.py`, and JSON configuration/credentials files enabling fully automated, headless installs. The installer orchestrates real system tools such as `parted`, `lsblk`, `pacman`, `systemd-nspawn`, `btrfs`, and `lvm`, and validates configuration with Pydantic and dataclass models.
Aura is a command-line package manager for Arch Linux and the Arch User Repository (AUR). It acts as a drop-in replacement for pacman, passing all pacman operations through unchanged while adding AUR-specific workflows: searching and building packages from the AUR, maintaining a local package cache for downgrades, taking JSON snapshots of installed package state for rollback, viewing and searching ALPM logs, identifying orphaned packages, analyzing licenses, and generating dependency graphs. The system integrates directly with pacman, makepkg, git, sudo/doas, shellcheck, and Graphviz, and uses a custom FAUR metadata server to query AUR package data efficiently. The primary implementation is a modern Rust workspace (aura-pm binary, aura-core library, and r2d2-alpm connection pool), with extensive localization via Project Fluent covering more than 20 languages. A legacy Haskell implementation remains in the repository but is superseded by the Rust rewrite, which is the actively maintained codebase.
Decman is a declarative package and configuration manager for Arch Linux that ensures system state matches user-defined specifications. It uses a modular architecture with a core application and plugins for managing different subsystems (pacman, AUR, systemd, flatpak). Users define their desired system state in Python files, and Decman executes these specifications to install/remove packages, manage files and directories, enable/disable services, and apply other system configurations. The system tracks its state in a JSON store to determine what changes are needed between runs, and provides hook functions for custom logic at various points in the execution lifecycle.
This repository repackages Anthropic's official Claude Desktop Linux .deb with a comprehensive set of Linux-native enhancements and community features. It applies 48 surgical JavaScript patches (compiled from Nim sources) to the minified Electron bundle, adding custom theme engine with 97 bundled dual light/dark palettes, multi-profile isolation, Quick Entry global hotkey, Computer Use desktop automation backends (X11, wlroots, GNOME, KWin portals), and an in-app Extra settings panel for themes, feature flags, and third-party inference configuration. The project produces packages for Arch (pacman), Debian/Ubuntu (APT), Fedora/RHEL (RPM), NixOS (flake), and AppImage, with automated CI that polls upstream every 2 hours, validates patch integrity, and publishes signed repositories. The architecture is a patch overlay on a third-party Electron desktop app. Patches are organized into three groups: linux (31 patches, always-on), core (7 patches, infrastructure), and community (10 patches, opt-in). A Nim-based build system compiles each patch into a native binary that performs regex-based transformations on the minified JS, with strict idempotency checks that fail the build if any pattern doesn't match. The patching system also handles upstream code-split chunks and concatenates/splits them as needed. The theme engine injects CSS custom properties via Electron's insertCSS, supports live reload via file watcher, and includes a full browser UI (theme picker SPA) with search, keyboard navigation, and wallpaper-driven generation via matugen. While the codebase demonstrates high engineering craftsmanship—consistent IPC validation, atomic config writes, robust fallback chains for Computer Use backends, and a reproducible build workflow with byte-identical artifact checks—it is tightly coupled to a single upstream app's minified bundle shape and DOM structure. The 48 patches are a significant maintenance burden that must be re-validated on every upstream release. However, the project is actively maintained, with automated CI catching most regressions, and several patterns (spinner injector, theme engine, config utilities) could be extracted for reuse in other Electron or web applications.
Paru is an AUR (Arch User Repository) helper and pacman wrapper written in Rust. It provides a command-line interface for searching, building, installing, and managing packages from both official Arch repositories and the AUR. The application features a modular architecture with distinct modules for configuration, dependency resolution, installation, and package operations. Key functionalities include interactive package selection, chroot builds, dependency handling, PGP signing, and configurable build options. Paru maintains pacman compatibility while extending it with AUR-specific features like development version tracking and local repository management.
This repository is a comprehensive, modular dotfiles collection for a bspwm-based desktop environment on Arch Linux. It provides 18 distinct visual themes ('rices') that consistently apply color schemes, wallpapers, and style options across a wide range of applications including terminals (Alacritty, Kitty, Ghostty, ST), status bars (Polybar, Eww), launcher (Rofi), notifications (Dunst), compositor (Picom), browser (Firefox), editor (Neovim), media player (MPV), and many others. The core architecture is a modular theme application system: a central script (`Theme.sh`) sources per-theme color variables and then runs individual module scripts (e.g., `05-alacritty.sh`) that generate or overwrite application configuration files. An installer (`RiceInstaller`) sets up the entire environment, and a GUI editor (`RiceEditor`) allows runtime customization. The repository also includes numerous utility scripts for hardware detection, wallpaper selection, weather display, network management, and media control, many of which demonstrate good engineering practices like caching, parallel processing, and atomic file updates. While tightly coupled to Arch Linux and X11, the modular theming pattern and several standalone scripts are reusable in other contexts.
ChimeraOS is a build system for creating a custom Arch Linux-based operating system image tailored for gaming consoles. It provides a set of shell scripts, configuration files, and GitHub Actions workflows to assemble a complete system image with Steam, RetroArch, gamescope, and other gaming-related packages. The build process uses a Docker container to create a reproducible environment, installs packages from Arch repositories and the AUR, applies custom configurations, and produces a compressed Btrfs image. The repository includes scripts for session management, hardware quirks, and system migrations, all designed to create a console-like experience on PC hardware. It is not a runtime application but a build toolchain, and the code is well-structured for its purpose, with several reusable utility scripts and migration patterns.
This repository contains a comprehensive set of Bash scripts to automate the installation and configuration of the Hyprland window manager on Arch Linux, along with associated desktop components (waybar, rofi, sddm, pipewire, fonts, GTK themes, etc.). The main entry point is `install.sh`, which presents an interactive whiptail-based menu to let users select desired features (NVIDIA setup, Bluetooth, Thunar, ZSH, dotfiles, etc.). It orchestrates over 30 modular sub-scripts in `install-scripts/` that handle package installation via pacman and AUR helpers, service enabling, configuration file copying (including the popular KooL Hyprland dotfiles from a separate repository), and system modifications. The codebase is well-structured for its purpose: it uses a centralized logging system, progress indicators, and a global functions library (`Global_functions.sh`) that encapsulates package installation and error handling. Additional utility scripts provide battery, disk, and temperature monitoring as optional systemd user services. The project is actively maintained with changelog updates and issue templates, though it is tightly coupled to the Arch Linux ecosystem and the KooL Hyprland dotfiles. It is not a reusable library but serves as a polished, user-friendly deployment tool for end-users.
ElysiaOS is a personal Linux desktop dotfiles and ricing repository, not a distributable operating system, an application server, or a data project. The repository contains a complete themed Arch Linux + Hyprland setup: window manager configs, Waybar status bars, EWW dashboard widgets, swaync notifications, rofi launchers, kitty terminal configs, SDDM login theme, Plymouth boot splash, icon/cursor/wallpaper assets, and an installer script that wires everything together. The dominant character is a heavily customized desktop environment tied to a single author's machine and anime-themed aesthetic.