Summary

Dusklinux/dusky offers Arch Linux dotfiles and a distro-like experience, targeting users seeking Arch's power and Hyprland's minimalism with simplified installation. It provides a polished, feature-rich desktop environment and extensive customization, aiming to feel as easy to install as a standard distribution while retaining Arch's core strengths.

How It Works

This project utilizes the BTRFS filesystem for its ZSTD compression and Copy-on-Write capabilities. Installation involves either overlaying dotfiles onto an existing Arch setup via a bare Git repository and a master ORCHESTRA.sh script, or a "Clean Slate" method automating setup from the Arch ISO. Hardware auto-detection is supported, with manual GPU environment overrides available. A rich utility set, managed via custom scripts and Rofi menus, covers system control, theming, and accessibility features like Speech-to-Text (STT) and Text-to-Speech (TTS).

Quick Start & Requirements

• Method 1 (Existing Arch Install - Recommended): Requires a fresh Arch Linux installation with BTRFS filesystem and Hyprland. Install Git, clone the repository (git clone --bare --depth 1 ...), deploy files (git --git-dir=... checkout -f), and run the master setup script (~/user_scripts/arch_setup_scripts/ORCHESTRA.sh). Expect 30-60 minutes for dependency compilation (AUR packages via paru).
• Method 2 ("Clean Slate" - New Installs): Uses the official Arch Linux ISO, automating partitioning and setup via pre-chroot and chroot orchestra scripts (001_ISO_ORCHESTRA.sh, 001_CHROOT_ORCHESTRA.sh) after initial Arch setup and internet connection. Post-reboot, run deploy_dotfiles.sh and ORCHESTRA.sh.
• Prerequisites: BTRFS filesystem is strictly required. Manual GPU environment configuration is possible via ~/.config/uwsm/env and ~/.config/uwsm/env-hyprland. Bootloader defaults to systemd-boot (UEFI) or GRUB (BIOS).
• Docs: Detailed Obsidian notes (~2MB) are included in the repo. Keybinds are accessible via CTRL+SHIFT+SPACE.

Highlighted Details

• Lightweight: Approximately 900MB RAM usage and 5GB disk footprint when fully configured.
• Performance optimizations include ZSTD/ZRAM compression and AUR packages built with CPU-native flags (up to 20% boost).
• Features fluid animations, instant shader switching via Rofi, and an automated Waydroid installer.
• Universal theming (Matugen) supports Light/Dark modes, catering to both GUI and terminal-centric workflows.
• Accessibility features include Speech-to-Text (Whisper/Parakeet) and Text-to-Speech (Kokoro).

Maintenance & Community

The project is maintained by a single individual, who notes being overwhelmed with support requests. A Discord server is available for installation help and troubleshooting. Extensive documentation is provided via included Obsidian notes.

Licensing & Compatibility

The license type is not specified in the provided README. No explicit compatibility notes for commercial use or closed-source linking are present.

Limitations & Caveats

A strict BTRFS filesystem dependency exists. The "Clean Slate" installation method is currently recommended only for Intel or Intel/Nvidia hardware, with AMD support planned for the future. As a configuration for a rolling release distribution, script failures are possible, though the system is designed to remain mostly functional. The single maintainer's bandwidth may impact support responsiveness.