GNU General Public License v3.0

项目介绍

AymanLyesri/ArchEclipse 是一个托管在 GitHub 上的开源项目,主要使用 TypeScript 编写,采用 GNU General Public License v3.0 许可证,目前获得 681 个 Star、40 次 Fork。

仓库全名
AymanLyesri/ArchEclipse
开源许可证
GNU General Public License v3.0
Star 数
681
Fork 数
40
未关闭 Issue
1

README 摘要

Overview https://github.com/user-attachments/assets/48210e9f-d21b-437d-ab72-445ba45b8a7d ArchEclipse Hyprland desktop that just works — daily-driven, fully themed, one-command install. TL;DR 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. Discord Community Stuck…

完整内容见 GitHub 原始 README 或本页 。

常见问题

ArchEclipse 用什么语言开发?

主要使用 TypeScript 编写,采用 GNU General Public License v3.0 许可证,目前有 681 个 Star。

ArchEclipse 可以免费商用吗?

仓库标注的许可证为 GNU General Public License v3.0,商用前请先阅读仓库 LICENSE 文件确认授权范围。

如何获取 ArchEclipse 的源码?

可以直接克隆仓库:git clone https://github.com/AymanLyesri/ArchEclipse.git,默认分支为 master;安装与运行步骤见仓库 README。

ArchEclipse 最近还在维护吗?

仓库最近一次更新为 1 周前,当前有 1 个未关闭 Issue;Star 数为 681,可作为社区活跃度的参考。

关于

Highly polished, performance-focused Arch Linux + Hyprland dotfiles with dynamic theming, custom widgets, and a fast, modern workflow.

描述取自 GitHub 官方 API,中文内容由 GitRead 中文社区 编辑团队整理。

简要分析

热度分
767
价值分
421
活跃状态
活跃

语言占比

CSS
GLSL
JavaScript
Lua
MDX
PLpgSQL
Python
QML
Rust
Shell
TypeScript

README

Overview

ArchEclipse overview

https://github.com/user-attachments/assets/48210e9f-d21b-437d-ab72-445ba45b8a7d


ArchEclipse

Hyprland desktop that just works — daily-driven, fully themed, one-command install.

Discord members


TL;DR

  • 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.

Discord Community

Stuck on install? Got a bug, an idea, or a screenshot to show off? The Discord is where it all happens.

Discord members

Fastest place to get help — faster than github issues, and the maintainer hangs out there.


Install

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)

What you get

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.


Essentials

  • Avatar: $HOME/.face.icon
  • Wallpapers: SUPER + W → picker. Add yours to $HOME/.config/wallpapers/custom
  • Hyprland tweaks: $HOME/.config/hypr/config/custom
  • Laptop: install upower for 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.

Architecture

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

Theming

  • 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.

Widgets (Quickshell / QML)

  • 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 / ~/agsv1 folders are safe to delete.

Launcher details

Fuzzy search · clipboard history · emoji · calc · URL forward · custom cmds.

Panels detail

  • Right: media, notifications, calendar, script runner, crypto, Danbooru/Gelbooru viewer.
  • Left: chatbot (multi-API), booru browser, MangaDex reader (WIP), live keybinds, Hyprland/Quickshell settings.

Deployer

Python installer = deps + dotfiles + packages. One command in, archeclipse keeps you updated.


Plugins

WallEclipse

Preloaded layer-shell wallpaper daemon for Hyprland — replaces hyprpaper with instant, per-workspace wallpaper switching.

WallEclipse overview

ColorEclipse

Light/dark theme applier for ArchEclipse — drives gsettings, the GTK/icon/cursor themes, and wallpaper color generation from one binary.

ColorEclipse overview


Roadmap

  • Per-component docs (in progress)
  • Gaming perf tuning (in progress)
  • Ongoing polish

Bugs / ideas → open an issue or come say hi in Discord.


Star History Chart


Visuals

Launcher

Application Launcher

Right Panel

Waifu · Player · Calendar · Notifications Calendar · Player · Waifu · Resources
Right Panel Layout 1 Right Panel Layout 2

Left Panel

Chatbot Booru
Chatbot Booru
Settings Keybinds
Settings Keybinds

Wallpaper Switcher

SUPER + W → per-workspace static / video picker with live theming. Add yours to $HOME/.config/wallpapers/custom.

Wallpaper Switcher

Lock

Lock Screen


❤️ Support

Coffee = more dev. Thanks.

Crypto addresses

₿ Bitcoin

1JisW9xeatCFadtgsenjbpCcFePZGPyXow

Ξ Ethereum / BSC

0x52d06d47bb9dc75eaf027f18cb197d5817989a96

评论

暂无评论