Skip to content

All versions since v0.3.10

v0.3.10

🦪 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 theme bar 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.service holds 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)
  • 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-search integration 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_render rule editing — the window-rule editor learns Aqueous 1.0.21’s keep_render boolean 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_render window rules requires Aqueous 1.0.21, which also changes VRR to off by default — set adaptive_sync = true per output if you want it.
  • Preferences recovery changes reset behavior: unreadable fields now default individually instead of resetting the document.

v0.3.11

What’s Changed

Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.3.10...v0.3.11

v0.3.12 Latest

Full Changelog: https://github.com/Seafoam-Labs/pearl/compare/v0.3.11...v0.3.12

© 2026 Seafoam LabsShelly Chel