Skip to content

Free, open-source 3D sculpting for Linux, macOS and Windows: dense meshes, remeshing, painting, built-in AI (image/text to 3D), Send to Unreal, game-ready LODs, Gaussian splats and OpenUSD.

AUR: ready-to-run submission (SUBMIT.md), .SRCINFO, zstd dependency, clean-container makepkg + namcap CI; release.sh pushes to the AUR once ~/Work/.sf/aur-publish exists; install docs say what exists today (#149)

islandmed19908f7bdb6c
diff --git a/.github/workflows/arch.yml b/.github/workflows/arch.yml
new file mode 100644
index 00000000..d166d51a
--- /dev/null
+++ b/.github/workflows/arch.yml
@@ -0,0 +1,47 @@
+name: Arch package
+
+# packaging/arch/PKGBUILD (the AUR package) built from scratch in a clean Arch container, as an AUR user's makepkg
+# would: the release tag it names, Arch's own SDL3 and curl, check() included. namcap must find no errors in the
+# PKGBUILD or the package, and .SRCINFO must be what `makepkg --printsrcinfo` prints. Runs when packaging/arch
+# changes (scripts/release.sh step aur bumps it on main each release) and by hand.
+# The image is pinned by digest (update: the docker-content-digest of archlinux:base-devel).
+
+on:
+ push:
+ paths:
+ - packaging/arch/**
+ - .github/workflows/arch.yml
+ workflow_dispatch:
+
+permissions:
+ contents: read
+
+jobs:
+ makepkg:
+ runs-on: ubuntu-latest
+ timeout-minutes: 75
+ container:
+ image: archlinux:base-devel@sha256:2de80105abb49f813a85393c6758a4334deb6bcec4a2411bd2f059c0bee6ee4c
+ steps:
+ - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+ with:
+ persist-credentials: false
+ - name: Builder user
+ run: |
+ pacman -Syu --noconfirm --needed namcap
+ useradd -m builder
+ echo 'builder ALL=(ALL) NOPASSWD: /usr/bin/pacman' > /etc/sudoers.d/builder
+ cp -r packaging/arch /home/builder/pkg
+ chown -R builder: /home/builder/pkg
+ - name: .SRCINFO matches the PKGBUILD
+ working-directory: /home/builder/pkg
+ run: su builder -c 'makepkg --printsrcinfo' | diff -u .SRCINFO -
+ - name: makepkg (dependencies from the Arch repositories, check() runs)
+ working-directory: /home/builder/pkg
+ run: su builder -c 'MAKEFLAGS=-j4 makepkg --syncdeps --noconfirm --cleanbuild'
+ - name: namcap
+ working-directory: /home/builder/pkg
+ run: |
+ namcap -i PKGBUILD | tee namcap.txt
+ namcap -i ./*.pkg.tar.zst | tee -a namcap.txt
+ ! grep -E '^[^ ]+ E: ' namcap.txt
diff --git a/docs/guide/installing.md b/docs/guide/installing.md
index 7b826297..3803809c 100644
--- a/docs/guide/installing.md
+++ b/docs/guide/installing.md
@@ -31,7 +31,7 @@ Each link below downloads the newest version. Pick the one for your system:
| Fedora, RHEL, Rocky, Alma 8+ | [.rpm for x86_64](https://github.com/islandmed/SculptForge/releases/latest/download/sculptforge.x86_64.rpm) or [ARM64](https://github.com/islandmed/SculptForge/releases/latest/download/sculptforge.aarch64.rpm) | `sudo dnf install ./sculptforge.x86_64.rpm` |
| Any Linux | [AppImage for x86_64](https://github.com/islandmed/SculptForge/releases/latest/download/SculptForge-linux-x86_64.AppImage) or [ARM64](https://github.com/islandmed/SculptForge/releases/latest/download/SculptForge-linux-arm64.AppImage) | `chmod +x` the file, then run it |
| Any Linux, sandboxed | [Flatpak for x86_64](https://github.com/islandmed/SculptForge/releases/latest/download/SculptForge-linux-x86_64.flatpak) or [ARM64](https://github.com/islandmed/SculptForge/releases/latest/download/SculptForge-linux-arm64.flatpak) | `flatpak install --user ./SculptForge-linux-x86_64.flatpak` (see [Flatpak](#flatpak)) |
-| Arch Linux | `packaging/arch/PKGBUILD` in the source | `makepkg -si` in that folder (an AUR package is planned) |
+| Arch Linux | `packaging/arch/PKGBUILD` in the source | `makepkg -si` in that folder (the AUR package isn't published yet; see [Package managers](#package-managers)) |
| Studio pipelines | `SculptForge-<version>-...-vfx2026.tar.gz` or `...-vfx2027.tar.gz` | See [SculptForge for studios](studios.md) |
Most PCs are x86_64; ARM64 is for ARM laptops, Raspberry Pi and Apple Silicon Macs running Linux. Older
@@ -55,6 +55,21 @@ irm https://raw.githubusercontent.com/islandmed/SculptForge/main/install/install
Both check the download against the release's checksums before installing. To uninstall on macOS or Linux,
run the first command with `sh -s -- --uninstall` at the end instead of `sh`.
+### Package managers
+
+Where SculptForge is in a package manager today, so it updates with the rest of your system:
+
+| Package manager | Status | Command |
+|---|---|---|
+| Homebrew (macOS) | **Available** | `brew install --cask islandmed/tap/sculptforge`, then `brew upgrade` |
+| winget (Windows) | **Submitted, in review** at winget-pkgs; not installable yet | Use the installer or the one-command install meanwhile |
+| AUR (Arch Linux) | **Ready, not published yet** | Until then: `makepkg -si` in `packaging/arch` |
+| Omarchy | **Submitted, in review** at omarchy-pkgs | As for Arch meanwhile |
+| apt (Debian, Ubuntu) and dnf (Fedora, RHEL) repositories | **Not yet; being built** ([#149](https://github.com/islandmed/SculptForge/issues/149)) | Install the `.deb` or `.rpm` file; SculptForge tells you when a new version is out |
+| Flathub | **Not published**; the Flatpak is a single file (see [Flatpak](#flatpak)) | `flatpak install --user ./SculptForge-linux-x86_64.flatpak` |
+
+This table changes as each one goes live.
+
Every release also has a `SHA256SUMS.txt` file with the checksum of each download, so you can confirm a file
arrived intact.
@@ -240,9 +255,10 @@ The sign-in can only read the member repository's releases (nothing else on your
system's keychain (Windows Credential Manager, or the Secret Service on Linux such as GNOME Keyring or KWallet; never
in SculptForge's settings), and **Sign out** removes it. Without a keychain the sign-in lasts until you quit.
-Installs that belong to a package manager are never replaced by the app: the AUR package (Omarchy's too) builds
-without the update check, a Homebrew install shows `brew upgrade --cask sculptforge`, and the Flatpak, `.deb`
-and `.rpm` files say to download the new file and open it. The macOS app shows **Download** for now.
+Installs that belong to a package manager are never replaced by the app: the Arch PKGBUILD (and the AUR and
+Omarchy packages once they are published) builds without the update check, a Homebrew install shows
+`brew upgrade --cask sculptforge`, and the Flatpak, `.deb` and `.rpm` files say to download the new file and open
+it. The macOS app shows **Download** for now.
To update by hand, download the new release and install it over the old one. Either way your settings, brushes
and library are kept: they live in your user folders, not next to the program (see
diff --git a/docs/releasing.md b/docs/releasing.md
index 918e362f..9c877b54 100644
--- a/docs/releasing.md
+++ b/docs/releasing.md
@@ -116,7 +116,7 @@ The home page's What's New area (between the `whats-new` markers in website/inde
| tag | checks main is the staged commit with a promotable run, asks, then tags it and pushes the tag (this publishes) | the tag is on GitHub |
| release | waits for the Release run, then checks the assets and SHA256SUMS.txt | the release has SHA256SUMS.txt |
| site | update feed (version + your highlights), home page version text, pushes; then waits for the live feed (10 min) and guide (5 min) | latest.json says X.Y.Z |
-| aur | packaging/arch/PKGBUILD: pkgver and the source checksum, computed by downloading the tag's tarball | already at X.Y.Z with that checksum |
+| aur | packaging/arch/PKGBUILD: pkgver and the source checksum, computed by downloading the tag's tarball, and `.SRCINFO`; then, once `~/Work/.sf/aur-publish` exists (packaging/arch/SUBMIT.md), pushes both to the AUR | already at X.Y.Z with that checksum (and the AUR at X.Y.Z) |
| brew | Homebrew cask through tools/publish/setup-channels.sh, after checking the .dmg's checksum here | the cask is at X.Y.Z |
| omarchy | bumps the PKGBUILD on our branch of omacom/omarchy-pkgs#1800 (author islandmed noreply) | the PR is at X.Y.Z |
| replies | writes `release-replies-X.Y.Z.md`: a draft per issue named in the CHANGELOG section; posts nothing | never |
diff --git a/install/README.md b/install/README.md
index e564713d..9a11331a 100644
--- a/install/README.md
+++ b/install/README.md
@@ -10,7 +10,7 @@ Pick your system and click the link. It always downloads the newest version.
| **Fedora / RHEL / Rocky / Alma** | [.rpm for PCs (x86_64)](https://github.com/islandmed/SculptForge/releases/latest/download/sculptforge.x86_64.rpm) · [.rpm for ARM64](https://github.com/islandmed/SculptForge/releases/latest/download/sculptforge.aarch64.rpm) |
| **macOS (Homebrew)** | `brew install --cask islandmed/tap/sculptforge` |
| **Any Linux** | [AppImage for PCs (x86_64)](https://github.com/islandmed/SculptForge/releases/latest/download/SculptForge-linux-x86_64.AppImage) · [AppImage for ARM64](https://github.com/islandmed/SculptForge/releases/latest/download/SculptForge-linux-arm64.AppImage) |
-| **Arch Linux** | `yay -S sculptforge` |
+| **Arch Linux** | [`packaging/arch/PKGBUILD`](../packaging/arch) with `makepkg -si` (AUR package not published yet) |
Not sure which Linux file? Most PCs are x86_64; ARM64 is for Raspberry Pi, Apple Silicon Macs running Linux
and ARM laptops.
diff --git a/packaging/arch/.SRCINFO b/packaging/arch/.SRCINFO
new file mode 100644
index 00000000..d0a7c2cc
--- /dev/null
+++ b/packaging/arch/.SRCINFO
@@ -0,0 +1,25 @@
+pkgbase = sculptforge
+ pkgdesc = Free, open-source digital sculpting app with classic sculpting keys, for artists and game pipelines
+ pkgver = 0.11.8
+ pkgrel = 1
+ url = https://sculptforge.app/
+ arch = x86_64
+ arch = aarch64
+ license = GPL-3.0-or-later
+ makedepends = cmake
+ depends = sdl3
+ depends = curl
+ depends = zstd
+ depends = gcc-libs
+ depends = glibc
+ depends = libglvnd
+ optdepends = ollama: local AI for the Brush Lab
+ optdepends = ffmpeg: recording demo videos (sculptforge --record)
+ source = sculptforge-0.11.8.tar.gz::https://github.com/islandmed/SculptForge/archive/refs/tags/v0.11.8.tar.gz
+ source = imgui-1.91.9.tar.gz::https://github.com/ocornut/imgui/archive/refs/tags/v1.91.9.tar.gz
+ source = glm-1.0.1.tar.gz::https://github.com/g-truc/glm/archive/refs/tags/1.0.1.tar.gz
+ sha256sums = 5665fd99665d577b367194770538b2cda5eca5c872f0b9d3f8de94e0ed9a1a47
+ sha256sums = 3872a5f90df78fced023c1945f4466b654fd74573370b77b17742149763a7a7c
+ sha256sums = 9f3174561fd26904b23f0db5e560971cbf9b3cbda0b280f04d5c379d03bf234c
+
+pkgname = sculptforge
diff --git a/packaging/arch/.gitignore b/packaging/arch/.gitignore
new file mode 100644
index 00000000..33cc181e
--- /dev/null
+++ b/packaging/arch/.gitignore
@@ -0,0 +1,5 @@
+src/
+pkg/
+*.tar.gz
+*.pkg.tar.*
+namcap.txt
diff --git a/packaging/arch/PKGBUILD b/packaging/arch/PKGBUILD
index f20de7ff..c4406e58 100644
--- a/packaging/arch/PKGBUILD
+++ b/packaging/arch/PKGBUILD
@@ -6,7 +6,7 @@ pkgdesc="Free, open-source digital sculpting app with classic sculpting keys, fo
arch=('x86_64' 'aarch64')
url="https://sculptforge.app/"
license=('GPL-3.0-or-later')
-depends=('sdl3' 'curl' 'gcc-libs' 'glibc' 'libglvnd')
+depends=('sdl3' 'curl' 'zstd' 'gcc-libs' 'glibc' 'libglvnd')
makedepends=('cmake')
optdepends=('ollama: local AI for the Brush Lab'
'ffmpeg: recording demo videos (sculptforge --record)')
diff --git a/packaging/arch/README.md b/packaging/arch/README.md
index 444a40c2..16921c2a 100644
--- a/packaging/arch/README.md
+++ b/packaging/arch/README.md
@@ -3,13 +3,10 @@
`PKGBUILD` builds SculptForge from a release tag against Arch's own SDL3 and curl, fully offline
(Dear ImGui and GLM are pinned sources with checksums).
-## Publishing to the AUR (maintainer, once per release)
+## Status
-1. Create an AUR account at https://aur.archlinux.org and add your SSH public key to it.
-2. First time only: `git clone ssh://[email protected]/sculptforge.git aur-sculptforge`
-3. Copy this `PKGBUILD` in, set `pkgver` to the release and update the first checksum:
- `updpkgsums` (from `pacman-contrib`), then `makepkg -si` to test the build.
-4. `makepkg --printsrcinfo > .SRCINFO`
-5. `git add PKGBUILD .SRCINFO && git commit -m "Update to <version>" && git push`
+Not on the AUR yet: `SUBMIT.md` is the one-time submission. After it, `scripts/release.sh` (step `aur`) bumps this
+PKGBUILD and `.SRCINFO` every release and pushes them to the AUR. `check.sh` (and CI, `.github/workflows/arch.yml`)
+builds it in a clean Arch environment and runs namcap.
-Users then install with `yay -S sculptforge` (or any AUR helper).
+Until then: `makepkg -si` in this folder. Once published: `yay -S sculptforge` (or any AUR helper).
diff --git a/packaging/arch/SUBMIT.md b/packaging/arch/SUBMIT.md
new file mode 100644
index 00000000..24ea8f47
--- /dev/null
+++ b/packaging/arch/SUBMIT.md
@@ -0,0 +1,39 @@
+# Publishing sculptforge to the AUR (maintainer, once)
+
+What's ready: `PKGBUILD` (builds the release tag against Arch's SDL3 and curl, offline, `check()` runs the tests;
+namcap-clean and built in a clean Arch container by `.github/workflows/arch.yml`) and its `.SRCINFO`. The name
+`sculptforge` is free on the AUR (https://aur.archlinux.org/packages/sculptforge was 404 on 2026-11-06).
+
+## Before: an AUR account (browser, a minute)
+
+Register at https://aur.archlinux.org/register (any email you read; the AUR shows it only if you tick that), then **My Account > SSH
+Public Key**: paste the public key of this laptop (`cat ~/.ssh/id_ed25519.pub`; a dedicated key is fine:
+`ssh-keygen -t ed25519 -f ~/.ssh/aur` plus a `Host aur.archlinux.org` / `IdentityFile ~/.ssh/aur` /
+`User aur` block in `~/.ssh/config`).
+
+## The 4 commands (from ~/Work/Zbrush on main)
+
+```sh
+git clone ssh://[email protected]/sculptforge.git ~/Work/.sf/aur-sculptforge
+cp packaging/arch/PKGBUILD packaging/arch/.SRCINFO ~/Work/.sf/aur-sculptforge/
+git -C ~/Work/.sf/aur-sculptforge add PKGBUILD .SRCINFO && git -C ~/Work/.sf/aur-sculptforge commit -m "sculptforge $(sed -n 's/^pkgver=//p' packaging/arch/PKGBUILD)"
+git -C ~/Work/.sf/aur-sculptforge push origin master && touch ~/Work/.sf/aur-publish
+```
+
+The clone warns that the repository is empty: that's expected for a new package. The push creates the package
+page; `yay -S sculptforge` works a minute later.
+
+## After
+
+`~/Work/.sf/aur-publish` turns on the AUR push in `scripts/release.sh` (step `aur`): each release it bumps the
+PKGBUILD on main as before, regenerates `.SRCINFO`, and pushes both to the AUR as islandmed (noreply). Without the
+file the step only bumps the PKGBUILD, as today. Step `check` then also confirms the AUR accepts this machine's key
+before anything is tagged. To stop publishing: remove the file.
+
+Then the coordinator updates the install docs (docs/guide/installing.md "Package managers", install/README.md,
+the home page download note) from "ready, not published yet" to `yay -S sculptforge`, and replies on #149.
+
+## Checking it locally
+
+`packaging/arch/check.sh` repeats the CI check on this machine (aarch64): `.SRCINFO` current, namcap, a clean
+chroot build. It needs `sudo pacman -S --needed devtools namcap` once and asks for sudo to create the chroot.
diff --git a/packaging/arch/check.sh b/packaging/arch/check.sh
new file mode 100755
index 00000000..92b53e05
--- /dev/null
+++ b/packaging/arch/check.sh
@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# The AUR package, checked as the AUR expects: .SRCINFO current, namcap clean, built in a clean chroot of this
+# machine's architecture (devtools). CI does the same on x86_64 in .github/workflows/arch.yml.
+# packaging/arch/check.sh (needs: sudo pacman -S --needed devtools namcap; the chroot asks for sudo)
+set -euo pipefail
+cd "$(dirname "$0")"
+makepkg --printsrcinfo | diff -u .SRCINFO - || { echo "check: .SRCINFO is stale: makepkg --printsrcinfo > .SRCINFO"; exit 1; }
+namcap -i PKGBUILD
+chroot=${SF_ARCH_CHROOT:-$HOME/.cache/sculptforge-archroot}
+[ -d "$chroot/root" ] || { mkdir -p "$chroot"; mkarchroot "$chroot/root" base-devel; }
+makechrootpkg -c -r "$chroot"
+namcap -i ./sculptforge-*.pkg.tar.*
+echo "check: PKGBUILD builds in a clean chroot; namcap output above (E: lines are errors)"
diff --git a/scripts/release.sh b/scripts/release.sh
index 06f9c13a..64ca70c8 100755
--- a/scripts/release.sh
+++ b/scripts/release.sh
@@ -48,6 +48,9 @@ INSIDERS_REPO=islandmed/sculptforge-insiders # members' betas (release.yml publi
MEMBER_ENV=member-release
AUTHOR_NAME=islandmed
[email protected] # never a personal address in outside repos
+# The AUR push (step aur) is on once this file exists on the releasing machine (packaging/arch/SUBMIT.md makes it).
+AUR_FLAG=${AUR_FLAG:-$HOME/Work/.sf/aur-publish}
+AUR_REPO=ssh://[email protected]/sculptforge.git
OMARCHY_PR=1800
STEPS=(bump check ci tag release site aur brew omarchy replies status)
@@ -336,6 +339,12 @@ preflight() {
pk=packaging/arch/PKGBUILD
grep -q '^pkgver=' "$pk" && grep -q '^pkgrel=' "$pk" && grep -Eq "^sha256sums=\('[0-9a-f]{64}'" "$pk" ||
die "$pk lacks the pkgver=, pkgrel= or sha256sums=('<64 hex>' line that step aur rewrites" "restore them, commit"
+ (cd packaging/arch && makepkg --printsrcinfo 2>/dev/null | cmp -s - .SRCINFO) ||
+ die "packaging/arch/.SRCINFO doesn't match the PKGBUILD (or makepkg is missing)" "(cd packaging/arch && makepkg --printsrcinfo > .SRCINFO), commit"
+ if [ -f "$AUR_FLAG" ]; then
+ GIT_SSH_COMMAND="ssh -o BatchMode=yes -o ConnectTimeout=15" git ls-remote "$AUR_REPO" >/dev/null 2>&1 ||
+ die "the AUR doesn't accept this machine's SSH key ($AUR_REPO), and $AUR_FLAG turns the AUR push on" "ssh -T [email protected] to see why (key in My Account on aur.archlinux.org), or remove $AUR_FLAG to skip the AUR"
+ fi
# brew
[ -x tools/publish/setup-channels.sh ] || die "tools/publish/setup-channels.sh is missing or not executable" "git checkout origin/main -- tools/publish/setup-channels.sh"
gh_file islandmed/homebrew-tap Casks/sculptforge.rb | grep '^ *version "' >/dev/null ||
@@ -690,6 +699,7 @@ step_aur() {
sum=$(tarball_sha)
if grep -q "^pkgver=$V\$" packaging/arch/PKGBUILD && grep -qF "'$sum'" packaging/arch/PKGBUILD; then
ok "packaging/arch/PKGBUILD already builds $V ($sum)"
+ aur_push
return
fi
python3 - "$V" "$sum" <<'PY'
@@ -704,10 +714,31 @@ open(p, "w", encoding="utf-8").write(t)
PY
grep -q "^pkgver=$V\$" packaging/arch/PKGBUILD && grep -qF "'$sum'" packaging/arch/PKGBUILD ||
die "couldn't update packaging/arch/PKGBUILD" "set pkgver=$V, pkgrel=1 and the first sha256sums entry to $sum by hand, commit, run again"
- git add packaging/arch/PKGBUILD
+ (cd packaging/arch && makepkg --printsrcinfo > .SRCINFO) || die "makepkg --printsrcinfo failed" "run it in packaging/arch by hand, commit, run again"
+ git add packaging/arch/PKGBUILD packaging/arch/.SRCINFO
commit -m "AUR PKGBUILD builds $V"
push_main
ok "PKGBUILD at $V, source checksum $sum (computed here)"
+ aur_push
+}
+
+# aur_push: the PKGBUILD and .SRCINFO from main to the AUR, when $AUR_FLAG exists (off until the package is submitted).
+aur_push() {
+ if [ ! -f "$AUR_FLAG" ]; then
+ echo " AUR push off ($AUR_FLAG absent; packaging/arch/SUBMIT.md publishes the package first)"
+ return
+ fi
+ rm -rf "$work/aur"
+ GIT_SSH_COMMAND="ssh -o BatchMode=yes" git clone -q "$AUR_REPO" "$work/aur" 2>/dev/null ||
+ die "can't clone $AUR_REPO" "ssh -T [email protected] to check the key, run again"
+ if [ -f "$work/aur/.SRCINFO" ] && grep -qx "$(printf '\tpkgver = %s' "$V")" "$work/aur/.SRCINFO"; then
+ ok "AUR already at $V"; return
+ fi
+ cp packaging/arch/PKGBUILD packaging/arch/.SRCINFO "$work/aur/"
+ (cd "$work/aur" && git add PKGBUILD .SRCINFO && commit -m "sculptforge $V" &&
+ GIT_SSH_COMMAND="ssh -o BatchMode=yes" git push -q origin HEAD:master) ||
+ die "pushing sculptforge $V to the AUR failed" "ssh -T [email protected] to check the key, run again"
+ ok "AUR at $V"
}
step_brew() {