$ show ublue-os/bazzite
Bazzite is a custom Fedora Atomic (Silverblue/Kinoite) operating system image optimized for gaming on desktops, handheld PCs (Steam Deck, ROG Ally, etc.), and HTPCs. It provides a SteamOS-like experience with pre-installed gaming tools (MangoHud, vkBasalt, OBS VkCapture), hardware support (OGC kernel, HDR/VRR, DisplayLink, per-device audio profiles), and a suite of system management utilities. The repository is not a traditional application but a build system for generating container images and ISOs. The architecture is container-native: images are built via Containerfile and GitHub Actions, with modular overlays for different variants (desktop, deck, nvidia) and desktop environments (GNOME, KDE). Key components include a justfile recipe library for user-facing configuration (ujust), systemd services, udev rules, RPM spec files with patches for upstream packages (BlueZ, UPower, Xwayland, MangoHud), and hardware detection scripts. The build process is fully automated via CI/CD, with image signing and attestation. The project is actively maintained with a large community and extensive hardware support.
The LLM identified 4 files worth highlighting for reuse:
A shell script that detects Valve hardware (Steam Deck) by checking DMI system information. It is used by multiple setup scripts (bazzite-hardware-setup, bazzite-user-setup) to conditionally apply hardware-specific configurations. The script is idempotent, well-structured, and can be extracted and reused in other projects that need to detect Steam Deck or similar hardware.
A justfile defining over 50 user-facing recipes (ujust) for system management tasks such as SSH configuration, GRUB settings, automounting, Tailscale, btrfs snapshots, Proton tweaks, and log collection. Each recipe follows a consistent pattern: sourcing ujust.sh for helper functions, using ugum for interactive prompts, and supporting enable/disable actions. This pattern is reusable for any project that wants to provide a consistent CLI interface for system administration.
A Python script that intercepts Flatpak transactions to warn users about unsupported app formats (e.g., JetBrains, VSCode) and redirect them to alternative installation methods (Brew, Toolbox, Bazzite DX). It uses a YAML configuration file (main.yaml) to define hooks and dialogs. The pattern of intercepting package manager transactions with user-friendly dialogs is reusable for other Linux distributions or custom images.
An RPM spec file for the jupiter-hw-support-btrfs package, which provides Steam Deck hardware support (SD card mounting, firmware updates, fan control). It applies multiple patches to upstream sources and includes conditional dependencies. The spec file demonstrates a clean pattern for packaging custom hardware support with patch management, which can be adapted for other hardware-specific packages.