A personal showcase of desktop tools built around Caelestia Shell, Quickshell, Hyprland, and niri.
This is the public source snapshot, not a supported module distribution. The installers patch a live Caelestia configuration and several modules reflect my own hardware and workflow. Read the scripts before running them and expect to adapt device names, paths, keybinds, and provider configuration.
| Module | What it demonstrates |
|---|---|
russian-srs |
Anki-backed Russian study CLI, typed JSON contract, audio/STT hooks, Quickshell panel, dashboard and lock-screen integration. |
translate |
Provider-based translation and screenshot OCR CLI with Groq, Tesseract, and offline echo providers plus Quickshell/WM integrations. |
caelestia-shim |
Compatibility patches and compositor abstraction for running Caelestia customizations across Hyprland and niri. |
hyprsunset |
Caelestia bar control for night-light state and temperature. |
sound-profile |
Speaker/headset profile switching, volume controls, and Hyprland startup integration. |
corectrl-profile |
Hardware-specific CoreCtrl/GPU profile toggle with memory-clock handling. |
modules/<name>/ self-contained source, assets, tests, and install scripts
scripts/ shared integration helpers
cli/ an intentionally unfinished module-manager experiment
The Python modules use uv; run their checks from the module directory:
cd modules/russian-srs
uv sync
uv run pytest -q
uv run ruff check
uv run pyright src testsmodules/translate uses the same workflow. Shell installers derive their
source tree from their own location and use $HOME for user configuration;
the QML backends resolve their CLI from PATH unless an environment override
is supplied.
The public tree intentionally excludes personal lesson decks, local agent harnesses, private machine orchestration, and Home Assistant integration. The Home Assistant setup lives in a separate private repository; only the generic desktop modules are represented here.
GPL-3.0-only. See LICENSE and NOTICE.md for upstream attribution.