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.
C++ 3d3d-sculptingcppdear-imguidigital-sculptingfbxgame-developmentgaussian-splattinggltfimage-to-3dmcpopenglopenusdsculptingtext-to-3dunreal-engine
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.ymlnew file mode 100644index 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.txtdiff --git a/docs/guide/installing.md b/docs/guide/installing.mdindex 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/installBoth 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 filearrived intact.@@ -240,9 +255,10 @@ The sign-in can only read the member repository's releases (nothing else on yoursystem's keychain (Windows Credential Manager, or the Secret Service on Linux such as GNOME Keyring or KWallet; neverin 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, brushesand library are kept: they live in your user folders, not next to the program (seediff --git a/docs/releasing.md b/docs/releasing.mdindex 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.mdindex 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 Linuxand ARM laptops.diff --git a/packaging/arch/.SRCINFO b/packaging/arch/.SRCINFOnew file mode 100644index 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 = sculptforgediff --git a/packaging/arch/.gitignore b/packaging/arch/.gitignorenew file mode 100644index 00000000..33cc181e--- /dev/null+++ b/packaging/arch/.gitignore@@ -0,0 +1,5 @@+src/+pkg/+*.tar.gz+*.pkg.tar.*+namcap.txtdiff --git a/packaging/arch/PKGBUILD b/packaging/arch/PKGBUILDindex 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, foarch=('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.mdindex 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.mdnew file mode 100644index 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.shnew file mode 100755index 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.shindex 06f9c13a..64ca70c8 100755--- a/scripts/release.sh+++ b/scripts/release.sh@@ -48,6 +48,9 @@ INSIDERS_REPO=islandmed/sculptforge-insiders # members' betas (release.yml publiMEMBER_ENV=member-releaseAUTHOR_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.gitOMARCHY_PR=1800STEPS=(bump check ci tag release site aur brew omarchy replies status)@@ -336,6 +339,12 @@ preflight() {pk=packaging/arch/PKGBUILDgrep -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; thenok "packaging/arch/PKGBUILD already builds $V ($sum)"+ aur_pushreturnfipython3 - "$V" "$sum" <<'PY'@@ -704,10 +714,31 @@ open(p, "w", encoding="utf-8").write(t)PYgrep -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/.SRCINFOcommit -m "AUR PKGBUILD builds $V"push_mainok "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() {