All versions since v0.1.0
v0.1.0
First Pearl release for stable
v0.2.0
What’s Changed
- Fix tray popup icons by @VinnyQF in https://github.com/Seafoam-Labs/pearl/pull/31
- Taskbar order clean by @ZoeyErinBauer in https://github.com/Seafoam-Labs/pearl/pull/32
- bump version by @ZoeyErinBauer in https://github.com/Seafoam-Labs/pearl/pull/33
New Contributors
- @VinnyQF made their first contribution in https://github.com/Seafoam-Labs/pearl/pull/31
- @ZoeyErinBauer made their first contribution in https://github.com/Seafoam-Labs/pearl/pull/32
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.1.0...v0.2.0
v0.2.1
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.2.0...v0.2.1
v0.2.2
What’s Changed
- Fix duplicated login confirmation by @VinnyQF in https://github.com/Seafoam-Labs/pearl/pull/34
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.2.1...v0.2.2
v0.2.3
What’s Changed
- sys info widget by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/35
- drop req on app launcger by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/44
- add widget to allow cropping of wallpapers to fit size by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/45
- 28 pearl settings overview overview doesnt close itself when interacting with other windows by @VinnyQF in https://github.com/Seafoam-Labs/pearl/pull/37
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.2.2...v0.2.3
v0.2.4
Pearl 0.2.4 GTK 3 and GTK 4 apps now follow Pearl’s Material colors by default for new configurations. Existing preferences and opt-outs are preserved. Fixed GTK theme import ordering so Pearl’s colors apply correctly. Improved conflict handling for modified or symlinked GTK stylesheets. Arch and Devario packages now require Matugen 4.2 or newer. Updated release and Git package versions and metadata.
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.2.3...v0.2.4
v0.2.5
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.2.4...v0.2.5
v0.2.6
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.2.5...v0.2.6
v0.2.7
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.2.6...v0.2.7
v0.2.8
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.2.7...v0.2.8
v0.2.9
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.2.8...v0.2.9
v0.3.0
What’s Changed
- Greeter update by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/51
- Add sched_ext scheduler profiles by @arighi in https://github.com/Seafoam-Labs/pearl/pull/57
- new lock screen by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/58
- fix styling on overview by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/59
- edits too laptop power by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/62
- sched_ext widget restyling by @arighi in https://github.com/Seafoam-Labs/pearl/pull/61
- display management updates by @ZoeyErinBauer in https://github.com/Seafoam-Labs/pearl/pull/63
New Contributors
- @arighi made their first contribution in https://github.com/Seafoam-Labs/pearl/pull/57
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.2.9...v0.3.0
v0.3.1
What’s Changed
- sched_ext: Keep active profile across CPU hotplug and suspend/resume by @arighi in https://github.com/Seafoam-Labs/pearl/pull/64
- language and translation support by @ZoeyErinBauer in https://github.com/Seafoam-Labs/pearl/pull/67
- UI adjustments by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/71
- more ui adjustments by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/72
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.3.0...v0.3.1
v0.3.2
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.3.1...v0.3.2
v0.3.3
What’s Changed
- zip zippity zap by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/73
- Bug fixin by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/74
- the weatha by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/78
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.3.2...v0.3.3
v0.3.4
What’s Changed
- Dock updates by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/79
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.3.3...v0.3.4
v0.3.5
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.3.4...v0.3.5
v0.3.6 - zig 0.17
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.3.5...v0.3.6
v0.3.7
What’s Changed
- update how dock works again by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/80
- fix screen off on locking by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/81
- sched_ext: Edit scheduler profiles in Settings by @arighi in https://github.com/Seafoam-Labs/pearl/pull/65
- update layout of the apperance by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/82
- Update appearance layout by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/84
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.3.6...v0.3.7
v0.3.8
What’s Changed
- fix how zed themes are generated by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/85
- date time formatting for clock widget by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/86
- update audio badges by @caroberrie in https://github.com/Seafoam-Labs/pearl/pull/88
Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.3.7...v0.3.8
🦪 Pearl v0.3.9 — Screensavers, scx, and a More Personal Shell
🦪 Pearl v0.3.9 — Screensavers, scx, and a More Personal Shell
Pearl v0.3.9 is about making the desktop feel lived-in. It adds a full screensaver collection for the lock screen and the idle desktop, lets the dock live inside the bar, makes bar visibility and corner radius configurable per display, and shows album art in the media widget. Aqueous integration picks up the HDR 600 preset and window-rule timing, CPU scheduling now comes from scx’s catalog through scxcli, and Coral learns a much wider set of file types.
🌌 Screensavers
A native screensaver service now drives both the lock screen and the idle desktop, so the same animation runs before the panel powers off.
- 🕹️ Eight animations plus Off — Starfield, Matrix, Mystify, Pipes, Qix, Maze, Life, and Ocean Fall.
- 🔒 Lock and desktop — the lock swaps the saver over its prompt, while the shell maps it as an overlay above applications. Any input dismisses it.
- ⏱️ Separate panel-off delay — the saver starts at the turn-off timeout, then a second
panel_off_secondsdeadline powers the panel off. Zero keeps the panel lit while the saver runs. - ♿ Reduced motion — falls back to normal blanking instead of animating.
- 👀 Preview tooling —
scripts/preview-savers.shpreviews the collection, with the power page exposing the mode picker.
🧭 Bar, dock, and displays
- 🧩 Dock inside the bar — the dock is now available as a bar widget, so the application strip can live in a bar section instead of a separate floating surface. Embedded styling and sizing were finished alongside it. (#98, #100)
- 🖥️ Per-display bar visibility —
bar_hidden_outputsswitches the bar off for named connectors. A hidden bar releases its exclusive zone, hides an embedded dock, and Pearl refuses to hide the last visible bar even if the JSON lists every output. - ⭕ Configurable bar corners — a new
bar.radiuspreference overrides the theme’s 14 px radius. Leaving it at 14 lets community themes keep control. - 🎵 Album art on the media widget —
bar.media_artreplaces the music glyph with the current artwork, supports output overrides, and only registers as an artwork viewer while art is actually shown. (#109) - 🫥 Screensaver-aware visibility — bars and autohide respect the active screen saver instead of floating over it.
🖥️ Aqueous integration
- 🌈 HDR 600 preset — Pearl’s display settings and mutation backend expose the new 600 cd/m² HDR mastering level alongside 100, 400, and 1000.
- 🧩 Rule matching timing — the window-rule editor learned the
matchingfield with Always, Once, and Startup modes, including help text and native edit/save/reopen coverage. - ⌨️ Settings grouping —
window_switcher_*bindings now group with movement controls, andinput.focus_crosses_workspacesgroups with focus options.
⚙️ Scheduling through scx
Pearl no longer owns its own scheduler profile catalog. (#92)
- 📚 One source of truth — profiles and selection now come from scx’s
catalog.jsonthroughscxcli, matching scxcli and scxtui. - 🧹 Fewer moving parts —
pearl-scheduling-helper, its polkit policy, and Pearl’sscheduling-profiles.jsonare gone. - 📦 Packaging hint — recipes now suggest
scx-scheds>1.1.4, which provides scxcli and the catalog.
📝 Coral and file handling
- 🗂️ Wider file associations — Coral now registers JSON, JSON5, Schema JSON, SQL, TOML, TypeScript, shell, PHP, Ruby, XML, YAML, CSS, JavaScript, Rust, C/C++, CMake, Dockerfile, Go, Java, Lua, Makefile, Meson, Nix, Python, reStructuredText, SCSS, and systemd unit files. (#107)
- 📁 Create new documents — opening a path that does not exist creates missing parent directories and the file itself.
- 🔎 File chooser fixes — filter rules per filter rise from 128 to 2048, unsafe globs are rejected instead of silently mishandled, caller names are truncated to 128 characters, and dialog bugs were cleaned up. (#103)
- 🛠️ Greeter sync crash — the settings flyout’s greeter-sync image picker now uses a properly layered dialog, fixing a crash. Source images are capped at 64 MiB before the privileged boundary receives a re-encoded 4K PNG. (#102)
🕰️ Clock and launcher polish
- 🕰️ Stacked custom clocks — custom time and date patterns accept raw newlines and
\nescapes in any bar orientation. (#104) - 🧷 Launcher border overlap — fixed the selected-item border overlapping nearby launcher content. (#108)
📦 Build and packaging updates
- 🏷️ Injected version identity —
src/version.zigno longer hardcodes a release. Packaging passes-Dversion="$pkgver"and CI exportsPEARL_VERSIONfrom the release tag. (#96) - 🌿 Tag builds — CI now builds on
v*tag pushes as well as pull requests. - 🧪 Coverage refresh — updated Aqueous 0.8.2 contract figures and baselines, plus new window-rule timing, portal contract, window switcher, and screensaver test coverage.
- 🌍 Translations — Pearl, Coral, and lock templates were refreshed for the new screensaver, bar, media, and file-chooser strings.
🚀 Upgrade notes
Scheduler profiles are now owned by scx. Install a scx-scheds package newer than 1.1.4 so scxcli and catalog.json are available, then select your profile in Pearl, scxcli, or scxtui. Profiles stored in /etc/pearl/scheduling-profiles.json are no longer read.
Packagers must pass -Dversion="$pkgver" or set PEARL_VERSION; otherwise binaries report 0.0.0-dev.
Screensavers are opt-in and default to Off. Enabling one makes the screen-off timeout start the saver, with the panel-off delay controlled separately.
🌍 Translations and thanks
❤️ Thank you to Caroline Snyder, Treshaun, Piotr Gorski, and Zoey Bauer for the screensavers, bar and dock work, file handling, scx integration, and Aqueous settings work, and to everyone reporting issues and testing fixes.
📋 Full Changelog: v0.3.8…e7fdc5a7
🔀 Release commit: e7fdc5a7
v0.3.10 Latest
🦪 Local Semantic Search, Per-Monitor Wallpapers, and a More Helpful Desktop
Pearl v0.3.10 brings opt-in local semantic document search to the launcher, per-display wallpaper overrides, a Startup applications page, a light/dark bar widget, and full Steam library sync. The bar’s network icon finally tells Ethernet from Wi-Fi, plugins accept replacement artwork, Phyto learns explicit Replace and background-friendly copies, and Settings recovers gracefully instead of resetting when a field goes missing.
🔎 Local semantic search (opt-in)
Find documents by describing them, straight from the launcher. All embedding and ranking is local — no query or passage leaves the device. (#130, issue #46)
- Local models — EmbeddingGemma 2 text backbone, downloaded like chat models with pinned revisions and SHA-256 verification: Q8_0 (310 MB) or UD-Q4_K_XL (176 MB).
- Your folders only — up to 16 explicit absolute folders, configured in Settings → Assistant → Semantic search. Disabled by default.
- Two-stage launcher results — instant app/window/calculator hits never wait on a model; document results arrive as a debounced second stage and stale rows are discarded by revision checks.
- Idle-friendly indexing — automatic indexing runs in idle/low-use windows (or idle-only / manual modes) in bounded bursts that pause when you return, using a dedicated Wayland maintenance idle notification. Index now bypasses the gate; folder removals apply immediately.
- Folder watching — changes are picked up and reindexed automatically; text extraction (including PDF) runs sandboxed.
- CLI —
pearlctl semantic status|index|stop|delete(control only, never query text).
🖼️ Per-monitor wallpapers
- Per-display overrides — each output can carry its own image, fit, color and crops (
outputs[].wallpaper), falling back to the global wallpaper. The slideshow and dynamic colors stay global. (#123) - Settings UI — the Appearance wallpaper card gains a Display selector; controls and preview follow the selected display’s override or the default.
🚀 Startup applications
- New Settings → Startup page — manage XDG autostart entries: enable, disable, add and remove. (#121)
- Proper masking — the user directory (
~/.config/autostart) is authoritative; disabling or removing a system entry writes a user mask over/etc/xdg/autostart, the same way GNOME and Plasma treat these directories. Directories are monitored live.
🌗 Light/dark bar widget
- One-click theme switch — a new
themebar widget shows a moon while dark is active and a sun while light is active; clicking switches variants, with tooltips and accessible names describing the target. (#111)
🎮 Steam library sync
- Every installed game in the launcher — Pearl scans every library recorded in
libraryfolders.vdf, so games imported from another drive appear too, not just ones installed through Steam’s own shortcut flow. (#113) - Marked shortcuts only — Pearl maintains its own
X-Pearl-Steam-Appid-marked shortcuts in the standard applications directory and prunes stale ones; files Steam or the user owns are never touched. Steamworks Common Redistributables is skipped.
🌐 Network icon fixes
- Wired vs wireless vs offline — the bar glyph now follows the link actually in use: Ethernet shows a wired icon, Wi-Fi the wireless icon, and nothing activated shows offline. With several links up, NetworkManager’s PrimaryConnection decides; without one, wired wins the way NM’s routing prefers it. Fixes the Wi-Fi icon showing on Ethernet-only desktops. (#131, issue #127)
🐱 Plugin replacement artwork
- Bring your own PNG — replace any image an approved package declares by dropping a PNG into
~/.local/share/pearl/plugin-artwork/<package id>/<image id>/. Settings → Plugins lists candidates per image with a Package artwork restore option. (#122) - Size-matched, host-side — candidates must match the manifest’s declared dimensions (e.g. Pearl Cat’s 384×96 three-frame strip). Artwork is decoded by the host, never reaches a guest, and is outside the package fingerprint — no re-approval needed. Reads are
O_NOFOLLOW, ≤2 MiB per file, ≤16 candidates per image, ≤8 selections per package.
🧲 Dock drag-and-drop polish
- Hold to reorder — a 500 ms press debounce keeps plain clicks from yoinking dock icons out of place; hold + drag still reorders, and the pickup pop replays on every grab. (#117)
🗂️ Phyto file operations
- Explicit Replace — copy, move and restore collisions now offer Skip / Replace / Keep both / Cancel. Replace moves the existing destination to Trash first, so it stays recoverable; folders are replaced whole (no merge), Replace is withheld when the item cannot be trashed, and each collision asks individually. Receipts count replaced items.
- Sane numbering — Keep both and duplicate paste write
name (2),name (3), … instead of random ids; pasting onto the source’s own folder duplicates, and cut-paste into the same folder renames. - No more system hitch during big copies — transfer workers drop to the lowest best-effort I/O priority with a CPU nice nudge (restored afterwards), so games and browsers win while the copy still progresses. (issue #124)
- Open as administrator fixed — the GVFS admin backend is now mounted first (pkexec/polkit via a mount operation), instead of opening an empty
admin://tab; authentication failures report a clear message.
⚙️ Scheduling through scx
- Honest Default state — when
scx.serviceholds a command that nothing starts (the fresh-system case), Pearl shows Default as running and the configured profile as configured rather than stopped. Runtime-only enables (systemctl enable --runtime) count as enabled, a failed manual start is attributed to that profile, and activating units show as starting. (#119)
📊 Dome GPU metrics
- AMD sysfs metrics — the GPU page reads utilization, memory utilization, VRAM/GTT used and total, max clocks, hwmon temperatures, power draw and caps, PCIe generation/width, and device names via
pci.ids, with integrated/discrete detection. (#118) - NVML probe columns — driver/CUDA metadata, throttle reasons and PCIe throughput join the GPU page, under a tightened probe budget contract. (#120)
🛠️ Settings fixes and field search
- No more accidental resets — a preferences document with a missing or unreadable field no longer resets the whole installation. The recovering parse keeps everything readable, defaults only the smallest broken set of fields, ignores unknown fields, and tolerates documents written by other versions; structurally broken JSON still falls back to last-good. (#116)
- Field-level search — the Settings search box now matches individual fields across the live Aqueous helper schema and the Pearl settings manifest, with breadcrumbs; picking a hit jumps to the page and reveals/focuses the field. New
test-settings-field-searchintegration suite. - Shared Advanced page — the former Aqueous Advanced section lives on the shared Advanced page in the normal Settings window; the compact popup keeps its own tab.
keep_renderrule editing — the window-rule editor learns Aqueous 1.0.21’skeep_renderboolean with full help text (requires Aqueous 1.0.21).
📦 Build, packaging, and tests
- Translation templates regenerated; README documents semantic search and idle reindex.
🚀 Upgrade notes
- Semantic search is opt-in: enable it in Settings → Assistant, download an embedding model, and pick folders. Indexing prefers idle/low-use windows and pauses when you return.
- Editing
keep_renderwindow rules requires Aqueous 1.0.21, which also changes VRR to off by default — setadaptive_sync = trueper output if you want it. - Preferences recovery changes reset behavior: unreadable fields now default individually instead of resetting the document.
