Caelestia v2.5.1

What's New in v2.5.1

Features

• desktop: per-icon context menu (#883) (063f913)
• whatsnew: open the matching settings page from a feature (#884) (c52f2e4)
• bar: make clock component sizes responsive to bar scale (0055acd)
• add raise function to focus nexus in WindowFactory (f4e43eb)
• add status icons context menu popout (0eada35)
• dock hover window peak 500ms delay to prevent accidental flickers (df5f0a5)
• bar: add calendar popout for the clock (#812) (38ff740)
• network: manage multiple saved profiles for the same SSID (e3fe60b)
• scripts: download the default wallpaper pack during updates (95861de)
• nexus: add a manual light/dark mode selector to the colors page (d0818ca)
• ai: wire the chat history toggle (a750abe)

Performance

• overview: keep the wallpaper layer alive between opens (#900) (91d9f2e)
• gpu: never wake a suspended dGPU to measure it (#824) (6fa4f31)
• update: fetch metadata only, and cap the depth (b97d661)

Bug Fixes

• revert perf(overview): keep the wallpaper layer alive... for now (a287138)
• dashboard: revert smallweather and profile avatar size to original in favour of fonts drop (af4fc59)
• support WPA3 key-mgmt selection (13a349e)
• bar: let the calendar popout displace notifications like the others (#882) (200ea77)
• launcher: stop the app grid from crashing on stale desktop entries (a2af3b4)
• update: stop the tweak path from stomping user settings (55d79ab)
• systemd: install the update-checker units (d636aa7)
• switch to QStringList (bf42ce0)
• installer: add matugen helper library and integrate into distro installation scripts (9639637)
• i18n: clear dummy translations and fully translate Arabic (4e3a1a7)
• remove backticks from caelestia update in build-shell comment causing build errors (13ae4d6)
• bar: status icon dragging not working (67f6dfa)
• dock: re-add import quickshell in dock to fix dock crash (9bc230d)
• color: end a preview on an outcome and state smart from the shell (bcb206d)
• i18n: improve Spanish translations (#856) (8d6fca5)
• launcher: revert image and wallpaper changes, restore windows, keybinds, and animations (e304362)
• put appmenu on a diet (b284256)
• network: act on a saved profile from every network page (e614b35)
• network: act on the selected saved profile, not the SSID (2715f20)
• network: take the network down before a profile switch (d8fa387)
• installer: put the command directory on the session PATH (441674d)
• installer: drop the CLI check the packages step cannot satisfy (9a1042c)
• launch: keep only the bar launch routing changes per review feedback (7e47c9c)
• color: restore the desktop apply's name and the test env (afb892a)
• scripts: do not warn about our own missing checksum (903944b)
• installer: report a failed prebuilt download on stderr (f5a97a2)
• wallpaper: sort by perceptual colour distance as dominant colours load (876d7da)
• installer: stop pip-installing the legacy Python CLI (dc02fd9)
• arpc: point the Discord GitHub button at this repo (20daea5)
• shortcuts: launch the configured terminal instead of hardcoded foot (c01de53)
• keybinds: return the real keybind list from the property (f72f62c)
• nexus: make the global bar position win over per-monitor overrides (eff1c42)
• launch: route the remaining launches through the Launch module (8b1de8a)
• installer: report a failed prebuilt download on stderr (64c90b8)
• color: let a caller state smart mode instead of reading it back (d183816)
• color: make a color switch land at once and keep what the wallpaper picked (922c599)
• nexus: exempt the app info sub-page from the search audit (d2fa163)
• nexus: index the new claude cli setting for search (94c58a8)
• Remove Power management from caelestia and let kde settings manage it. (597e0de)
• aur: refuse to build without a source checksum (375b19b)
• ai: make the claude cli tool bypass opt in (229f292)
• plugins: pass index values to the install script as arguments (b2c361e)
• shell: pass secrets to secret-tool in the environment (c2164f5)
• ai: download the claude installer before running it (7404ea8)
• scripts: verify the todoist appimage download (0073e0b)
• scripts: validate the login screen sudoers rule (a674a37)
• scripts: download the ollama installer before running it (c9ed4b3)
• scripts: refuse unsafe prebuilt shell archives (37ab497)
• scripts: check the cava sdk archive before unpacking it (f103d27)
• installer: quote the shim paths in generated scripts (2bb72cb)
• installer: check the password without a shell or path lookup (282c9b1)
• installer: keep the cache directory and install log private (175b51e)
• installer: remove the shell from the cache cleanup (f3cd534)
• installer: harden privilege, download and uinput handling (7f0dd77)

Caelestia v2.5.0

What's New in v2.5.0

Features

• dock: show app badges on dock icons (7c29aee)
• services: add the launcher entry service (28e7aa6)
• components: port AnimatedRepeater from upstream (f8d21e2)
• config: type the workspace icon rules (f34fb65)
• ambient glow (#803) (ed689fd)
• settings: add QVariant union types (e7e4b15)
• lock: reveal the typed password from the greeter's leading icon (a68ec48)

Bug Fixes

• ensure caelestia env variables when systemd does not start the session (33e4541)
• sddm theme did not install when plasmalogin binary present too (5027841)
• services: read the idle timeout list through the typed list (6257448)
• settings: only convert a list write, not every mismatch (760f7d2)
• settings: accept a convertible type for a multi-type option (0666be5)
• settings: reject global option access from overlay layers (8921fee)
• nexus: open the clock format list upwards (0399552)
• dashboard: wrap long weather conditions (dc3da59)
• bar: stop reserving window icon space when maxWindowIcons is 0 (989cbaf)
• services: only list physical ethernet interfaces (d81ded3)
• bar: collapse a tray submenu that holds only separators (51697a4)
• bar: constrain audio device labels to a fixed popout width (5059c3d)
• filedialog: match filter suffixes case-insensitively (c8f4178)
• lyrics: bind hasLyrics to the signal that fires after it changes (42b7857)
• icons: settle each ask once and retry only a new window (0f28f10)
• installer: stop an unset HOME aborting the TUI (7d73e08)
• scripts: clear the lint failures keeping python-quality red (2e5121f)
• clipboard: settle a wipe once, whatever the signal order (0f1c0bc)
• weather: bound the forecast walk by the shortest array (149ff25)
• notifs: stop a cap of zero evicting the newest notification (1c6fd66)
• github: guard the contribution chain before dereferencing (b572a75)
• screenedges: push restored corners to KWin after a crash (f491a7c)
• icons: stop a failed icon lookup blocking a retry (7a0ff94)
• shortcuts: bind the new keys when gdbus cannot be spawned (985ff90)

Caelestia v2.4.3

What's New in v2.4.3

Features

• color: render a generated palette at a chosen intensity (#791) (7f91352)
• better network selection popup row (b42cfb6)
• i18n: add Spanish translation (d06438c)
• single source of icons for all drawers (a3cad98)
• add advanced color page back (432376c)
• emoji-db now reads emojis from kde directly (9320556)
• app right click menu in launcher and separate dock pinned app list (4b88ee1)
• per workspace apps and window preview on dock (4755c30)
• installer: register the window rules step (b2a8cc2)
• apply window rules for opacity, dialogs and picture-in-picture (949c9fb)
• services: offer temperature and data sizes as unit enums (7e0fc67)
• plugin: render enum values as names and guard saveItem (2a83804)
• lock: toggle password visibility (3d95adb)
• bar: add clock seconds and workspace visibility options (b16aac1)
• cli: say how to start the shell without logging out (39b71c1)
• package: the fonts move from the package to the install (31befaf)
• install: the login screen comes from the package (03beee3)
• package: ship the user's half, and clone the tag for it (9d5230e)
• install: start the shell from one systemd unit (fa7fb99)
• cli: apply the user's half from a packaged install (92b0569)
• install: pass the install kind to the step scripts (2ed8aa5)
• login: configure Plasma Login's greeter as well as SDDM's (5b22820)
• bar: make the status icons an ordered list in the config (c247123)
• utilities: add the game mode quick toggle (f95f7f1)
• nexus: add the featured wallpaper tile (d3ecd4a)
• bar: use upstream's displayType for the workspace indicator (3f0b8c4)
• bar: let bar.workspaces.ignoredTags decide which windows get an icon (0f22f96)
• aur: ship the command, the palette data, the lock screen and the effect (fdc5cbf)
• color: apply the palette to the desktop instead of handing it to a daemon (b9548b8)
• color: generate the palette ourselves with matugen (a6956ec)
• theme: add a matugen template for scheme.json (8607750)
• cli: add the caelestia dispatcher and its tests (f15f860)
• commands toggle in launcher (80185a1)
• consistancy for click & hover effects (54444b7)
• buttons now follow one base animation (2d14934)
• animation consistency in codebase (0b27815)

Performance

• storage: collect disks off the GUI thread (36f4f27)
• gpu: probe usage and name without shell chains (c43f639)
• defer startup work and silence KDE Hyprland fallbacks (70bcc8f
• lower clock precision without breaking recorder (79b9011)
• stop the logo animations while their window is off screen (8ad9894)
• only hold the audio analysis services while the shapes are shown (0335db5)
• stop analysing digital silence in the visualiser (a8e067b)

Bug Fixes

• resolve the sourced-from directory at source time (6b44a65)
• osd: keep the brightness icon on the brightness slider (#744) (194f4e3)
• color: hold the intensity slider until the render lands (36465d4)
• installer: configure the TUI build from a clean directory (caecc0f)
• scripts: choose the package manager by distro, not by PATH (a77d02d)
• scripts: locate the sparse-checkout rules in a worktree (50d53db)
• scripts: require BUNDLE_DIR and read the distro directly (ae6e6fc)
• scripts: stop reading an unanswered install kind as a checkout (5010fcd)
• installer: guard the CAVA SDK fetch and move Darkly to its own module (af3f14e)
• uninstall: source the shared helpers instead of shimming them (8ab9cf9)
• lib: report an unresolvable install directory (6de70c)
• uninstall: remove only installed packages, via the shared helpers (672b50a)
• uninstall: only hand installed packages to the package managers (b1bcda4)
• scripts: keep the update path's package check and submodule abort (d221209)
• scripts: use caelestia_sudo in setup.sh and the KDE deploy step (c50e08d)
• installer: stop repeating Darkly and CAVA work on updates (854ecb1)
• do not remove system level pkgs during uninstallation (64c80ad)
• call packages.sh from build-shell directly to ensure everything is uptodate ([3cb8ed6](3cb8ed67a6d90ff1a97a4edc43e43...

Caelestia v2.4.2

What's New in v2.4.2

Features

• update whatsnew entries (ab3933c)
• install the SDDM theme by default (6e919c7)
• notification multi monitor support and mute when fullscreen (6d2d0e6)
• window switcher addons (#710) (44f97dd)
• audio reactive material shape to desktop addons (41c8ed8)
• add whatsnew shortcut, ipc handler and launcher action (ce81302)
• track whatsnew acknowledgement by revision (34c28e4)
• cava prebuild integration (a693664)
• add per-monitor taskbar position in Nexus settings (f29441d)
• gate GIF recorder behind a config toggle (default off) (44054da)
• add SDDM theme as optional installer module (e4a91ce)
• add GIF recording option and fix drag-reorder bug (1aa315d)

Performance

• fluid window switcher (c540f42)
• cache window previews thumbnails to load them instantly (752f9a4)

Bug Fixes

• add missing dependencies (73a48f5)
• remove unlinked submodule (#722) (63d53e4)
• build libcava from AUR for the prebuilt shell asset (#674) (fc16683)
• fix bug in installer UI (ec16651)
• avoid shell interpolation in inhibitor handling (2216312)
• address remaining review findings (007ec20)
• bar unhiding a little when switching workspaces with dodgeFocusedWindows (87e1bda)
• correctly identify arch for libcava installation (1490824)
• rename conflicting whatsnew window methods (31334d4)
• update shell restart method (9ed3d2c)
• report non-fatal SDDM theme problems as WARN, not FAILED (693edd1)
• address second round of review feedback (708b094)
• show GIF recordings in RecordingList (e5b12ea)
• use delegateWrapper dims to avoid reparent rebind in drag fix (5cf6a07)
• address review feedback for SDDM theme integration (4c8c591)
• address review comments (104ee3e)
• prune the deleted submodules from local git (0b8e5ee)

Caelestia KDE v2.4.1

What's New in v2.4.1

Features

• Troubleshooting for update issues (7349b97)
• greeter addons (#682) (e543de2)
• DodgeWindows now works on both monitors + a typeerror fix (1af13e8)
• network popout sections and related warn scene fixes (6768cde)
• Weather.cpp service used by Lockscreen and Weather.qml (dd3db19)

Bug Fixes

• lockscreen Authentication timeout (93f4f07)
• Include missing dependencies for fedora and ubuntu with a autoverifying workflow (7d8a77a)
• include missing dependencies (d3793e1)
• color page now have variants tuning and more options in advanced settings (74ff5b0)
• simpilfy dodgewindow logic to work for multiscreen setups (3ca09ae)
• Clipboard now correctly displays high res img and blank img race condition gone (412dcb1)
• Workspace tracker correctly parse desktop signal and multimonitor swipe isolation (51b92c4)
• hook fingerprint config with shell.json (2430f68)
• remove unreliable clear notification timer and qml lint conventions followed (6955208)
• CAELESTIA_FORCE_BUILD_SHELL = true until correct fix found (44b5be9)

May your desktop always reflect the stars.

Caelestia KDE v2.4.0

What's New in v2.4.0

Features

• lockscreen ui update + new screenshots (3c5a64c)
• lockscreen ui improvs (a8bd8d2)
• lockscreen integration with nexus (a09e960)
• add KDE lock screen greeter (#600) (eda9f32)
• use prebuilt shell artifacts instead of compiling (fdd8a35)
• synchronize translations with Crowdin (#603) (e9f5717)
• drag windows between screens in the overview (#549) (f3ebe5d)
• implement AudioBackend plugin for filtering inactive audio devices (#584) (249f62b)
• lockscreen update (d79453d)
• use KDE XDG categories and show only populated ones in launcher (#219) (bdc2043)
• add grid view and categories to launcher app browser (#219) (c299e78)
• add setCursorPos utility function to CUtils class (e55a39e)
• replace hand-rolled search bars with SearchBar component (d010bea)
• match upstream look & feel across shell (77b14e2)
• align nexus search and nav-pane design with upstream (7bbcb08)
• port Weather refinements and VPN provider management UI (c61db2c)
• port upstream VPN provider management (a65a8cf)
• port upstream 'inhibit idle when charging' and reconcile drift (adb4c4a)
• port meaningful upstream improvements (PAM howdy, DDC brightness, VPN metrics) (ba01585)
• bring ScreenState and ShellState from upstream (1109231)
• complete Config rewrite on the Settings node system (203e535)
• finish config rewrite structural conversion (0bfb117)
• convert config headers to the Settings node system (b6b5bbd)
• config rewrite scaffolding and first headers (0951a8b)
• vendor upstream Settings subsystem and caelestia-util (5d4eb90)
• vendor upstream assets, service loader, and status components (9afa59e)
• port NetworkUsage to a C++ TickingService (53dc568)
• wire network pages into the shell with NmQt backend (89f65ca)
• bring upstream network pages from caelestia-dots/shell (9ff4656)
• add upstream-sync process tooling and docs (5526964)
• add session page and expose homeless settings (5b17b2f)
• add lock screen settings with wallpaper sync (a3db486)
• apply desktop wallpaper to lock screen too (8451cd8)
• disable compiling darkly by default & add gtk theme (32004a8)
• add bundled fonts (28bacf3)
• enhance text ui wording (8043cba)
• bundle SF Mono and make it the default monospace font (267a4d6)
• add font selector with San Francisco Pro default (8bf886d)
• remove KDE panels so the shell takes over (a3ca50e)
• redesign appearance page with light/dark color lists (232d25b)
• simplify color theming pages (25708f8)
• plugin system (#546) (0314253)
• import new dharmx walls by default (d58accd)
• add UI translations with English and Turkish (e015f67)
• installer refresh mirrors as a TUI step (edb66ed)
• give each monitor its own workspace (fdcf21c)
• installer unified entry point for install, update, and uninstall (b2c662b)
• installer wizard flow with profiles, review screen, and live log view (5f1c73d)
• installer brand palette, text status markers, and profile menu data (a2948b7)
• show integrated GPU stats in the performance section (ace0640)
• animate show/hide desktop button (6ce9681)
• add unified optional-component installer (db12683)
• typed workspace query on the KWin bridge (bc7d9e3)
• right-click the EasyEffects toggle to open the application (57ef577)
• wire up slider row to audio and network popouts (e7b77a7)
• App-specific audio and network popouts (7a4ea8d)
• add an EasyEffects quick toggle (bb0c080)

Performance

• stop the updater asking for passwords and hogging every core (36bc8f1)

Bug Fixes

• build libcava from AUR for the prebuilt shell asset (#674) (fc16683)
• fix bug in installer UI ([ec16651](ec16651...

Caelestia KDE v2.3.2

What's New in v2.3.2

Features

• Add microphone and combined audio recording options with improved IPC control in backend (4cc29f7)
• Per-window screenshot (#516) (1316af7)
• Add window-outline selection mode and Spectacle integration to screenshot tool (f612806)
• Text recognition in screenshot toolbar (#512) (83c6327)
• Better shell restart (afe3d4e)
• Add media filtering options to wallpaper selector (7782b50)
• Add update popout (795cc7a)
• Add update icon in taskbar (9b5fa56)
• whatsNew window for new features (#491) (a067752)
• Add install.sh script for one-line installation (d914382)
• Expose KWin virtual-desktop rows property to QML (73a6223)

Bug Fixes

• Menu background color now follows shell color (bf6207b)
• Persistence settings and hover tooltip (d617a0e)
• Drawers now correctly open on the active monitor (#507) (bd90ab7)
• Use strict mode in ollama_setup.sh (#509) (f1518b9)
• GameMode always turned on if shell crashed while running a game (87711fc)
• Use absolute path for workspace tracker CMake installation to resolve directory context issues (e579fc2)
• Add check for existing Git commit before resetting repository state (bd8b893)
• Clicking empty workspace through overview opening previously focused app and QML lint errors fix (0e26c69)
• Animated wallpaper not playing after shell restart (58155ce)
• Add timeout to color scheme change so it does not get stuck during installation (d019e2c)
• Add update indicator to bar and popouts (8289ff0)
• Keep Alt+F4 off the shell and give focus back when a drawer closes (#495) (4b45c74)
• Revert to 5 desktops (e1b59fa)
• Ccache swap (a34743f)
• Fix update checker to use correct version number for updates (b4813db)
• Remove tmux pane width cap and reassertion (836cc87)
• fetchInitialState now populates rows (c5ddddc)
• Stop asking for a screencast while QML is still building the caller (056fcb6)
• Make sidebar easier to grab and drag (f68e77c)
• Cap bar popouts to screen size and add scrolling (cc1593b)
• Cap notification popouts at a configurable count (9f80a4d)
• Preserve existing virtual desktop configuration (cc8feac)
• Wait for update notification action clicks (48731b7)

May your desktop always reflect the stars.

Caelestia KDE v2.3.1

What's New in v2.3.1

Features

• overview addons (#445) (280e2be)
• update workspace indicator color logic to account for swipe progress (1b1f439)
• workspace switcher trackpad polish (8a3a84f)
• add tweak to set default Caelestia color scheme to dynamic (20a5a0a)
• workspace swipe tracking for trackpads (#479) (19c6e6c)
• port nmcli to dbus (6e34fed)
• add requests suite of features (61d84c2)
• redesign settings pages for better organization and usability (64ce820)
• align distro packages and opt into Thunar files (5de6f8a)

Performance

• optimize notification state management and configurable total notification count cap (5d6a2bd)

Bug Fixes

• keep keyboard layout indicator in sync with KDE (#488) (330a5e5)
• update GitHub App token configuration to use client-id instead of app-id in workflow actions (516c18c)
• dock left click actions work correctly now by adding the missing focused state to KWinAcitveWindowBridge (3f9b662)
• right click menu not respawning when clicking on desktop (d051fb6)
• paginate dev branch commit list to avoid excessive height (b2a8dcc)
• wallpaper in right click menu not working (93c954d)
• recording widget not working (d6fdb92)
• handle cavaprovider being unavailable (5e2f925)
• screen recorder toggle not working (3a77a80)
• nmqt lazy construction can cause stale network state (58d4729)
• handle AP dectection and empty Ethernet connections in Nmcli (0605f1e)
• cava import (dff2338)
• reduce dbus polling frequency (979c2b9)
• qml violations (bdca426)
• fix build error (5b28b14)
• general bugfix pass (13ab5b8)
• rm duplicate syncPlasmaWallpaper() function (a229e65)
• reduce kpackagetool6 calls & centralize in packages.sh (442c76e)
• stop patching caelestia-cli & handle recording/screenshots with spectacle (5a94cba)
• plugin page colors (again) (f2002e5)
• ai assistant instructions text color (3f49c75)
• keep Nexus search bar above navigation (c49649d)
• preserve monitor workspace mock data (bc100f2)
• restore QML convention ordering (12ed3e3)
• plugin color page (c70a831)
• fix misleading plugin text (4614445)
• constrain AI setup popup (781dd6a)
• improve Plugins page text contrast (59079c4)
• expose Night Light quick toggle setting (272b399)
• cleanup Qt import call (51601ed)
• switch from reflector to cachyos-rate-mirror (6d42402)
• include Noto fonts in Arch install (f78b114)
• supervise the KWin window bridge (5557cc7)
• show active keyboard layout in bar (7a4baa8)
• run installer scripts through QProcess (c12b0b3)
• rebuild monitor mocks after hotplug (6c9f6aa)
• reconcile Night Color writes (d0983ba)
• preserve modified user configs (e1eacbd)
• queue context menu saves (573b2e8)

May your desktop always reflect the stars.

Caelestia KDE v2.3.0

What's New in v2.3.0

May your desktop always reflect the stars.

Caelestia KDE v2.2.4

What's New in v2.2.4

Features

• update emoji database path resolution to include local user directory and iterate over python versions (afbe1f2)
• implement CapsLock and NumLock state tracking in CUtils using KModifierKeyInfo (ea013e9)

Bug Fixes

• persist stolen shortcuts in destructor to prevent stale configuration after hot-reloading (2a072e1)
• enable recording timer increment by uncommenting connection logic (075d09c)
• correct desktop index mapping for active window tracking in KWin bridge (085e9fa)
• top panel trigger zone 5px -> 10px (361af0e)
• close taskbar preview thumbnails when their window closes (a9dfca7)
• add qmllint CI job and accessibility labels to key UI components (14bfa88)
• plugins placeholder, update-checker timeouts, dynamic python path, distro-aware news (40296d7)
• add xhr.onerror handlers to AI sidebar and set -e in setup.sh (1f28230)

May your desktop always reflect the stars.