https://github.com/rfrench3/bazzite-updater

System Update interface for Linux, with full controller support!
https://github.com/rfrench3/bazzite-updater

bazzite cpp kirigami2 linux-app sdl3 ublue-os

Last synced: about 1 hour ago
JSON representation

System Update interface for Linux, with full controller support!

• Host: GitHub
• URL: https://github.com/rfrench3/bazzite-updater
• Owner: rfrench3
• Created: 2025-12-22T19:06:40.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2026-07-22T00:42:05.000Z (about 15 hours ago)
• Last Synced: 2026-07-22T14:34:10.446Z (about 1 hour ago)
• Topics: bazzite, cpp, kirigami2, linux-app, sdl3, ublue-os
• Language: QML
• Homepage:
• Size: 1.96 MB
• Stars: 2
• Watchers: 1
• Forks: 2
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSES/APACHELICENSE-2.0.txt

Awesome Lists containing this project

README

          
Bazzite Updater


A Graphical Frontend for the updating and rebasing tools used by Bazzite, configurable for any Linux distro!


![Updating Screen](screenshots/update_drawer.png)

Features


This is a convenient, easy-to-use interface for updating your Linux system.


- Simple and powerful

- Full support for all input types (keyboard/mouse, controller, touchscreen)




Icons


The custom icons used by this app come from Bazzite.


- https://github.com/ublue-os/bazzite/blob/main/system_files/desktop/shared/usr/share/ublue-os/bazzite/update.svg

- https://github.com/ublue-os/bazzite/blob/main/system_files/desktop/shared/usr/share/ublue-os/bazzite/logo.svg




Requirements


By default, this interface is configured to use bazzite's `uupd` system service for updating and `bazzite-rollback-helper` for rolling back updates.

- systemd version >= 258 is required for the pre-configured "service-as-program.sh" script to function.

- This is not tested with versions of kirigami older than 6.27.0 and kirigami-addons older than 1.12.0.




Where to Install the Latest Release


The app is available in [Terra](https://docs.terrapkg.com/usage/installing/). Once the installation instructions are met, the package will be available as `bazzite-updater`.

```bash

sudo dnf install bazzite-updater

```

It is also posted to the github releases.

- https://github.com/rfrench3/bazzite_updater/releases




Configuration


In `/etc/bazzite-updater`, edit `config.ini` to change your update/rollback commands and edit `KAboutData_OS.json` (if desired) to match your Linux distro. Here is an example config.ini for Arch Linux:

```config.ini

[Commands]

systemUpdateCommand=pkexec pacman -Syu

systemRollbackCommand=

```

If you leave systemRollbackCommand blank (but still present!), it will hide that portion of the UI.




License


GPL-2.0-or-later. See LICENSES for details.





Developer Instructions


I develop this project in a devcontainer with Zed and test it on bazzite by installing it as an RPM. A justfile is present for specific scripts, which can be easily run using `just`.

```bash

just build-flatpak

just build-rpm

```

To test as an rpm:

```bash

sudo bootc usroverlay

sudo dnf install the/rpm/package.rpm

```