Skip to content

All versions since 🐚 Shelly-ALPM v3.3.0 — A Little More Pearl

🐚 Shelly-ALPM v3.3.0 — A Little More Pearl

Shelly v3.3.0 brings a fresh default look inspired by Pearl DE. Rounded surfaces, softer colors, clearer navigation, and redesigned update progress bring Shelly closer to the rest of the Seafoam desktop.

🎨 Pearl style, out of the box

A new built-in theme introduces rounded windows, circular window controls, accent-colored selections, card-style toolbars, and larger page titles.

The expanded sidebar groups your destinations, with Settings and Utilities under System.

🌓 Your colors, your choice

Shelly follows your desktop’s light or dark preference by default. Under Settings → Look & Feel, you can choose:

  • Follow system to track your desktop’s color preference.
  • Light for a lighter appearance.
  • Dark for a darker appearance.

Theme changes apply immediately. System GTK remains available for anyone who prefers their desktop’s GTK styling.

📦 A clearer view of your updates

The redesigned Updates page makes it easier to see what’s available and what you’re about to install:

  • Source filters with package counts for System, AUR, and Flatpak.
  • An included-update summary and total download size.
  • Individual selection for AUR and Flatpak updates.
  • Native system updates kept together as one complete upgrade.
  • Upgrade buttons that reflect your selection.

⏳ Progress you can follow

A new overall progress card shows download and installation stages, with transfer details when available.

Compact package rows distinguish pending, downloading, building, completed, and failed operations. Terminal output starts collapsed and is one click away when you need the details.

🔧 A few fixes beneath the polish

  • Update checks now recover from temporary contention with the tray after an upgrade.
  • Restart handling recognizes display-manager aliases, including Plasma Login Manager, so session-critical services are reported instead of automatically restarted.

❤️ Thank you to everyone contributing code, testing changes, and reporting the details that make Shelly better.

v3.3.1

🐚 Shelly-ALPM v3.3.1

A focused follow-up to v3.3.0: AppImage upgrades join Upgrade All, the built-in theme renders correctly on every desktop, and a handful of stubborn bugs get fixed beneath the polish.

📦 AppImage updates in Upgrade All

Upgrade All on the AppImage page now runs a fresh update check through the CLI on every click, instead of relying on the page’s earlier scan (#2163).

A new setting, Always Recheck AppImage Updates on Upgrade All, lets you choose the behavior: when off, Upgrade All runs only when the AppImage page already shows updates.

🏷️ Versioned AppImage filenames

Updated AppImages now keep their version in the filename — Name-Version.AppImage — so you can see what’s installed at a glance (#2155). Desktop entries and icons follow the new path, the previous file is cleaned up, and failed updates roll back safely. Syncing no longer confuses versioned files with the legacy stable name.

🔧 Fixes beneath the polish

  • Light mode on Plasma and other desktops (#2201): the built-in Pearl theme now loads the version-matched base stylesheet embedded in your GTK build and pins the desktop theme out of the picture, so desktop GTK styling no longer bleeds into Shelly’s light or dark rendering. System GTK mode fully follows your desktop again, and the color-variant row is hidden there since it only applies to the built-in theme.
  • Removing an AppImage keeps its word (#2205): the remove dialog now shows an explicit remove configuration choice, defaulting to your global setting, instead of promising configuration files will be kept while silently applying the global preference.
  • Native builder soname expansion (#2182): bare *.so entries in provides and depends are now versioned from the packaged ELF payload (DT_SONAME / DT_NEEDED), reproducing makepkg’s libprovides/libdepends step. Versioned dependencies such as libfprint-2.so=2-64 are now satisfied by the libraries a package actually ships.
  • shelly utility --repair-db repairs stale update-check locks (#2191): it now also clears a stale db.lck in your user’s update-check cache (XDG_CACHE_HOME/Shelly/db), reports every path it checks, and only asks for elevation when a system database lock is present. A stale cache lock no longer leaves update checks broken with no way to repair them.
  • Round window controls stay round: desktop theme padding could stretch the circular window buttons into eggs; the header bar now keeps them square-and-circular in every theme (#2204).

⚡ A lighter TUI

The TUI models were simplified and trimmed (#2218): unused fields removed, installed-package checks decoded into name-only records, and query arrays decoded directly — reducing peak memory usage, especially on large package sets.

📦 Packaging: shelly-tui ships in the PKGBUILDs

The terminal interface is now packaged (#2181):

  • Split recipes gain an optional shelly-tui / shelly-tui-git package depending on shelly-cli.
  • The monolithic shelly package builds and includes the TUI.
  • A new standalone PKGBUILD-tui recipe builds shelly-tui on its own.

The binary installs as /usr/bin/shelly-tui; the Flatpak backend remains optional for the Flatpak tab.

🌍 Translations

  • Brazilian Portuguese (pt_BR) refreshed (#2210)
  • European Portuguese (pt_PT) updated (#2212)
  • Polish updated via Weblate (#2199)
  • Hungarian updated

❤️ Thank you

Thanks to everyone contributing code, translations, testing, and bug reports this cycle: @ZoeyErinBauer, @Paint-Pauller, @nyx1d, @VinnyQF, @Ricardo-Simoes, @juliazero, @lucjan, and Kratos.

v3.4.0

🐚 Shelly-ALPM v3.4.0 Firmware and a Finer Pearl

Shelly v3.4.0 brings firmware updates into the app: a new opt-in Firmware page talks to fwupd to list, update, downgrade and reinstall device firmware, with consent-first installs from start to finish. The Pearl theme also gets a correctness pass — lists, column headers, buttons and page layouts now render the way they were designed — alongside redesigned pages with a saved column menu, a makepkg-faithful fix for split-package AUR builds, and a valgrind gate that keeps the desktop app leak-free.

🔌 A new Firmware page (#763, #2228)

Shelly can now update device firmware — UEFI/BIOS and peripherals — through LVFS and fwupd.

The page is opt-in: tick Firmware on the welcome screen or flip Enable Firmware in Settings. Shelly installs fwupd on demand through the normal privileged transaction; it stays an optional dependency of the UI packages, and the daemon is D-Bus-activated, so there is no service to enable.

  • Devices at a glance. The device list shows updatable hardware with upgrade badges, upgrades first. The detail pane shows current, minimum and latest versions, vendor, flags and GUIDs, with Update, Downgrade and Reinstall buttons per release. Blocked releases stay disabled with the reason shown.
  • Live updates. Devices appearing, changing and removing are tracked as they happen, and a battery banner mirrors fwupd’s own low-power gate, following the daemon’s power properties live.
  • Fresh metadata. Catalog refreshes are throttled to once every 24 hours and skip downloads when the remote signature already matches the cache. A stale-metadata banner tells you when the catalog is old; Check Again always refreshes and retries.
  • Recovers from a stopped daemon. If fwupd quits or crashes, the page shows a disconnected banner while the last device list stays browsable, and Check Again re-activates the daemon and reloads.
  • View on LVFS. A read-more link in the detail pane opens the device’s LVFS page, shown only for releases that actually come from LVFS.

The page deep-links with shelly-ui --page firmware, and builds can exclude it entirely with -Dexclude-fwupd=true.

🛡️ Firmware installs that ask first

  • The confirm dialog names the device and version, shows the download size and estimated install time, and warns that the device will be unavailable during the flash.
  • Devices that affect full-disk encryption keep the confirm button disabled until the recovery-key checkbox is ticked, and alternate-branch releases get an explicit warning before anything is written.
  • Payloads download client-side with checksum verification and cache reuse, then flash with live progress and status text. Mid-install device requests surface as dialogs instead of being lost.
  • The finish step shows the release’s update message and a Restart now / Restart later prompt — “later” leaves the system untouched. Cancelling an authentication dialog shows a friendly note and changes nothing.
  • Navigating away mid-install no longer loses the prompts or blocks the page when you return.

🎨 Pearl, corrected (#2229)

The built-in Pearl theme picked up a round of fixes so its surfaces render as intended, in both light and dark:

  • Lists keep their rounded cards. The theme’s list rules now match GTK4’s actual list nodes, so opaque desktop-theme backgrounds no longer square off Pearl’s cards. The Firmware and Flatpak lists get the same treatment, and list rows keep their own spacing.
  • One pill for column headers. Table headers render as a single pill bar with hairline dividers between columns, instead of a pill per column title.
  • Hairline buttons. Flat, suggested-action, destructive-action, window-control and navigation buttons gain subtle hairline rings, drawn as inset shadows so button sizes don’t change. The stray teal window border is gone, and navigation groups get a quiet divider.
  • Layout fixes. The transaction page fills its space correctly, the AppImage setting row lines up, and pill and box layouts no longer clip or stretch.

System GTK mode is untouched.

🪟 Redesigned pages and a column menu (#2237)

  • The top bar, toolbars, tables and page layouts were restyled, and the Settings and Flatpak pages reworked around the new layout.
  • Package tables gain a column menu: show or hide columns and drag them into the order you want. Each table’s layout is saved and restored on the next launch.
  • Selection actions and the update-count summary now hide when there is nothing to act on — no selection, no updates, or a check still in progress.

🔧 Fixes beneath the polish

  • Split-package AUR builds (#2224): installing one member of a split package no longer fails when later package() functions run from the wrong working directory. Shelly now builds the full split set in one pass, as makepkg does, and installs only the members you requested. Pinned historical builds keep building just the requested subset.
  • A leak-free desktop app (#2238): a new valgrind gate runs the UI tests and a live app session under memcheck. It caught and fixed lifetime errors in theme handling, D-Bus message building, transaction-page cleanup and the Firmware page; the gated run now reports zero definitely-lost bytes and zero errors.

🌍 Translations

  • Polish updated via Weblate (#2226)

❤️ Thank you

Thanks to everyone contributing code, translations, testing, and bug reports this cycle: @azdanov for the Firmware page, @treshaun for the page redesign and column menu, @juliazero for the Polish translation, and @ZoeyErinBauer for the Pearl fixes, the split-package repair and the valgrind gate.

v3.4.1 Latest

What’s Changed

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v3.4.0...v3.4.1

© 2026 Seafoam LabsShelly Chel