- What: Arch + Hyprland + custom Quickshell UI. Bar, launcher, panels, theming — all integrated.
- Install: 1 command (below). Update with
archeclipse. - Try first:
SUPER + W= wallpapers. Full keys: bind.lua.
Need: Arch / Arch-based + Hyprland + Python 3. Rest is auto-installed.
python3 <(curl -fsSL https://raw.githubusercontent.com/AymanLyesri/ArchEclipse/refs/heads/master/.config/hypr/maintenance/install.py)archeclipse # update anytime (zsh fn → runs maintenance/update.py)| Need | How |
|---|---|
| Bar | Modular widgets: workspaces, bandwidth, weather, player, tray, crypto |
| Launcher | App search + clipboard + emoji + calc + URLs + custom cmds. No Rofi. |
| Right panel | Player, notifications, calendar, crypto, anime viewer |
| Left panel | Chatbot, booru browser, manga reader (WIP), keybinds, settings |
| Theming | Wallpaper → full system colors. Light/dark toggle. Hot-reload. No manual edits. |
Stack: QML/QtQuick (Quickshell) · Python 3 + Bash · C (perf utils) · Hyprland/Wayland
| Workspace | Opens |
|---|---|
| W2 / W4 / W5 / W6 / W7 / W10 | Browser / Spotify / Btop / Discord / Steam / Games |
| W1, W3, W8, W9 | General |
Apps auto-launch to their workspace at login.
- Avatar:
$HOME/.face.icon - Wallpapers:
SUPER + W→ picker. Add yours to$HOME/.config/wallpapers/custom - Hyprland tweaks:
$HOME/.config/hypr/config/custom - Laptop: install
upowerfor battery - Keys: bind.lua or Left Panel in-app
How it works — architecture, theming, widgets (click to expand)
One idea: UI + scripts + theming ship as one product. Not random dotfiles.
graph TB
subgraph Install["Setup & maintenance"]
Installer["install.py / update.py<br/>Python installer"]
Pacman["components/packages.py<br/>embedded package list"]
Archeclipse["archeclipse() zsh fn<br/>update wrapper"]
end
subgraph Hypr["Hyprland — window manager (Lua)"]
HyprMain["hyprland.lua<br/>entry point"]
HyprConfig["config/*.lua<br/>bind, animations, monitor,<br/>windowrule, gesture, input"]
HyprScripts["scripts / scripts-c<br/>screenshot, screenrecord,<br/>brightness, clipboard, wallpaper-loop"]
WallpaperDaemon["wallpaper-daemon<br/>hyprpaper / mpvpaper"]
Evremap["evremap<br/>key remapping service"]
end
subgraph QS["Quickshell shell (QtQuick + QML)"]
Shell["shell.qml<br/>ShellRoot bootstrap"]
subgraph BarSys["Bar system"]
Bar["Bar.qml<br/>state machine:<br/>default/search/control/<br/>volume/brightness/recording"]
BarIslands["islands/<br/>SearchIsland, ControlIsland,<br/>PlayerIsland, WallpaperIsland,<br/>WeatherIsland, RightIsland"]
BarSub["bar widgets<br/>Battery, Volume, Bandwidth,<br/>Brightness, Player, Recording"]
end
AppLauncher["LauncherPanel.qml<br/>quickshell launcher +<br/>clipboard + emoji + notes"]
subgraph Panels["Side panels"]
LeftPanel["leftPanel/<br/>Settings, ChatBot,<br/>BooruViewer, MangaViewer,<br/>KeyBinds, UserProfile"]
RightPanel["rightPanel/<br/>Calendar, Notifications,<br/>SystemResources, Crypto, Waifu"]
end
subgraph Core["Core layers"]
Widgets["widgets/shared/<br/>reusable QML components"]
Services["services/<br/>BarState, Brightness,<br/>ScreenRecorder, Ipc,<br/>Supabase, Weather"]
Utils["utils<br/>SettingsUtils, MonitorUtils,<br/>TimeUtils, WindowManager"]
Theme["theme/<br/>Theme.qml + GlobalTheme<br/>typed config & styling"]
end
subgraph NativeScripts["Native/companion scripts"]
CLoops["*.c loops<br/>system-resources, bandwidth,<br/>keystroke visualizer"]
PyScripts["*.py<br/>chatbot, booru, manga,<br/>crypto, auth-callback"]
ShScripts["*.sh<br/>get-wallpapers, translate,<br/>get-keybinds, image-color"]
end
end
subgraph Backend["External services"]
Supabase[("Supabase<br/>auth + RLS + settings sync")]
APIs[("Booru / manga / crypto /<br/>weather / chatbot APIs")]
end
Installer --> Pacman
Installer --> HyprMain
Archeclipse --> Installer
HyprMain --> HyprConfig
HyprConfig --> HyprScripts
HyprConfig --> WallpaperDaemon
HyprConfig --> Evremap
HyprMain -- "spawns/execs" --> Shell
Shell --> BarSys
Shell --> AppLauncher
Shell --> Panels
Shell --> Core
Bar --> BarIslands
Bar --> BarSub
BarIslands -.->|opens| AppLauncher
Widgets --> Core
LeftPanel --> Widgets
RightPanel --> Widgets
BarSys --> Widgets
Core --> NativeScripts
Utils --> Services
Services -->|"auth, settings sync"| Supabase
NativeScripts -->|"HTTP calls"| APIs
Theme -.->|styles| Shell
classDef install fill:#EEEDFE,stroke:#534AB7,color:#26215C
classDef hypr fill:#E1F5EE,stroke:#0F6E56,color:#04342C
classDef qs fill:#FAECE7,stroke:#993C1D,color:#4A1B0C
classDef core fill:#E6F1FB,stroke:#185FA5,color:#042C53
classDef ext fill:#FAEEDA,stroke:#854F0B,color:#412402
class Installer,Pacman,Archeclipse install
class HyprMain,HyprConfig,HyprScripts,WallpaperDaemon,Evremap hypr
class Shell,Bar,BarIslands,BarSub,AppLauncher,LeftPanel,RightPanel qs
class Widgets,Services,Utils,Theme,CLoops,PyScripts,ShScripts core
class Supabase,APIs ext
- Wallpaper → colors via Cwal (C PyWal, 10-50x faster).
- Auto-applies to Quickshell, terminal, UI. Zero manual edits.
- Per-workspace static / video wallpapers. Light/dark toggle. Hot-reload.
- Reactive QML via
shell.qml+ singletons (BarState,GlobalTheme,Supabase,Weather). - Bar slots swappable at runtime.
- Note: migrated from Eww/AGS on 2026-09-12. Old
~/ArchEclipse-AGS/~/agsv1folders are safe to delete.
Fuzzy search · clipboard history · emoji · calc · URL forward · custom cmds.
- Right: media, notifications, calendar, script runner, crypto, Danbooru/Gelbooru viewer.
- Left: chatbot (multi-API), booru browser, MangaDex reader (WIP), live keybinds, Hyprland/Quickshell settings.
Python installer = deps + dotfiles + packages. One command in, archeclipse keeps you updated.
Preloaded layer-shell wallpaper daemon for Hyprland — replaces hyprpaper with instant, per-workspace wallpaper switching.
Light/dark theme applier for ArchEclipse — drives gsettings, the GTK/icon/cursor themes, and wallpaper color generation from one binary.
- Per-component docs (in progress)
- Gaming perf tuning (in progress)
- Ongoing polish
Bugs / ideas → open an issue or in Discord.
| Waifu · Player · Calendar · Notifications | Calendar · Player · Waifu · Resources |
|---|---|
![]() |
![]() |
| Chatbot | Booru |
|---|---|
![]() |
![]() |
| Settings | Keybinds |
|---|---|
![]() |
![]() |
SUPER + W → per-workspace static / video picker with live theming. Add yours to $HOME/.config/wallpapers/custom.
Coffee = more dev. Thanks.











