The update application for Spaced Linux.
Spaced Update updates Spaced Linux systems through APT and Flathub in a
single, simple GTK interface. Package and Flatpak operations run as root via
pkexec against a small helper script, with a live progress and log view.
- Check for Updates lists every available APT package and Flatpak application update with a checkbox for each, plus a Select all toggle.
- Install Selected applies only the packages/apps you check, using the
helper's
apt-installandflatpak-updatesubcommands with per-step progress. (The default helper run still does a fulldist-upgrade+ system Flatpak + boot menu + initramfs refresh.) - Shows a clear overall progress bar and named update stages. The real command output remains available in a collapsed, scrollable Technical details panel when it is useful, without taking over the normal experience.
- Uses one adaptive, theme-aware interface for both light and dark Spaced Linux themes, with readable update cards and full-size action targets.
- Runs the privileged steps through the Polkit action
com.spacedlinux.updateso the helper is policy-controlled.
The OS Update tab checks the crhy/spaced release feed for the newest
Spaced Linux version and compares it against the installed /etc/os-release
version. Spaced Linux is a rolling release, so OS updates are applied from the
package repositories via the existing update helper — no ISO download is needed.
The tab simply tells you whether your system is current and routes the actual
update through the normal dist-upgrade path, with a reboot recommendation
when done.
bin/spaced-update # launcher: runs the GTK app
src/spaced-update.py # GTK3 UI and worker
src/spaced-update-helper # privileged bash helper (pkexec)
data/spaced-update.desktop # desktop entry
data/com.spacedlinux.update.policy # Polkit policy for the helper
src/spaced-update.py->/usr/lib/spaced-linux/spaced-update.pysrc/spaced-update-helper->/usr/lib/spaced-linux/spaced-update-helperbin/spaced-update->/usr/local/bin/spaced-updatedata/spaced-update.desktop->/usr/share/applications/spaced-update.desktopdata/com.spacedlinux.update.policy->/usr/share/polkit-1/actions/com.spacedlinux.update.policy
Spaced Update is also published as a Flatpak (org.spacedlinux.SpacedUpdate)
for systems that do not carry the native package. Inside the sandbox, APT,
Flatpak, and the pkexec helper are reached through flatpak-spawn --host, so
the interface behaves exactly like the system app; privileged work still runs
through the host's Polkit policy.
- Build:
bash flatpak/build.sh— produces a static OSTree repository inflatpak-build/repo(Python 3.13 + PyGObject built from source, all Spaced themes bundled so the app matches the desktop on any host). - Publish:
bash flatpak/publish.sh— pushes the repository to thegh-pagesbranch for serving athttps://crhy.github.io/spacedupdate/flatpak-repo. - Install from the published remote:
The repository is unsigned and uses
flatpak --user remote-add --if-not-exists --no-gpg-verify spacedupdate \ https://crhy.github.io/spacedupdate/flatpak-repo flatpak --user install spacedupdate org.spacedlinux.SpacedUpdate flatpak run org.spacedlinux.SpacedUpdate--no-gpg-verify, mirroring the[trusted=yes]Spaced Linux apt repository.
On Spaced Linux, the native package remains the primary install; the Flatpak is the fallback and the distribution channel for non-Spaced hosts.
Planned features are tracked as GitHub issues. See the issue tracker and the current triage notes for:
- Full integration with Spaced Linux OS updates.
- Peer-to-peer updating and Flatpak distribution.
- Further refinements to the graphical install progress experience.
- Anonymity and privacy protection for shared data.
- Password-protected anonymous file sharing.
- A browsable, rating-driven theme browser.
- App suggestions, ratings, reviews, and metrics as a Bazaar alternative.
MIT — see LICENSE.