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.

Native Wayland: verify packages, say it on the site/guide/README, SDL driver test, libdecor on RHEL builds

islandmed1f39db4c5ec8
diff --git a/.github/announcements/wayland.md b/.github/announcements/wayland.md
new file mode 100644
index 00000000..9c549345
--- /dev/null
+++ b/.github/announcements/wayland.md
@@ -0,0 +1,3 @@
+**SculptForge runs natively on Wayland**
+On Linux, every package (.deb, .rpm, AppImage, Flatpak, tar.gz) opens as a native Wayland window: no XWayland, sharp at 125%, 150% or 200% scaling, and pen pressure, tilt and the eraser through the Wayland tablet protocol. X11 sessions work the same, so RHEL and Rocky workstations are covered either way. No licence server, no account.
+Guide: https://sculptforge.app/guide/installing.html
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1ecdb731..122b92ed 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,12 @@ All notable changes to SculptForge are listed here. The format follows
## [Unreleased]
+### Changed
+- Linux: the native Wayland support is now documented (installing guide, site, README): every Linux package opens
+ without XWayland, stays sharp at fractional scales and reads pen pressure through tablet-v2. A test checks the
+ Linux build's SDL has both the Wayland and X11 drivers, and the RHEL/Rocky builds now include libdecor (title
+ bars on GNOME Wayland).
+
## [0.10.6] - 2026-11-01
### Added
diff --git a/README.md b/README.md
index b581596c..f622c8f4 100644
--- a/README.md
+++ b/README.md
@@ -300,6 +300,8 @@ app: F1 for Controls, Shift+F1 for the guide).
Graphics tablets (Wacom, XP-Pen, Huion ...) work through the system's tablet driver on Windows (Windows Ink),
macOS and Linux (Wayland / X11). Setup and mappings: [docs/tablet.md](docs/tablet.md).
+On Linux, SculptForge runs as a native Wayland window (no XWayland, sharp at fractional scales) or on X11.
+
## Project layout
```
diff --git a/docs/guide/installing.md b/docs/guide/installing.md
index dfc64120..7bfabc19 100644
--- a/docs/guide/installing.md
+++ b/docs/guide/installing.md
@@ -126,6 +126,24 @@ The `.deb` and `.rpm` packages add SculptForge to your desktop's application men
made executable first (`chmod +x SculptForge-*.AppImage`, or tick "Allow executing file as program" in your
file manager's properties).
+### Wayland and X11
+
+Every Linux package (.deb, .rpm, AppImage, Flatpak, tar.gz) opens as a native Wayland window on a Wayland
+desktop, without XWayland, and as a normal X11 window on an X11 session. On Wayland the window stays sharp at
+fractional and HiDPI scales (125%, 150%, 200%), and title bars come from the desktop (or from libdecor on GNOME).
+
+To force X11 (for example, a screen recorder or remote-desktop tool that only captures X11 windows), start
+SculptForge with:
+
+```sh
+SDL_VIDEO_DRIVER=x11 sculptforge
+```
+
+Pen tablets work on both. On Wayland, pressure, tilt, the eraser end and side buttons come through the
+desktop's tablet protocol (tablet-v2), so the tablet must be set up in your desktop's settings rather than
+through X11 tools such as `xsetwacom`. If pressure doesn't respond, check **Preferences > Tablet** for the
+live pressure reading.
+
## What you see at start-up
SculptForge opens a 1600 x 960 window with a sphere ready to sculpt and the **Library** open along the top of
diff --git a/packaging/linux/install-build-deps.sh b/packaging/linux/install-build-deps.sh
index f0983f03..9780aeef 100755
--- a/packaging/linux/install-build-deps.sh
+++ b/packaging/linux/install-build-deps.sh
@@ -17,6 +17,8 @@ elif command -v dnf >/dev/null 2>&1; then
libX11-devel libXext-devel libXrandr-devel libXcursor-devel libXfixes-devel libXi-devel libXScrnSaver-devel \
libXtst-devel libxkbcommon-devel wayland-devel wayland-protocols-devel mesa-libEGL-devel mesa-libGL-devel \
dbus-devel systemd-devel libcurl-devel
+ # Window title bars on Wayland desktops without server-side decorations (GNOME); EL9+ has it in CRB, EL8 doesn't.
+ dnf -y install libdecor-devel 2>/dev/null || true
# EL8/EL9 ship older system compilers. GCC 14 matches the VFX Reference Platform (CY2026/CY2027).
dnf -y install gcc-toolset-14 2>/dev/null || dnf -y install gcc-toolset-13 2>/dev/null || true
else
diff --git a/tests/test_video_drivers.cpp b/tests/test_video_drivers.cpp
new file mode 100644
index 00000000..1bddc45b
--- /dev/null
+++ b/tests/test_video_drivers.cpp
@@ -0,0 +1,23 @@
+// SculptForge - open source digital sculpting
+// SPDX-License-Identifier: GPL-3.0-or-later
+//
+// The Linux build's SDL must carry both video drivers: native Wayland (preferred) and X11. SDL quietly leaves
+// Wayland out when its headers are missing at build time, and the app would then run under XWayland.
+#include "TestHarness.h"
+
+#if defined(SF_TEST_ACTIONS) && defined(__linux__)
+#include <SDL3/SDL.h>
+
+#include <string>
+
+TEST(linux_sdl_has_wayland_and_x11_drivers) {
+ bool wayland = false, x11 = false;
+ for (int i = 0; i < SDL_GetNumVideoDrivers(); ++i) {
+ const std::string name = SDL_GetVideoDriver(i);
+ wayland |= name == "wayland";
+ x11 |= name == "x11";
+ }
+ CHECK(wayland);
+ CHECK(x11);
+}
+#endif
diff --git a/website/index.html b/website/index.html
index 322ac6a5..ba429954 100644
--- a/website/index.html
+++ b/website/index.html
@@ -443,6 +443,9 @@
<li><h3>No conflicts with your stack</h3>
<p>No Qt, Boost, TBB or OpenEXR to clash with the versions your other tools load. The few dependencies
are linked statically.</p></li>
+ <li><h3>Native Wayland on Linux</h3>
+ <p>No XWayland: a native Wayland window, sharp at any scale (fractional too), with pen pressure through the
+ Wayland tablet protocol. X11 works just as well.</p></li>
<li><h3>Nothing phones home</h3>
<p>No licence server, telemetry or account. It runs on air-gapped workstations and farm nodes.</p></li>
<li><h3>Make it yours</h3>
diff --git a/website/studios.html b/website/studios.html
index 7b713c8b..cccdfb86 100644
--- a/website/studios.html
+++ b/website/studios.html
@@ -368,6 +368,11 @@
<p>Native builds for all three, including .rpm for Fedora, RHEL, Rocky and Alma, .deb, AppImage,
ARM64, a Windows installer and a universal macOS app.</p>
</article>
+ <article class="card">
+ <h3>Linux pipelines</h3>
+ <p>Native Wayland and X11 from the same build: no XWayland, sharp on fractional and HiDPI scaling, pen
+ pressure on both. RHEL- and Rocky-friendly packages (.rpm, Flatpak, tar.gz) and no licence server.</p>
+ </article>
<article class="card">
<h3>VFX Reference Platform</h3>
<p>CY2026 and CY2027 builds (Rocky Linux 8 and 9, GCC 14, C++20, Python 3.13), tested in CI, plus a Rez