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
Install: an install/ folder with direct download links and one-command installers
islandmede552dba63cb8
diff --git a/.github/workflows/release.yml b/.github/workflows/release.ymlindex 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@v4with: { 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: Checksumsrun: cd dist && sha256sum * > SHA256SUMS.txt && cat SHA256SUMS.txt- name: Release notes from CHANGELOGdiff --git a/README.md b/README.mdindex 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).## Buildingdiff --git a/install/README.md b/install/README.mdnew file mode 100644index 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.ps1new file mode 100644index 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 SilentlyContinuediff --git a/install/install.sh b/install/install.shnew file mode 100755index 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" ;;+esacdiff --git a/packaging/release-notes-footer.md b/packaging/release-notes-footer.mdindex 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.htmlindex 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>, withSHA-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 & Intel · .dmg</span></a>- <a class="dl" href="https://github.com/islandmed/SculptForge/releases/latest">- <strong>Ubuntu / Debian</strong><span>.deb · x86_64 & ARM64</span></a>- <a class="dl" href="https://github.com/islandmed/SculptForge/releases/latest">- <strong>Fedora / RHEL 9+</strong><span>.rpm · x86_64 & 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>