Repository navigation
Conversation
Add Alpine and postmarketOS as a supported distro family: - detect Alpine via ID, ID_LIKE and apk auto-detection - implement apk handlers for the pkg_* wrappers, system updates, fix broken packages and the mount tasks - add a sudo shim that falls back to doas or su, since Alpine ships without sudo - add svc_* helpers so services work under both systemd and OpenRC - offer to install the GNU grep, sed, gawk, coreutils and findutils that BusyBox lacks on first run - install XEN Guest Utilities from the release's own repository instead of edge, and enable and verify the OpenRC service - add Alpine to the CI distro-detection matrix - add tests, and update the README, CONTRIBUTING and CHANGELOG
Add apk to the package manager conflict and repository checks in preflight_checks, and make do_reboot run `sudo reboot` when systemd is absent, since OpenRC hosts such as Alpine have no systemctl. Add a test for the non-systemd path and note the change in the changelog.
Drop the CADCraft, DeckCraft, DesignCraft, EffectCraft, FilmCraft, GridCraft, LightCraft, PdfCraft, PhotoCraft, SoundCraft, VectorCraft and WordCraft entries, along with craft_apps.sh. The Craft apps are now installed from the ArtCraft Launcher instead. The launcher is listed directly under Productivity rather than in an "ArtCraft" subfolder. Previously installed copies are no longer listed or updated by System Updates. Update completions, docs, changelog and tests to match.
Add Alpine 3.23, Alpine 3.22 and openSUSE Leap 16.0 to the distro-smoke matrix, so every still-supported release of those distros is checked. Annotate each matrix entry with its EOL date from endoflife.date and add a note on the next release due to be dropped (Fedora 43, 2026-12-01) and the upcoming releases to add. This makes matrix upkeep easier. Update the README and CHANGELOG to list the newly covered distros.
Add a scheduled workflow that compares the CI distro matrix with endoflife.date and keeps a single issue open while a release needs dropping (end of life) or adding (newly supported). Document the change in the changelog.
Add File Managers, Firewalls, Login Screens and Window Managers tables to docs/utilities.md, along with the previously missing entries (Angry IP Scanner, Brave Debloat, LocalSend, PowerShell, Snapper GUI, fail2ban, Unattended Upgrades, Configure Syncthing Folders). Replace the "Incomplete" notice with a pointer to `./linux_util.sh --list` and note the change in the CHANGELOG.
Add 1Password, KeePassXC, Cryptomator, VeraCrypt, mpv, Kodi, Spotify, Blender, Darktable, RawTherapee, Shotcut, Scribus, Calibre, Anki, Okular and Xournal++ (#91). - Add shared native_or_flatpak helpers and pkg_in_repo: use the distro package when its repository has one, otherwise Flathub - 1Password uses its signed vendor repository (AUR on Arch); VeraCrypt installs the GitHub release after checking its signature against the pinned key - Spotify and Cryptomator always use Flathub - Offer the apps Alpine packages and hide the rest there - Group Productivity into Office Suites, Notes, Password Managers, Encryption, Documents & Reading, Graphics & Photo, Video & Audio and Media subcategories - Update completions, README, docs, changelog and tests
Add htop, nvtop, smartmontools, TLP, auto-cpufreq, zram, earlyoom, BleachBit, ncdu, HardInfo, inxi, CPU-X, CUPS, Alacritty, kitty, Ghostty and WezTerm (part of #91). System Tools now has Monitors, Power & Memory, Disk & Cleanup, System Info, Shell Tools, Terminal Emulators and Kernel Managers folders. ClamAV, CUPS, Input Leap and OCCT stay at the top level. Tools that cannot install on a family are not registered there: Alacritty on RHEL clones and Ubuntu 22.04, auto-cpufreq on openSUSE Leap and Rocky/Alma 8 and 9, Ghostty and WezTerm outside the families that package them, and TLP and inxi on Rocky/Alma 10. Alpine gets ten of them through its package table. auto-cpufreq uses the AUR on Arch and upstream's installer elsewhere. TLP and auto-cpufreq refuse to install beside each other. Extract ensure_epel from native_or_flatpak_install for reuse. Update the changelog, README, utilities docs and shell completions, and add tests.
Add Vim, Emacs, Helix, Sublime Text, Zed, lazygit, Podman Desktop, Helm, minikube, k3s, Python, Java JDK, PHP, Ruby, VirtualBox, Wireshark, nmap and Ollama to Development, and fzf, eza, zoxide, starship and tldr to System Tools > Shell Tools. Each uses the distro package where one exists. Otherwise it falls back to a SHA-256 verified upstream GitHub release, a vendor-signed repo, Flathub, or k3s's own installer. Shared helpers for verified GitHub downloads, shell profile blocks and fingerprint-checked RPM keys live in _shared.sh; gpg_key_has_fingerprint is factored out of _add_apt_repo, and Pay Respects now reuses shell_rc_block_remove. Development is now sorted into IDEs & Editors, AI Tools, Languages & Runtimes, Git, Containers & Kubernetes, Virtualization, Network & Security and Distrobox folders. Claude Code, Claude Desktop, Codex, Hermes Agent and LM Studio move to AI Tools. Sublime Text is hidden on Rocky/Alma 9 and 10, nmap on openSUSE Leap, and several apps on Alpine, where no package exists. Update completions, docs, changelog and tests. Part of #91
Add seven Internet apps (part of #91): - Browser: Opera - Messaging: WhatsApp (via ZapZap), Microsoft Teams (Teams for Linux), Mattermost - VPN: Mullvad VPN, NordVPN, OpenVPN Opera, Mullvad VPN and NordVPN install from the vendor's signed repository with the key fingerprint checked. NordVPN also enables its service and adds the user to the nordvpn group. It is hidden on Rocky/Alma 8 and 9 (glibc too old) and is AUR-only on Arch. On Alpine only OpenVPN is offered. Register the apps with category, folder and description, add shell completions and docs rows, and add unit tests (502 -> 599).
Add Prism Launcher, RetroArch, Dolphin Emulator, PPSSPP, Sunshine, Moonlight, Flatseal and Gear Lever (part of #91). Each uses the distro package where a repository has one, otherwise Flathub. Sunshine always installs from Flathub and then runs its documented setup step for virtual input devices, which asks for a password in a desktop session (otherwise the command is printed). Uninstalling it removes the rules that step wrote. Gaming is now grouped into Game Launchers, Emulators, Game Streaming and Gaming Utilities. Alpine gets Prism Launcher, Moonlight, RetroArch, Dolphin Emulator and PPSSPP; Sunshine, Flatseal and Gear Lever are not offered there. Also update shell completions, docs, changelog and unit tests.
The test's sudo stub recorded every call, so its output also depended on whether the machine had systemd and enabled the service. Record only the usermod call so the assertion checks just the group membership behavior.
Add restic, rclone, Kopia, rsnapshot, Back In Time, Pika Backup, luckyBackup, Grsync and Clonezilla (fixes #92). Backup is now split into File Backup and Command Line folders beside Timeshift and Snapper. Each tool is held back where no package exists: restic and rclone on Rocky/Alma 8, Back In Time on Rocky/Alma 10, luckyBackup on RHEL clones, and Clonezilla outside Debian, Ubuntu and Arch. Back In Time and luckyBackup are AUR-only on Arch. Alpine offers restic, rclone and rsnapshot only. Kopia installs from its GitHub release with a SHA-256 check where no package exists, so add an @x64@ token for its x64/arm64 file names. Also make github_binary_install work without find on minimal images. Update the README, docs, completions, changelog and tests.
- Add 1.13.0 release heading (2026-11-14) to CHANGELOG - Update unique cloners badge to 54 - Update unit test count badge to 606 - Update distros tested badge to 7
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Release 1.13.0: adds Alpine Linux support (
apk, OpenRC, BusyBox) and about 70 new installers across Productivity, System Tools, Development, Internet, Gaming and Backup, with those categories now sorted into folders. Also fixes XEN Guest Utilities on Alpine, completes the utility catalogue indocs/utilities.md, and adds a weekly distro end-of-life check.Type of change
Checklist
devbranch (notmain)bash tests/test_linux_util.shpasses with 0 failuresshellcheck -x linux_util.sh lib/**/*.sh lib/installers/*.sh)debian,fedora|rhel,arch,suse) or has a*)fallback with a helpful messageverify_download/_verify_not_empty_or_htmlbefore installingcompletions/linux_util.bashandcompletions/_linux_util(if applicable)register_utility/register_system_taskline added tolib/installers.shin alphabetical order (if applicable)CHANGELOG.mdhas an entry under## [Unreleased](add it under### Added/### Changed/### Fixed, creating the subsection if needed)README.mdutility table andUTILITY_DESCRIPTIONupdated (if a utility was added or renamed)[[ ]],$(),info/warn/errorfor output)Testing done
CI on dev (1317c76): unit tests 606 passed, 0 failed, 7 skipped; ShellCheck clean; distro detection green on all 18 images. The new installers were run (install, update, uninstall) in Debian 13, Ubuntu 22.04/26.04, Fedora 45, Rocky 8/9/10, Arch, Tumbleweed, Leap 16.0 and Alpine 3.24 containers. System Updates was run on an Alpine 3.24 VM. Not yet run on a real desktop.
Safe to merge: yes. Existing installers behave as before; the Productivity, System Tools, Development, Gaming and Backup menus are regrouped into folders, and the separate Craft app entries (other than ArtCraft Launcher) are removed.
Upgrade needs: nothing.
Related issues
Fixes #90
Fixes #92
Part of #91 (Jellyfin is not built and Skype is left out, so it stays open)