Arch Linux · Hyprland · Quickshell
A Hyprland desktop, documented end to end.
ArchEclipse ships a Lua-configured Hyprland session, a Quickshell bar with launcher and side panels, wallpaper-driven colors and a one-command installer. These pages describe what is actually in the repository — paths, commands and defaults included.
Official install command
python3 <(curl -fsSL https://raw.githubusercontent.com/AymanLyesri/ArchEclipse/refs/heads/master/.config/hypr/maintenance/install.py)Requires Arch Linux (or a close derivative), Hyprland and Python 3.
~/.config
hypr/compositor + installer
hyprland.luaentry point
config/*.luabind, decoration, input
config/custom/machine-local overrides
maintenance/install.pyone-command setup
quickshell/archeclipse/bar + panels
shell.qmlshell bootstrap
services/state + IPC
widgets/bar, launcher, panels
wallpapers/defaults, custom, wallhaven
Overview
The desktop, in motion.
A 28-second tour of the bar, launcher, side panels, wallpaper picker and wallpaper-driven theming.
Explore the documentation
Start with installation, then work through configuration and theming.
Start here
Introduction
What ArchEclipse is, what it ships, and how this documentation is organised.
Getting Started
Configuration
Need help or have something to add?
The Discord is the fastest place to get help. Bugs and documentation corrections belong in GitHub issues.