Skip to content
ArchEclipse

Common pages

↑↓to navigate↵to openescto close

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.

00:28
Click play to view the recording. Audio is muted by default.

Explore the documentation

Start with installation, then work through configuration and theming.

All documentation →

Start here

Introduction

What ArchEclipse is, what it ships, and how this documentation is organised.

Read introduction

Need help or have something to add?

The Discord is the fastest place to get help. Bugs and documentation corrections belong in GitHub issues.