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.

Install: an install/ folder with direct download links and one-command installers

islandmede552dba63cb8
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 301c4bc9..6a380123 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -151,6 +151,19 @@ jobs:
with: { ref: '${{ env.TAG }}' }
- uses: actions/download-artifact@v4
with: { path: dist, merge-multiple: true }
+ - name: Version-less copies (fixed links such as releases/latest/download/SculptForge-macos.dmg)
+ run: |
+ cd dist
+ V=${TAG#v}
+ cp "SculptForge-$V-windows-x86_64.exe" SculptForge-windows-x86_64-setup.exe
+ cp "SculptForge-$V-windows-x86_64.zip" SculptForge-windows-x86_64-portable.zip
+ cp "SculptForge-$V-darwin-universal.dmg" SculptForge-macos.dmg
+ cp "SculptForge-$V-linux-x86_64.AppImage" SculptForge-linux-x86_64.AppImage
+ cp "SculptForge-$V-linux-arm64.AppImage" SculptForge-linux-arm64.AppImage
+ cp "sculptforge_${V}_amd64.deb" sculptforge_amd64.deb
+ cp "sculptforge_${V}_arm64.deb" sculptforge_arm64.deb
+ cp "sculptforge-$V-1.x86_64.rpm" sculptforge.x86_64.rpm
+ cp "sculptforge-$V-1.aarch64.rpm" sculptforge.aarch64.rpm
- name: Checksums
run: cd dist && sha256sum * > SHA256SUMS.txt && cat SHA256SUMS.txt
- name: Release notes from CHANGELOG
diff --git a/README.md b/README.md
index 19fba710..9c596d08 100644
--- a/README.md
+++ b/README.md
@@ -163,21 +163,27 @@ you modify it in-house without publishing your changes. See **[docs/studios.md](
## Install
-Download the latest build for your system from the
-**[releases page](https://github.com/islandmed/SculptForge/releases/latest)**:
+**[Download for Windows](https://github.com/islandmed/SculptForge/releases/latest/download/SculptForge-windows-x86_64-setup.exe)** ·
+**[Download for macOS](https://github.com/islandmed/SculptForge/releases/latest/download/SculptForge-macos.dmg)** ·
+**[Download for Linux](https://github.com/islandmed/SculptForge/releases/latest/download/SculptForge-linux-x86_64.AppImage)** (AppImage, x86_64)
-| System | Package |
-|---|---|
-| Windows 10/11 | Installer (`.exe`) or portable `.zip` |
-| macOS 11+ (Apple Silicon & Intel) | `.dmg` |
-| Ubuntu / Debian / Mint / Pop!_OS | `.deb` (x86_64, ARM64): `sudo apt install ./sculptforge_*.deb` |
-| Fedora / RHEL / Rocky / Alma 8+ | `.rpm` (x86_64, ARM64): `sudo dnf install ./sculptforge-*.rpm` |
-| Studio pipelines | VFX Reference Platform `…-vfx2026.tar.gz` / `…-vfx2027.tar.gz`, or the [Rez package](packaging/rez/package.py) |
-| Any Linux | `.AppImage` (x86_64, ARM64) |
-| Arch Linux | AUR: `yay -S sculptforge` ([PKGBUILD](packaging/arch/PKGBUILD)) |
+Every link gets the newest version. **[install/](install/README.md)** has the full list (.deb, .rpm, ARM64,
+portable .zip, Arch) and what to do after downloading. Or install with one command:
+
+```sh
+# macOS / Linux
+curl -fsSL https://raw.githubusercontent.com/islandmed/SculptForge/main/install/install.sh | sh
+```
+
+```powershell
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/islandmed/SculptForge/main/install/install.ps1 | iex
+```
The builds aren't code-signed yet. On **macOS**, right-click the app and choose **Open** the first time. On
-**Windows**, if SmartScreen appears, choose **More info → Run anyway**.
+**Windows**, if SmartScreen appears, choose **More info → Run anyway**. Studio builds (VFX Reference Platform,
+[Rez](packaging/rez/package.py)), older versions and checksums are on the
+[releases page](https://github.com/islandmed/SculptForge/releases).
## Building
diff --git a/install/README.md b/install/README.md
new file mode 100644
index 00000000..55e0f1bc
--- /dev/null
+++ b/install/README.md
@@ -0,0 +1,46 @@
+# Install SculptForge
+
+Pick your system and click the link. It always downloads the newest version.
+
+| System | Download |
+|---|---|
+| **Windows 10 / 11** | [Installer (.exe)](https://github.com/islandmed/SculptForge/releases/latest/download/SculptForge-windows-x86_64-setup.exe) · [portable .zip](https://github.com/islandmed/SculptForge/releases/latest/download/SculptForge-windows-x86_64-portable.zip) |
+| **macOS 11+** (Apple Silicon and Intel) | [SculptForge.dmg](https://github.com/islandmed/SculptForge/releases/latest/download/SculptForge-macos.dmg) |
+| **Ubuntu / Debian / Mint / Pop!_OS** | [.deb for PCs (x86_64)](https://github.com/islandmed/SculptForge/releases/latest/download/sculptforge_amd64.deb) · [.deb for ARM64](https://github.com/islandmed/SculptForge/releases/latest/download/sculptforge_arm64.deb) |
+| **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) |
+| **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` |
+
+Not sure which Linux file? Most PCs are x86_64; ARM64 is for Raspberry Pi, Apple Silicon Macs running Linux
+and ARM laptops.
+
+## Then
+
+- **Windows:** run the installer. If SmartScreen says "Windows protected your PC", click **More info** →
+ **Run anyway** (the app isn't code-signed yet).
+- **macOS:** open the .dmg and drag SculptForge into Applications. The first time, right-click the app and
+ choose **Open**.
+- **Ubuntu / Debian:** `sudo apt install ./sculptforge_amd64.deb` (or double-click the file).
+- **Fedora / RHEL:** `sudo dnf install ./sculptforge.x86_64.rpm`
+- **AppImage:** make it executable (`chmod +x SculptForge-*.AppImage`) and run it.
+
+## Or install with one command
+
+**macOS / Linux** (installs for your user, no admin password):
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/islandmed/SculptForge/main/install/install.sh | sh
+```
+
+**Windows** (PowerShell):
+
+```powershell
+irm https://raw.githubusercontent.com/islandmed/SculptForge/main/install/install.ps1 | iex
+```
+
+Both download the latest release from GitHub and check it against the release's SHA-256 checksums before
+installing. Run the same command again to update. To uninstall on macOS / Linux, add `-s -- --uninstall`
+after `sh`; on Windows, use **Settings → Apps**.
+
+Older versions, studio (VFX Reference Platform) builds and checksums are on the
+[releases page](https://github.com/islandmed/SculptForge/releases).
diff --git a/install/install.ps1 b/install/install.ps1
new file mode 100644
index 00000000..76f5b05b
--- /dev/null
+++ b/install/install.ps1
@@ -0,0 +1,49 @@
+# Installs the latest SculptForge release on Windows: downloads the installer, checks it against the
+# release's SHA256SUMS.txt and runs it.
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# irm https://raw.githubusercontent.com/islandmed/SculptForge/main/install/install.ps1 | iex
+# & ([scriptblock]::Create((irm .../install.ps1))) -Version v0.3.0 a specific release
+# & ([scriptblock]::Create((irm .../install.ps1))) -Portable the .zip into %LOCALAPPDATA%\SculptForge
+param([string]$Version = '', [switch]$Portable)
+$ErrorActionPreference = 'Stop'
+$ProgressPreference = 'SilentlyContinue' # Invoke-WebRequest is far faster without the progress bar
+$repo = 'islandmed/SculptForge'
+
+if (-not $Version) { $Version = (Invoke-RestMethod "https://api.github.com/repos/$repo/releases/latest").tag_name }
+if ($Version -notmatch '^v\d') { throw "SculptForge: could not find the latest release (got '$Version')" }
+$v = $Version.Substring(1)
+$url = "https://github.com/$repo/releases/download/$Version"
+$tmp = Join-Path ([IO.Path]::GetTempPath()) "sculptforge-$v"
+New-Item -ItemType Directory -Force $tmp | Out-Null
+
+function Get-Asset([string]$name) {
+ Write-Host "SculptForge: downloading $name"
+ $file = Join-Path $tmp $name
+ Invoke-WebRequest "$url/$name" -OutFile $file -UseBasicParsing
+ $sums = Invoke-WebRequest "$url/SHA256SUMS.txt" -UseBasicParsing
+ $line = ($sums.Content -split "`n") | Where-Object { $_ -match " $([regex]::Escape($name))\s*$" } | Select-Object -First 1
+ if (-not $line) { throw "SculptForge: $name is not in SHA256SUMS.txt" }
+ $want = ($line -split ' ')[0].ToUpper()
+ if ((Get-FileHash $file -Algorithm SHA256).Hash -ne $want) { throw "SculptForge: $name checksum mismatch, not installing" }
+ return $file
+}
+
+if ($Portable) {
+ $zip = Get-Asset "SculptForge-$v-windows-x86_64.zip"
+ $dest = Join-Path $env:LOCALAPPDATA 'SculptForge'
+ if (Test-Path $dest) { Remove-Item -Recurse -Force $dest }
+ Expand-Archive $zip -DestinationPath $tmp -Force
+ Move-Item (Join-Path $tmp "SculptForge-$v-windows-x86_64") $dest
+ $shortcut = (New-Object -ComObject WScript.Shell).CreateShortcut(
+ (Join-Path ([Environment]::GetFolderPath('Programs')) 'SculptForge.lnk'))
+ $shortcut.TargetPath = Join-Path $dest 'bin\sculptforge.exe'
+ $shortcut.Save()
+ Write-Host "SculptForge: installed $Version in $dest (Start menu: SculptForge)"
+} else {
+ $setup = Get-Asset "SculptForge-$v-windows-x86_64.exe"
+ Write-Host "SculptForge: starting the installer"
+ Start-Process $setup -Wait
+ Write-Host "SculptForge: done"
+}
+Remove-Item -Recurse -Force $tmp -ErrorAction SilentlyContinue
diff --git a/install/install.sh b/install/install.sh
new file mode 100755
index 00000000..f64edba5
--- /dev/null
+++ b/install/install.sh
@@ -0,0 +1,109 @@
+#!/bin/sh
+# Installs the latest SculptForge release for the current user (no admin rights needed).
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# curl -fsSL https://raw.githubusercontent.com/islandmed/SculptForge/main/install/install.sh | sh
+# curl -fsSL .../install.sh | sh -s -- --version v0.3.0 a specific release
+# curl -fsSL .../install.sh | sh -s -- --uninstall
+#
+# Linux: the AppImage, unpacked into ~/.local/share/sculptforge (no FUSE needed), with `sculptforge` and
+# `sculptforge-cli` in ~/.local/bin and a menu entry.
+# macOS: SculptForge.app into /Applications (or ~/Applications), `sculptforge-cli` in ~/.local/bin.
+# Every download is checked against the release's SHA256SUMS.txt.
+set -eu
+
+REPO=islandmed/SculptForge
+VERSION=
+UNINSTALL=0
+while [ $# -gt 0 ]; do
+ case $1 in
+ --version) VERSION=$2; shift 2 ;;
+ --uninstall) UNINSTALL=1; shift ;;
+ *) echo "install.sh: unknown option $1" >&2; exit 1 ;;
+ esac
+done
+
+BIN=${XDG_BIN_HOME:-$HOME/.local/bin}
+DATA=${XDG_DATA_HOME:-$HOME/.local/share}
+say() { printf '%s\n' "SculptForge: $*"; }
+die() { printf '%s\n' "SculptForge: $*" >&2; exit 1; }
+
+OS=$(uname -s)
+case $OS in
+ Linux|Darwin) ;;
+ *) die "this script is for Linux and macOS; on Windows run: irm https://raw.githubusercontent.com/$REPO/main/install/install.ps1 | iex" ;;
+esac
+
+if [ $UNINSTALL = 1 ]; then
+ rm -rf "$DATA/sculptforge" "$BIN/sculptforge" "$BIN/sculptforge-cli" \
+ "$DATA/applications/org.sculptforge.SculptForge.desktop" \
+ "$DATA/icons/hicolor/256x256/apps/org.sculptforge.SculptForge.png"
+ [ $OS = Darwin ] && rm -rf /Applications/SculptForge.app "$HOME/Applications/SculptForge.app"
+ say "uninstalled (your settings and brushes are kept)"
+ exit 0
+fi
+
+command -v curl >/dev/null || die "needs curl"
+if [ -z "$VERSION" ]; then # the tag that releases/latest redirects to
+ VERSION=$(curl -fsSLI -o /dev/null -w '%{url_effective}' "https://github.com/$REPO/releases/latest")
+ VERSION=${VERSION##*/}
+fi
+case $VERSION in v[0-9]*) ;; *) die "could not find the latest release (got '$VERSION')" ;; esac
+V=${VERSION#v}
+URL=https://github.com/$REPO/releases/download/$VERSION
+
+TMP=$(mktemp -d)
+trap 'rm -rf "$TMP"' EXIT
+
+fetch() { # asset name -> $TMP/name, checked against SHA256SUMS.txt
+ say "downloading $1"
+ curl -fL --progress-bar -o "$TMP/$1" "$URL/$1" || die "download failed: $URL/$1"
+ [ -f "$TMP/SHA256SUMS.txt" ] || curl -fsSL -o "$TMP/SHA256SUMS.txt" "$URL/SHA256SUMS.txt"
+ want=$(grep " $1\$" "$TMP/SHA256SUMS.txt" | cut -d' ' -f1)
+ [ -n "$want" ] || die "$1 is not in SHA256SUMS.txt"
+ if command -v sha256sum >/dev/null; then got=$(sha256sum "$TMP/$1" | cut -d' ' -f1)
+ else got=$(shasum -a 256 "$TMP/$1" | cut -d' ' -f1); fi
+ [ "$got" = "$want" ] || die "$1: checksum mismatch, not installing"
+}
+
+mkdir -p "$BIN"
+if [ $OS = Linux ]; then
+ case $(uname -m) in
+ x86_64|amd64) ARCH=x86_64 ;;
+ aarch64|arm64) ARCH=arm64 ;;
+ *) die "no Linux build for $(uname -m) yet; see https://github.com/$REPO#building" ;;
+ esac
+ APPIMAGE=SculptForge-$V-linux-$ARCH.AppImage
+ fetch "$APPIMAGE"
+ chmod +x "$TMP/$APPIMAGE"
+ (cd "$TMP" && "./$APPIMAGE" --appimage-extract >/dev/null) || die "could not unpack $APPIMAGE"
+ rm -rf "$DATA/sculptforge"
+ mkdir -p "$DATA"
+ mv "$TMP/squashfs-root" "$DATA/sculptforge"
+ ln -sf "$DATA/sculptforge/AppRun" "$BIN/sculptforge"
+ ln -sf "$DATA/sculptforge/usr/bin/sculptforge-cli" "$BIN/sculptforge-cli"
+ mkdir -p "$DATA/applications" "$DATA/icons/hicolor/256x256/apps"
+ cp "$DATA/sculptforge/usr/share/icons/hicolor/256x256/apps/org.sculptforge.SculptForge.png" \
+ "$DATA/icons/hicolor/256x256/apps/"
+ sed "s|^Exec=.*|Exec=$DATA/sculptforge/AppRun %f|" \
+ "$DATA/sculptforge/usr/share/applications/org.sculptforge.SculptForge.desktop" \
+ >"$DATA/applications/org.sculptforge.SculptForge.desktop"
+ command -v update-desktop-database >/dev/null && update-desktop-database -q "$DATA/applications" 2>/dev/null || true
+else
+ DMG=SculptForge-$V-darwin-universal.dmg
+ fetch "$DMG"
+ hdiutil attach -nobrowse -quiet -mountpoint "$TMP/dmg" "$TMP/$DMG" || die "could not open $DMG"
+ DEST=/Applications
+ [ -w "$DEST" ] || { DEST=$HOME/Applications; mkdir -p "$DEST"; }
+ rm -rf "$DEST/SculptForge.app"
+ cp -R "$TMP/dmg/SculptForge.app" "$DEST/"
+ hdiutil detach -quiet "$TMP/dmg" || true
+ ln -sf "$DEST/SculptForge.app/Contents/MacOS/sculptforge-cli" "$BIN/sculptforge-cli"
+ say "installed $DEST/SculptForge.app"
+fi
+
+say "installed $VERSION"
+case :$PATH: in
+ *:"$BIN":*) ;;
+ *) say "add $BIN to your PATH to use sculptforge-cli from a terminal" ;;
+esac
diff --git a/packaging/release-notes-footer.md b/packaging/release-notes-footer.md
index 28299d16..38655778 100644
--- a/packaging/release-notes-footer.md
+++ b/packaging/release-notes-footer.md
@@ -3,6 +3,13 @@
### Downloads
+New here? **[install/](https://github.com/islandmed/SculptForge/tree/main/install#install-sculptforge)** explains
+which file to pick, or install with one command:
+`curl -fsSL https://raw.githubusercontent.com/islandmed/SculptForge/main/install/install.sh | sh` (macOS / Linux),
+`irm https://raw.githubusercontent.com/islandmed/SculptForge/main/install/install.ps1 | iex` (Windows PowerShell).
+Each file is also attached without its version number (e.g. `SculptForge-macos.dmg`) so links to
+`releases/latest/download/...` always get the newest build.
+
| Platform | File |
|---|---|
| Windows 10/11 (x64) | `SculptForge-…-windows-x86_64.exe` (installer) or `.zip` (portable) |
diff --git a/website/index.html b/website/index.html
index 56e20949..2c1e8eb9 100644
--- a/website/index.html
+++ b/website/index.html
@@ -319,16 +319,16 @@ rez-env sculptforge -- sculptforge troll.usda \
<a href="https://github.com/islandmed/SculptForge/releases/latest">latest GitHub release</a>, with
SHA-256 checksums.</p>
<div class="downloads">
- <a class="dl" href="https://github.com/islandmed/SculptForge/releases/latest">
- <strong>Windows</strong><span>10 / 11 · installer or portable .zip</span></a>
- <a class="dl" href="https://github.com/islandmed/SculptForge/releases/latest">
+ <a class="dl" href="https://github.com/islandmed/SculptForge/releases/latest/download/SculptForge-windows-x86_64-setup.exe">
+ <strong>Windows</strong><span>10 / 11 · installer (.exe)</span></a>
+ <a class="dl" href="https://github.com/islandmed/SculptForge/releases/latest/download/SculptForge-macos.dmg">
<strong>macOS</strong><span>11+ · Apple Silicon &amp; Intel · .dmg</span></a>
- <a class="dl" href="https://github.com/islandmed/SculptForge/releases/latest">
- <strong>Ubuntu / Debian</strong><span>.deb · x86_64 &amp; ARM64</span></a>
- <a class="dl" href="https://github.com/islandmed/SculptForge/releases/latest">
- <strong>Fedora / RHEL 9+</strong><span>.rpm · x86_64 &amp; ARM64</span></a>
- <a class="dl" href="https://github.com/islandmed/SculptForge/releases/latest">
- <strong>Any Linux</strong><span>AppImage · runs anywhere</span></a>
+ <a class="dl" href="https://github.com/islandmed/SculptForge/releases/latest/download/sculptforge_amd64.deb">
+ <strong>Ubuntu / Debian</strong><span>.deb · x86_64 (ARM64: see all downloads)</span></a>
+ <a class="dl" href="https://github.com/islandmed/SculptForge/releases/latest/download/sculptforge.x86_64.rpm">
+ <strong>Fedora / RHEL 9+</strong><span>.rpm · x86_64 (ARM64: see all downloads)</span></a>
+ <a class="dl" href="https://github.com/islandmed/SculptForge/releases/latest/download/SculptForge-linux-x86_64.AppImage">
+ <strong>Any Linux</strong><span>AppImage · x86_64, runs anywhere</span></a>
<div class="dl static">
<strong>Arch Linux</strong><span><code>yay -S sculptforge</code></span></div>
<a class="dl vfx-dl" href="https://github.com/islandmed/SculptForge/releases/latest">
@@ -336,6 +336,10 @@ rez-env sculptforge -- sculptforge troll.usda \
<a class="dl" href="https://github.com/islandmed/SculptForge/blob/main/docs/studios.md#deploying-with-rez">
<strong>Rez</strong><span><code>packaging/rez</code> · build and install your own package</span></a>
</div>
+ <p class="fine">Each button downloads the newest version.
+ <a href="https://github.com/islandmed/SculptForge/tree/main/install#install-sculptforge">All downloads</a>
+ (ARM64, portable .zip, one-command install) ·
+ <a href="https://github.com/islandmed/SculptForge/releases">older versions</a>.</p>
<p class="fine">The builds aren't code-signed yet. On macOS, right-click the app and choose <em>Open</em>
the first time. On Windows, if SmartScreen appears, choose <em>More info → Run anyway</em>.
You can also <a href="https://github.com/islandmed/SculptForge#building">build from source</a>.</p>