Skip to content
Seafoam Labs

All versions since v1.2.0
All versions

v1.2.0

Release Items: Things done in no particular order

  • Added double click to check for installation, removal, and update
  • Added Console enable in settings (currently install only)
  • Added resizable console output, from pop drawer
  • Added ConsoleLog Service to pull console from error
  • Added tooltip on hover in install page with additional info.
  • Added double click to selected package on install window
  • Added ui highlighting for current page you are on
  • Shelly-CLI Released and installs to path. - Can be installed independently but does come with installation or update of Shelly-UI - Wiki page will be added shortly but basic usage is inside readme

Bug Fixes:

  • Fixed rendering for wayland window managers (hyprland/ Niri)
  • Removed pkexec requirement at launch. Now only prompts for password as needed.
  • Added debug logging that saves to a text file upon crashing in ~/Documents/Shelly - Please attach these when opening any issues as it makes it much easier to debug
  • Improved installer implementation to allow for cleaner installation.

ALPM download and UI fixes

Release Notes

  • Fixed PKGBuild issues with installation
  • Renamed Shelly-CLI to just shelly for easy of use inside terminal
  • Adding Enhanced Console with custom control for speed.
  • Some Code cleanup
  • Added console to remove and update
  • Refactored Package page to use custom controls
  • Fixed download issue with libalpm triggering multiple times even after correct completion

Known issues

  • Popups do not correctly trigger in every scenario and can potentially allow you to leave a page before a task is completed
  • Password does not re-trigger if typed incorrectly. (Relaunch application to resolve)
  • Update manager is not correctly notifying when updates are available thus preventing downloads.

v1.2.2

Release Notes

-Prompts for progress locking the ui for interactions will now trigger properly. Progress %‘s show as well. -Failed password attempts re-prompt the user for password.

Known issues

Mass package update can cause databases to be out of sync. To fix run:

Terminal window
 sudo pacman -Sy

or

Terminal window
sudo shelly sync --force

v1.2.3

Release Notes

  • Updating how config service functions to not read from system files as much
  • Fixed bug on install packages page causing sync to not fire off
  • Fixed bug in settings of checking for updates button went missing

Known issues

Mass package update can cause databases to be out of sync. To fix run:

Terminal window
 sudo pacman -Sy

or

Terminal window
sudo shelly sync --force

v1.2.4

Release Notes

  • Fixed out of sync syncdb issue caused by force sync being aggressively used in place of standard sync.
  • Restored hyperlink functionality in the right click description menu on packages.
  • Added force sync button into shelly-ui. This is used to force a database sync if you believe syncdb’s are not updating correctly.

Known Issues

  • Currently None. Please open an issue and attach crash logs if an issue occurs.

v1.2.5

Release Notes

-Added functionality for flatpak to the shelly CLI using the flatpak system lib

  • flatpak must be installed it can be installed first using
sudo shelly install flatpak

or

sudo pacman -S flatpak

The following commands are supported: install Install flatpak app
update Update flatpak app
list List installed flatpak apps list-updates List installed flatpak apps running List running flatpak apps
uninstall Remove flatpak app
run Run flatpak app
kill Kill running flatpak app
search Search flatpak

Query supports the following additional parameters: —limit —page —no-ui (this reports the raw json back from the api)

Known Issues

  • No Confirmations before actions
  • Description for List-updates is incorrect
  • flatpak run starts application, but has some weirdness with CLI capturing apps std out

v1.2.6

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.2.5…v1.2.6

v1.2.7

Release Notes

Added AUR Support to the UI to support adding, removing and updating AUR packages. Must be enabled in settings and requires a restart of the shelly application.

QoL improvments:

Added the ability for shelly to remember the window size after closing

v1.2.8

  • Fixes issue with standard package update.
  • add’s one call install method support. (Documented in readme)

v1.2.9

What’s Changed

  • Updated the settings to now longer be a unique page and be a popup that is accessed from everywhere.
  • Updated the settings UI to have tabs so we have more space
  • Updated the UI to now respond to changes in enabling AUR and console in real time requiring no restart
  • Add gestures to some textboxes like the auth button to now accept enter
  • Cleaned up the code for flatpak in preparation for flatpak integration to UI
  • AUR dependency resolution correction
  • System Upgrade and Package Install question prompt fix
    • No longer just dies when you have a conflict, and instead prompts
  • NEW LOGO

Known Issues

  • In Shelly updater is not currently functioning as intended please use web installer in the readme.

The command below will install the update.

Terminal window
curl -fsSL https://raw.githubusercontent.com/ZoeyErinBauer/Shelly-ALPM/master/web-install.sh | sudo bash

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.2.8…v1.2.9

v1.3.0

What’s Changed

  • Add install-version command to Shelly-CLI and implement AUR package installation by commit hash. Update dependency handling, add new utility methods, and improve transaction handling in ALPM manager. by @ZoeyErinBauer in https://github.com/ZoeyErinBauer/Shelly-ALPM/pull/29

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.2.9…v1.3.0

v1.3.1

What’s Changed

Known Issues

  • If you reload available package page multiple times quickly can cause a memory leak that will cause memory to not be freed till application is closed.

Easy Install/Update

Terminal window
curl -fsSL https://raw.githubusercontent.com/ZoeyErinBauer/Shelly-ALPM/master/web-install.sh | sudo bash

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.3.0…v1.3.1

v1.3.2

What’s Changed

New Contributors

Known Issues

  • Update UI is still not working appropriately use curl to update
  • Console requires restart after being enabled
Terminal window
curl -fsSL https://raw.githubusercontent.com/ZoeyErinBauer/Shelly-ALPM/master/web-install.sh | sudo bash

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.3.1…v1.3.2

v1.4.0 Flatpak UI and CLI Update

What’s Changed

  • Flatpak UI - alpha release - https://github.com/ZoeyErinBauer/Shelly-ALPM/pull/66

  • Introduced InstallDependenciesOnly method in AlpmManager to install dependencies for a given package without installing the package itself.

  • Added GetDependencyList utility for extracting dependencies and ignoring version constraints.

  • Updated IAlpmManager interface to include InstallDependenciesOnly with corresponding flags parameter.

  • Adjusted default AlpmTransFlag values across methods for consistency.

  • Introduced InstallPackageSettings to handle new options --build-deps and --make-deps.

  • Updated InstallDependenciesOnly in AlpmManager to include make dependencies when specified.

  • Refactored InstallCommand to check for and handle new dependency flags.

  • Added usage examples for new options in Program.cs.

  • Updated rd.xml and refactored code for settings modularity.

  • Introduced --no-deps option in InstallPackageSettings.

  • Updated InstallCommand to handle and skip dependency installation when --no-deps is specified.

  • Introduced interactive confirmation for AUR package installation with --no-confirm option fallback.

  • Added support for handling SelectProvider questions and progress updates during installation.

  • Enhanced dependency handling with options to install build (--build-deps) and make (--make-deps) dependencies only.

  • Refactored AurInstallCommand to use new AurInstallSettings for improved modularity.

  • Updated AurPackageManager to include dependency resolution and progress event handling.

  • Expanded WithExample method in Program.cs to include examples for --build-deps, -o, --make-deps, and -m flags.

  • Added SortOption enum with options for Name, Size, and Popularity.

  • Added SortDirection enum with options for Ascending and Descending.

  • Introduced a placeholder ListSettings class inheriting from DefaultSettings.

  • Updated ListSettings to include --sort and --order options.

  • Enabled sorting by name, size, and popularity across listing commands.

  • Refactored ListInstalledCommand, ListAvailableCommand, AurListInstalledCommand, and AurListUpdatesCommand to apply sorting logic.

  • Add usage examples for all commands in Program.cs for improved clarity when running cli

  • Adjusted Program.cs to provide usage examples for new sort and order options.

  • Updated rd.xml to reflect changes in settings requirements.

  • Updated ListSettings to include --filter option for case-insensitive substring matching.

  • Added filtering logic to ListInstalledCommand, ListAvailableCommand, AurListInstalledCommand, and AurListUpdatesCommand.

  • Expanded usage examples in Program.cs to demonstrate the new filter option.

  • Add support for SelectProvider question handling in CLI and UI

    • Updated argument and option descriptions for clarity and consistency in commands for Standard, Flatpak, Keyring, and AUR.

  • Introduced short aliases (e.g., -n, -j, -f) for frequently used command options.

  • Refactored ForceSettings into a reusable base class for commands requiring --force.

  • Implemented logic to handle SelectProvider type questions in RemoveCommand, UpdateCommand, UpgradeCommand, and InstallCommand.

  • Added HandleSelectProviderQuestion method in AlpmManager for customized question handling.

  • Introduced AlpmQuestionSelectProvider struct for SelectProvider-related data.

  • Updated MainWindowViewModel and UI to display provider selection options with list binding.

  • Add custom transfer command execution for package download fallback

  • Introduced support for executing a user-defined transfer command as a fallback when standard download methods fail.

  • Improved exception handling and added debug logs for enhanced troubleshooting.

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.3.2…v1.4.0

##Known issues

  • Updater in the app is not working please use the update script. Update or install:
Terminal window
curl -fsSL https://raw.githubusercontent.com/ZoeyErinBauer/Shelly-ALPM/master/web-install.sh | sudo bash

v1.4.1

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.4.0…v1.4.1

v1.4.2

What’s New

Updated to better handle dependencies on the aur that are already installed on the installing system.

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.4.1…v1.4.2

v1.4.3

What’s New

  • Updated how AUR update handles packages for notification on conflicts @ZoeyErinBauer
  • Updated readme to clarify best installation methods.

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.4.2…v1.4.3

v1.4.4

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.4.3…v1.4.4

v1.4.5

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.4.4…v1.4.5

v1.4.6

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.4.5…v1.4.6

v1.4.7

What’s Changed

New Contributors

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.4.6…v1.4.7

v1.4.8

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.4.7…v1.4.8

v1.4.9

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.4.8…v1.4.9

v1.4.10

Fixed race condition with UI response assuming default answer before user could response @ZoeyErinBauer Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.4.9…v1.4.10

v1.4.11

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.4.10…v1.4.11

v1.4.12

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.4.11…v1.4.12

v1.4.14

What’s Changed

Known Issue:

  • In the UI updates with replace can create an off by one error for rendering questions. If this occurrs please run:
Terminal window
sudo shelly upgrade

Currently this is known to occur in cachyOS with the znver4 repo.

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.4.12…v1.4.14

v1.4.15

-Bug fix for replaces in gui (this should fix it)

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.4.14…v1.4.15

v1.5.0

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.4.15…v1.5.0

v1.5.1

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.5.0…v1.5.1

v1.5.2

Crash Fix from 1.5.1 Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.5.1…v1.5.2

v1.5.3

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.5.2…v1.5.3

v1.5.4

What’s Changed

New Contributors

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.5.3…v1.5.4

v1.5.5

v1.5.6

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.5.5…v1.5.6

v2.0.0 - The GTKening

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.5.6…v1.5.7

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v1.5.6…v2.0.0

v2.0.1

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v2.0.0…v2.0.1

v2.0.2

What’s Changed

New Contributors

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v2.0.1…v2.0.2

v2.0.3

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v2.0.2…v2.0.3

v2.0.4

What’s Changed

Full Changelog: https://github.com/ZoeyErinBauer/Shelly-ALPM/compare/v2.0.3…v2.0.4

v2.0.5

What’s Changed

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.0.4…v2.0.5

v2.0.6

What’s Changed

New Contributors

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.0.5…v2.0.6

v2.0.7

What’s Changed

New Contributors

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.0.6…v2.0.7

v2.0.8

What’s Changed

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.0.7…v2.0.8

v2.0.9

What’s Changed

New Contributors

Supporters

  • @eric-reichenbach for their support

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.0.8…v2.0.9

v2.0.10

Hotfix

What’s Changed

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.0.9…v2.0.10

v2.1.0

What’s Changed

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.0.10…v2.1.0

v2.1.1

What’s Changed

New Contributors

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.1.0…v2.1.1

v2.1.2

Bug Fixes

What’s Changed

New Contributors

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.1.0…v2.1.1

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.1.1…v2.1.2

v2.1.3

What’s Changed

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.1.2…v2.1.3

v2.1.4

What’s Changed

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.1.3…v2.1.4

v2.1.5

What’s Changed

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.1.4…v2.1.5

v2.2.0 UI Simplification

What’s Changed

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.1.5…v2.2.0

v2.2.1

What’s Changed

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.2.0…v2.2.1

v2.2.2

Shelly Search is Back

You can enable it in advanced options.

What’s Changed

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.2.1…v2.2.2

v2.2.3

What’s Changed

Configuration Information

To achieve looks like this : image

Apply the below configurations to your config file in ~/.config/shelly/config.json . Further configuration information will be on the wiki shortly to explain how to achieve different animation styles and looks.

  "ProgressBarStyle": "Pacman",
  "ProgressBarFps": 7,
  "ProgressBarWidth": 24,
  "OutputMode": "singlepane",
  "SinglePaneMaxStickies": 6

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.2.2…v2.2.3

v2.2.3.1

Summary

  • Corrected support for GTK Theming on Gnome to enable make sure you download and install a GTK4 Theme

    • nwg-look is one of the best ways to do this if you are unsure.

  • Finished cleanup of updated UI

  • Fixed -git tracking bugs for the aur

What’s Changed

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.2.3…v2.2.3.1

v2.2.3.2 - Rolling With My Gnomies A Dark Mode Fix

What’s Changed

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.2.3.1…v2.2.3.2

Release - v2.2.4.0

Release Notes v2.2.4

Highlights: Smarter fuzzy search across every package list, fingerprint-auth interference detection with guided fixes, and a polished Recommended page that’s now opt-in. A brand-new alpha release of Shelly.Keys companion binary for GPG keyring bootstrapping.

🐚 Features

  • Shelly.Keys — new AOT-compiled CLI for one-shot GPG/pacman keyring initialization. Ships its own PKGBUILD, packaging workflow, and GlobalSettings for global keyserver configuration.
  • Recommended page — a new curated landing experience for package discovery (recomend page, JSON context, refreshed UI).
  • Package group search — search now resolves and lists pacman package groups alongside individual packages.
  • Sortable search columns in ShellySearch — click any column header to sort results.
  • Ctrl+F search shortcut wired into AurInstall, AurRemove, AurUpdate, PackageInstall, PackageManagement, PackageUpdate, and FlatpakInstall dialogs.
  • Fingerprint authentication detector — new FingerprintAuthDetector + FingerprintAuthState services automatically spot sudo/fprintd PAM interference and surface a helper banner and FingerprintFixDialog with guided remediation.
  • Build Date field added to AlpmPackage and shown in package details.
  • ilovecandy-style bottom bar — BottomBarRegion now conditionally renders ANSI markup or an ASCII fallback based on terminal capability.

⚡ Improvements

  • Smarter fuzzy matching across every list view — ListInstalled, ListAvailable, AurListInstalled, AurListUpdates now use a unified scoring filter.
  • ShellySearch refactor — scoring moved into a local MatchObject method, class made sealed, fields converted to locals.
  • InitializeCommand streamlined — leaner GPG config setup, optimized keyring creation, new trust-database update step, and Marshal.StringToCoTaskMemUTF8 / ThrowIfErrorString adoption.
  • CLI path resolution consolidated into a single central class, restricted to .slnx, rewritten with LINQ.
  • Auto-select first list item so users aren’t locked out of package details.
  • About dialog — added proper credit sections.
  • Privileged operation hint clarifies biometric support and suggests temporarily disabling fingerprint auth.
  • FingerprintAuthDetector — configurable PAM directories/service names, better include/substack handling, direct sudo hit checks, fprintd service integration, expanded tests.
  • FingerprintFixDialog — simplified copy, removed security warning and issue-reference button, tightened default height.
  • Recommended page is now opt-in — disabled by default, toggleable from settings.

🐞 Bug Fixes

  • Arch News order reversed — ArchNewsDialog now displays news items newest-first.
  • JsonException: 'P' is an invalid start of a value in GetAurPackageBuild resolved.
  • SearchPackagesAsync filter syntax corrected.
  • Bottom of lockout view no longer visually cut off.
  • AppImage .desktop — removed an invalid TryExec entry.
  • Renamed firmware version → Shelly version and made it required.
  • Added missing colon after Version and a missing space in installed-size output.

Changes since v2.2.3.2

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.2.3.2…v2.2.4.0

v2.2.4.1 Latest

What’s Changed

Full Changelog: https://github.com/Seafoam-Labs/Shelly-ALPM/compare/v2.2.4.0…v2.2.4.1

© 2026 Seafoam Labs Shelly Chel