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
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Troubleshooting: tablets, display, crashes and FAQ - SculptForge User Guide</title>
<meta name="description" content="This chapter collects fixes for common problems: start-up and graphics errors, tablets, AI service messages, ComfyUI errors, the camera notch, first-launch warnings on macOS and Windows, where SculptForge keeps its settings, how to reset the interface, and how to report a bug.">
<meta name="theme-color" content="#111114">
<meta name="color-scheme" content="dark">
<link rel="icon" type="image/png" sizes="32x32" href="../img/favicon-32.png?v=7">
<link rel="icon" type="image/png" sizes="64x64" href="../img/favicon-64.png?v=7">
<link rel="apple-touch-icon" href="../img/apple-touch-icon.png?v=7">
<link rel="canonical" href="https://sculptforge.app/guide/troubleshooting.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Troubleshooting: tablets, display, crashes and FAQ - SculptForge User Guide">
<meta property="og:description" content="This chapter collects fixes for common problems: start-up and graphics errors, tablets, AI service messages, ComfyUI errors, the camera notch, first-launch warnings on macOS and Windows, where SculptForge keeps its settings, how to reset the interface, and how to report a bug.">
<meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
<meta property="og:url" content="https://sculptforge.app/guide/troubleshooting.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=12" defer></script>
<script data-goatcounter="https://sculptforge.goatcounter.com/count" async src="https://gc.zgo.at/count.js"></script>
<script src="search-index.js?v=52" defer></script>
</head>
<body class="guide-page" data-prev="performance.html" data-next="glossary.html">
<div class="scroll-progress" aria-hidden="true"></div>
<header class="nav">
<div class="wrap nav-inner">
<a class="brand" href="../index.html"><img class="brand-mark" src="../img/bust-mark-44.png" srcset="../img/bust-mark-88.png 2x, ../img/bust-mark-132.png 3x" width="44" height="44" alt=""><span>SculptForge</span></a>
<nav aria-label="Main">
<a href="../index.html#features">Features</a>
<a href="../index.html#demos">Demos</a>
<a href="../brushes.html">Brushes</a>
<a href="index.html" aria-current="page">Guide</a>
<a class="nav-dl" href="../index.html#download">Download</a>
<a class="gh" href="https://discord.gg/gWrYkEmQhH">Discord</a>
<a class="gh" href="https://github.com/islandmed/SculptForge">GitHub</a>
</nav>
</div>
</header>
<div class="wrap guide-layout">
<div class="guide-side">
<button class="toc-toggle" type="button" aria-expanded="false" aria-controls="guide-toc">
<span>Contents</span><span class="toc-current">Troubleshooting: tablets, display, crashes and FAQ</span></button>
<div id="guide-toc" class="toc-panel">
<div class="guide-search" role="search">
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
<nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What's new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="brush-packs.html">Brush packs</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="linked-duplicates.html">Linked Duplicates</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="tube.html">Tube: draw in 3D space</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li><li><a href="security.html">Security overview for IT reviews</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html" class="current" aria-current="page">Troubleshooting: tablets, display, crashes and FAQ</a><ul class="toc-sections"><li><a href="#sculptforge-doesnt-start">SculptForge doesn't start</a></li><li><a href="#first-launch-warnings-on-macos-and-windows">First launch warnings on macOS and Windows</a></li><li><a href="#the-viewport-is-slow">The viewport is slow</a></li><li><a href="#pen-tablets">Pen tablets</a></li><li><a href="#ai-services">AI services</a></li><li><a href="#comfyui-errors">ComfyUI errors</a></li><li><a href="#the-interface">The interface</a></li><li><a href="#where-settings-live">Where settings live</a></li><li><a href="#the-log-file">The log file</a></li><li><a href="#recovering-work-after-a-crash">Recovering work after a crash</a></li><li><a href="#frequently-asked-questions">Frequently asked questions</a></li><li><a href="#report-a-problem">Report a problem</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="glossary.html">Glossary</a></li><li><a href="discord.html">Show SculptForge on Discord</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="troubleshooting-tablets-display-crashes-and-faq">Troubleshooting: tablets, display, crashes and FAQ</h1>
<p>This chapter collects fixes for common problems: start-up and graphics errors, tablets, AI service messages, ComfyUI errors, the camera notch, first-launch warnings on macOS and Windows, where SculptForge keeps its settings, how to reset the interface, and how to report a bug.</p>
<p>Quick answers:</p>
<div class="table-wrap"><table><thead><tr><th>Problem</th><th>Fix</th></tr></thead><tbody><tr><td>No pen pressure on Windows</td><td>Switch <strong>Windows Ink</strong> in the tablet driver and bring the pen back (<a href="#pen-tablets">Pen tablets</a>)</td></tr><tr><td>The cursor jumps when the pen touches down</td><td><strong>Edit > Preferences > Tablet > Mouse mode (relative)</strong></td></tr><tr><td>"Windows protected your PC"</td><td><strong>More info</strong>, then <strong>Run anyway</strong> (<a href="#first-launch-warnings-on-macos-and-windows">First launch warnings</a>)</td></tr><tr><td>Text and buttons too small or too large</td><td><strong>Edit > Preferences > Interface > UI scale</strong> (<a href="#text-and-buttons-are-too-small-or-too-large">details</a>)</td></tr><tr><td>Menus or shelves look wrong after an update</td><td><strong>Edit > Preferences > Config > Reset Layout and Shortcuts</strong> (<a href="#reset-the-interface">Reset the interface</a>)</td></tr><tr><td>Sculpting feels slow</td><td><a href="#the-viewport-is-slow">The viewport is slow</a></td></tr><tr><td>Lost work after a crash</td><td><a href="#recovering-work-after-a-crash">Recovering work after a crash</a></td></tr><tr><td>Want the Classic layout back</td><td><strong>Edit > Preferences > Interface > Look > Layout > Classic</strong></td></tr></tbody></table></div>
<h2 id="sculptforge-doesnt-start">SculptForge doesn't start<a class="anchor" href="#sculptforge-doesnt-start" aria-label="Link to this section">#</a></h2>
<p>SculptForge draws with OpenGL 3.3 (core profile). Almost every GPU from the last decade supports it, but an old driver, a remote desktop session or a virtual machine without 3D acceleration may not.</p>
<ol>
<li>
<strong>Update your graphics driver</strong> from the GPU maker (NVIDIA, AMD, Intel) or your Linux distribution.
</li>
<li>
<strong>Virtual machines:</strong> turn on 3D acceleration in the VM settings.
</li>
<li>
<strong>Remote desktop:</strong> some remote sessions only offer an older OpenGL. Run SculptForge locally, or use a remote tool that forwards the GPU.
</li>
<li>
<strong>Linux:</strong> on a machine without a working GPU driver, Mesa's software renderer works (slowly): <code>LIBGL_ALWAYS_SOFTWARE=1 sculptforge</code>.
</li>
<li>
<strong>Linux on Apple Silicon (Asahi) and other ARM machines:</strong> use the ARM64 download. The x86_64 one runs there only through the FEX emulator, which stops at once with <code><jemalloc>: Unsupported system page size</code> on 16 KiB pages; start it in a 4 KiB-page VM with <code>muvm -- ./SculptForge-linux-x86_64.AppImage</code> if you need it.
</li>
</ol>
<p>To see why it stopped, start it from a terminal and read the messages. It prints the OpenGL version and GPU it found at start-up (for example <code>OpenGL 4.6 (Core Profile) Mesa 26.1.8 on ...</code>), or the error, such as <code>OpenGL 3.3 context creation failed</code> or <code>Missing OpenGL function: ...</code>.</p>
<ul>
<li>
Linux: run <code>sculptforge</code> in a terminal.
</li>
<li>
macOS: run <code>/Applications/SculptForge.app/Contents/MacOS/SculptForge</code> in Terminal.
</li>
<li>
Windows: the release build has no console window; if it closes straight away, update the driver first, then read the <a href="#the-log-file">log file</a>, which holds the same messages.
</li>
</ul>
<h2 id="first-launch-warnings-on-macos-and-windows">First launch warnings on macOS and Windows<a class="anchor" href="#first-launch-warnings-on-macos-and-windows" aria-label="Link to this section">#</a></h2>
<p>The release builds aren't code-signed yet, so the operating system warns the first time.</p>
<ul>
<li>
<strong>macOS (Gatekeeper):</strong> "SculptForge can't be opened because it is from an unidentified developer". In Finder, right-click (or <kbd>Ctrl</kbd>+click) <strong>SculptForge</strong> in Applications and choose <strong>Open</strong>, then <strong>Open</strong> again. macOS remembers the choice. On recent macOS versions you may instead need <strong>System Settings</strong>
</li>
</ul>
<aside class="callout callout-note"><p>Privacy & Security > Open Anyway<strong>.</strong></p></aside>
<ul>
<li>
<strong>Windows (SmartScreen):</strong> "Windows protected your PC". Click <strong>More info</strong>, then <strong>Run anyway</strong>.
</li>
</ul>
<p>Download SculptForge only from the official releases page on GitHub (the website that Help > <strong>Website & documentation</strong> opens links to it).</p>
<h2 id="the-viewport-is-slow">The viewport is slow<a class="anchor" href="#the-viewport-is-slow" aria-label="Link to this section">#</a></h2>
<ul>
<li>
Check the triangle count in the bar along the top of the window (<strong>Tris</strong>). Millions of triangles on a laptop GPU are heavy; <strong>Tool > Geometry > Decimate</strong> or a lower <strong>Voxel Remesh</strong> resolution brings it down. See <a href="geometry.html">Subdivide, Remesh, Decimate and LODs</a>.
</li>
<li>
Turn off <strong>Wireframe</strong> (<kbd>Shift</kbd>+<kbd>F</kbd>) on dense meshes.
</li>
<li>
Hide Parts you aren't working on, or <strong>Solo</strong> the active one.
</li>
<li>
A large Gaussian splat capture costs GPU time too: lower the count with <strong>Clean floaters</strong>, or untick <strong>Show</strong> in <strong>Render > Gaussian Splats</strong> while you sculpt.
</li>
<li>
On laptops with two GPUs, make sure SculptForge runs on the dedicated one (in the GPU maker's control panel or the operating system's graphics settings).
</li>
<li>
<strong>Edit > Preferences > Performance</strong>: lower <strong>Antialiasing</strong> (or turn it off), try <strong>View resolution</strong> 75% or 50%, keep <strong>Fast Navigation</strong> on, and look at <strong>Last stroke</strong> to see whether brushes or the graphics card take the time. Step down a <a href="subdivision-levels.html">subdivision level</a> for big changes. See <a href="performance.html">Performance and big meshes</a>.
</li>
<li>
A Part missing from the view with "Not enough GPU memory" in the status bar didn't fit on the graphics card: hide other Parts or step down a level.
</li>
</ul>
<h2 id="pen-tablets">Pen tablets<a class="anchor" href="#pen-tablets" aria-label="Link to this section">#</a></h2>
<p>SculptForge reads pen pressure through the operating system's standard pen input, so most Wacom, XP-Pen, Huion and similar tablets, and pen displays, work without settings.</p>
<ol>
<li>
Open <strong>Sculpt > Draw & Tablet</strong>. Under <strong>Tablet</strong> it shows "Pen pressure: 0.42" once the pen has come near the tablet, or "No pen detected".
</li>
<li>
<strong>Pressure > strength</strong> (on by default) and <strong>Pressure > size</strong> choose what pressure controls. They are also on the top shelf.
</li>
<li>
A custom brush can also set its own pressure response (<strong>pressureCurve</strong> in its recipe, see <a href="brush-lab.html">Brush Lab and sharing brushes</a>).
</li>
</ol>
<p><strong>Edit > Preferences > Input</strong> and <strong>Edit > Preferences > Tablet</strong> show "Pressure: on" once the pen has pressed, or "Pressure: not detected". Without pressure the pen still draws, at full strength. A tablet plugged in while SculptForge runs works straight away; the status bar says "Tablet connected" (also through Wacom Bridge).</p>
<p>If no pen is detected or pressure doesn't change:</p>
<ul>
<li>
Install or update the tablet maker's driver.
</li>
<li>
<strong>Windows:</strong> SculptForge reads pressure through Windows Ink, and through the driver's Wintab when Windows Ink is off (Wacom Tablet Properties > Mapping > <strong>Use Windows Ink</strong>). If pressure is still missing, switch that option and bring the pen back to the tablet. See <a href="installing.html#pen-tablets-windows-ink-and-wintab">Pen tablets on Windows</a>.
</li>
<li>
<strong>Linux:</strong> check that the system sees the pen as a tablet (for example in your desktop's tablet settings).
</li>
<li>
If the cursor moves but strokes have no pressure, test in another application to see whether the driver reports pressure at all.
</li>
<li>
<strong>The active Part changed by itself:</strong> a Part becomes active with <strong>Alt+click</strong> on it (the keyboard's Alt, a quick click), a triple-click with the mouse or a click in the Parts list; the status bar names it and how. A tablet's ExpressKey set to Alt counts as the keyboard's Alt.
</li>
<li>
<strong>The cursor jumps back when you put the pen down elsewhere:</strong> the tablet driver is set to mouse (relative) mode. Turn on <strong>Edit > Preferences > Tablet > Mouse mode (relative)</strong>. It also makes the pen relative with the driver in pen mode; the arrow is drawn at the brush while the pen is in range.
</li>
<li>
<strong>The pen picks a brush, then stops clicking menus or the canvas until you use the mouse</strong> (Huion, display tablets, Wacom; 0.10.8 and earlier): update to 0.10.9 or later. If it still happens, tell us the tablet, its driver version and whether Windows Ink is on.
</li>
<li>
<strong>With two screens, the app slows down when the pointer is on the other screen:</strong> fixed in 0.10.9; SculptForge now rests only when its window loses focus.
</li>
</ul>
<h2 id="ai-services">AI services<a class="anchor" href="#ai-services" aria-label="Link to this section">#</a></h2>
<h3 id="hugging-face-free-image-and-text-to-3d">Hugging Face (free image and text to 3D)<a class="anchor" href="#hugging-face-free-image-and-text-to-3d" aria-label="Link to this section">#</a></h3>
<div class="table-wrap"><table><thead><tr><th>Message</th><th>What to do</th></tr></thead><tbody><tr><td><em>Hugging Face's free GPU time is used up for now</em></td><td>The anonymous daily allowance ran out. Add a free token (huggingface.co/settings/tokens, read access) in <strong>HF token</strong> in the Generate 3D window, or set <code>HF_TOKEN</code>; or wait for it to refill (about a day); or pick another model</td></tr><tr><td><em>The Hugging Face Space is asleep or restarting</em></td><td>The model's demo is starting up. Try again in a minute, or pick another model</td></tr><tr><td>Waiting in the queue for a long time</td><td>The demos are shared. Try a faster model (Hunyuan3D 2 mini Turbo, Stable Fast 3D) or another time of day</td></tr><tr><td>TRELLIS.2 fails without a token</td><td>TRELLIS.2 needs a Hugging Face token</td></tr></tbody></table></div>
<h3 id="falai-and-meshy">fal.ai and Meshy<a class="anchor" href="#falai-and-meshy" aria-label="Link to this section">#</a></h3>
<div class="table-wrap"><table><thead><tr><th>Message</th><th>What to do</th></tr></thead><tbody><tr><td><em>The API key was rejected</em></td><td>Check the key in the Generate 3D window, or the <code>FAL_KEY</code> / <code>MESHY_API_KEY</code> variable</td></tr><tr><td><em>Out of credits on this account</em></td><td>Top up your account with that service</td></tr><tr><td><em>Model or endpoint not found</em></td><td>Check the fal model id</td></tr><tr><td><em>Rate limited</em></td><td>Wait a moment and try again</td></tr></tbody></table></div>
<h3 id="hyper3d-rodin-direct">Hyper3D Rodin (direct)<a class="anchor" href="#hyper3d-rodin-direct" aria-label="Link to this section">#</a></h3>
<div class="table-wrap"><table><thead><tr><th>Message</th><th>What to do</th></tr></thead><tbody><tr><td><em>Add your Hyper3D API key</em></td><td>It stays off until you add your own key (hyper3d.ai > API dashboard) in the Generate 3D window</td></tr><tr><td><em>Hyper3D rejected the API key</em></td><td>Check the key, or create a new one in the API dashboard</td></tr><tr><td><em>Your Hyper3D plan doesn't include this tier</em></td><td>Basic API access covers Extreme Low and Low; choose one of those, or upgrade on hyper3d.ai</td></tr><tr><td><em>Out of credits on your Hyper3D account</em></td><td>Top up on hyper3d.ai</td></tr><tr><td><em>Refused the model file</em></td><td>The result came from somewhere other than Hyper3D's servers, so SculptForge didn't download it. The model isn't lost: it stays in your Hyper3D account (hyper3d.ai dashboard) under the task id in the message. If it keeps happening, <a href="https://github.com/islandmed/SculptForge/issues" rel="noopener">report it</a></td></tr></tbody></table></div>
<h3 id="brush-lab">Brush Lab<a class="anchor" href="#brush-lab" aria-label="Link to this section">#</a></h3>
<p>The default <strong>Free</strong> provider uses a hosted open model with no account. If it is unreachable and Ollama runs on your computer, SculptForge uses your local model instead. "Rate limited by the provider" means too many requests in a short time: wait a few seconds. For setup of local models, see <a href="brush-lab.html">Brush Lab and sharing brushes</a>.</p>
<h3 id="no-connection-at-all">No connection at all<a class="anchor" href="#no-connection-at-all" aria-label="Link to this section">#</a></h3>
<p>AI features need internet access (except a local Ollama, LM Studio or ComfyUI). Behind a company proxy or firewall, ask IT to allow the service you use: huggingface.co (and <code>*.hf.space</code>), fal.ai, meshy.ai, api.hyper3d.com (and Hyper3D's file servers), or the Pollinations.ai text endpoint for the free Brush Lab model.</p>
<h2 id="comfyui-errors">ComfyUI errors<a class="anchor" href="#comfyui-errors" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Message</th><th>What to do</th></tr></thead><tbody><tr><td><em>Nothing is answering at http://...</em></td><td>ComfyUI isn't running at that address, or a firewall blocks it. Check the address and port (8188 by default). For another computer, start ComfyUI with <code>--listen</code></td></tr><tr><td><em>...answered, but not like ComfyUI</em></td><td>Something else uses that port, or a proxy is in the way. Use the address ComfyUI prints when it starts</td></tr><tr><td><em>This workflow was saved in ComfyUI's editor format</em></td><td>Export it again in ComfyUI with <strong>Workflow > Export (API)</strong></td></tr><tr><td><em>This ComfyUI does not have the node ...</em> or <em>...is missing the nodes ...</em></td><td>Install the custom nodes the workflow uses (ComfyUI Manager > <strong>Install Missing Custom Nodes</strong>) and restart ComfyUI</td></tr><tr><td><em>...names a model file this server doesn't have</em></td><td>Download the model into the right subfolder of ComfyUI's <code>models</code> folder, for example <code>models/checkpoints</code></td></tr><tr><td><em>ComfyUI rejected the workflow: node N ...</em></td><td>An input is out of range. Open the workflow in ComfyUI: it shows the same error on that node</td></tr><tr><td><em>The workflow finished but saved no mesh file</em></td><td>End the workflow with Save GLB or another node that saves a mesh</td></tr><tr><td><em>...the GPU ran out of memory</em></td><td>The GPU ran out of memory. Lower the resolution or octree size, or use a smaller model</td></tr><tr><td><em>The job disappeared from ComfyUI's queue</em></td><td>Someone cleared the queue or ComfyUI restarted. Generate again</td></tr><tr><td><em>The workflow has no Load Image node</em></td><td>You chose a text workflow on the <strong>From image</strong> tab. Use it from <strong>From text</strong></td></tr></tbody></table></div>
<p>See <a href="generate-3d.html#comfyui-your-own-server">Image and text to 3D</a> for setup.</p>
<h2 id="the-interface">The interface<a class="anchor" href="#the-interface" aria-label="Link to this section">#</a></h2>
<h3 id="the-top-of-the-window-is-hidden-behind-the-camera-notch">The top of the window is hidden behind the camera notch<a class="anchor" href="#the-top-of-the-window-is-hidden-behind-the-camera-notch" aria-label="Link to this section">#</a></h3>
<p>On MacBooks with a camera notch, SculptForge keeps the interface below the notch when it fills the screen. If the title strip or palette bar is still covered, or a plain band appears where you don't want one, change <strong>Edit > Preferences > Interface > Camera notch</strong>: <strong>Automatic</strong> (asks the system on macOS, recognises notched MacBook displays on Linux), <strong>Always reserve</strong>, or <strong>Off</strong>. <kbd>F11</kbd> switches between fullscreen and a window.</p>
<h3 id="text-and-buttons-are-too-small-or-too-large">Text and buttons are too small or too large<a class="anchor" href="#text-and-buttons-are-too-small-or-too-large" aria-label="Link to this section">#</a></h3>
<p><strong>Edit > Preferences > Interface > UI scale</strong> sets the size (Automatic, 100% to 200%) and applies it at once and keeps it for the next start. <strong>Automatic</strong> uses the scale of the monitor the window is on: on Windows that is <strong>Settings > Display > Scale</strong>, per monitor, and the interface follows when you drag the window to another monitor. On Linux under X11 it comes from the desktop's font DPI (Xft.dpi); if Automatic looks wrong there, pick a size.</p>
<h3 id="my-layout-is-gone-after-a-restart">My layout is gone after a restart<a class="anchor" href="#my-layout-is-gone-after-a-restart" aria-label="Link to this section">#</a></h3>
<p>Shortcuts and preferences save themselves; the layout (shelves, trays, open palettes) waits for <strong>Edit > Preferences > Config > Save Layout</strong>. See <a href="interface.html#saving-preferences-and-layouts">The interface</a>.</p>
<h3 id="reset-the-interface">Reset the interface<a class="anchor" href="#reset-the-interface" aria-label="Link to this section">#</a></h3>
<ul>
<li>
<strong>Edit > Preferences > Config > Reset Layout and Shortcuts</strong> returns to the built-in layout and default shortcuts. The shortcuts save themselves; press <strong>Save Layout</strong> afterwards to keep the layout.
</li>
<li>
<strong>Revert to Saved Layout</strong> goes back to the layout the last Save Layout kept.
</li>
<li>
To start completely fresh, quit SculptForge and delete <code>ui.json</code> (layout, shortcuts, interface preferences) and <code>imgui.ini</code> (positions of floating windows such as Brush Lab) from the settings folder below.
</li>
</ul>
<h3 id="a-key-does-nothing">A key does nothing<a class="anchor" href="#a-key-does-nothing" aria-label="Link to this section">#</a></h3>
<p>Shortcuts don't fire while you type in a text field: click the canvas first. Check the key in <strong>Help > Controls</strong> (<kbd>F1</kbd>), which shows every shortcut as currently assigned; a key you reassigned shows in orange in <strong>Edit > Preferences > Hotkeys</strong>, where <strong>Default shortcuts</strong> undoes every change.</p>
<h2 id="where-settings-live">Where settings live<a class="anchor" href="#where-settings-live" aria-label="Link to this section">#</a></h2>
<p>SculptForge keeps its settings in one folder per user:</p>
<div class="table-wrap"><table><thead><tr><th>System</th><th>Settings folder</th></tr></thead><tbody><tr><td>Linux</td><td><code>~/.local/share/SculptForge/SculptForge/</code> (or <code>$XDG_DATA_HOME/SculptForge/SculptForge/</code>)</td></tr><tr><td>macOS</td><td><code>~/Library/Application Support/SculptForge/SculptForge/</code></td></tr><tr><td>Windows</td><td><code>%APPDATA%\SculptForge\SculptForge\</code> (usually <code>C:\Users\<you>\AppData\Roaming\SculptForge\SculptForge\</code>)</td></tr></tbody></table></div>
<div class="table-wrap"><table><thead><tr><th>File or folder</th><th>What it holds</th></tr></thead><tbody><tr><td><code>ui.json</code></td><td>Shortcut changes and preferences (saved as you change them) and the layout (written by <strong>Save Layout</strong>)</td></tr><tr><td><code>imgui.ini</code></td><td>Positions and sizes of floating windows</td></tr><tr><td><code>ai.json</code></td><td>AI settings: providers, models, keys, ComfyUI address (readable only by your account)</td></tr><tr><td><code>project.json</code></td><td>Recent files and the autosave interval</td></tr><tr><td><code>autosave.sfproj</code></td><td>The autosaved copy of unsaved work (removed once you save)</td></tr><tr><td><code>clean_exit</code></td><td>Marks a normal exit; without it, the autosave is offered for restore</td></tr><tr><td><code>sculptforge.log</code>, <code>sculptforge-previous.log</code></td><td>What this session and the last one did, and what crashed (see <a href="#the-log-file">The log file</a>)</td></tr><tr><td><code>console_history.txt</code></td><td>The console's command history</td></tr><tr><td><code>recent_actions.txt</code></td><td>Recently used entries of the command palette</td></tr><tr><td><code>brushes/</code></td><td>Your brush library, one <code>.sfbrush</code> file per brush</td></tr><tr><td><code>brush-gallery-cache/</code>, <code>brush-gallery.json</code></td><td>Community brush gallery cache and its address</td></tr><tr><td><code>thumbs/</code></td><td>Cached Library and picker thumbnails (safe to delete)</td></tr></tbody></table></div>
<p>Your <strong>library folder</strong> (projects, tools, alphas, images, splats and snapshots shown in the Library) is separate: <code>Documents/SculptForge</code> by default, changeable in <strong>Edit > Preferences > Library > Library folder</strong>.</p>
<aside class="callout callout-tip"><p><strong>Tip:</strong> To move settings to another computer, copy <code>ui.json</code>, <code>ai.json</code> and the <code>brushes</code> folder. For a shared layout, use <strong>Edit > Preferences > Config > Export Interface...</strong> and <strong>Import Interface...</strong> instead.</p></aside>
<h2 id="the-log-file">The log file<a class="anchor" href="#the-log-file" aria-label="Link to this section">#</a></h2>
<p>SculptForge writes what it does to <code>sculptforge.log</code> in its <a href="#where-settings-live">settings folder</a>. Choose <strong>Help > Open log folder</strong> to open it:</p>
<div class="table-wrap"><table><thead><tr><th>System</th><th>Log file</th></tr></thead><tbody><tr><td>Windows</td><td><code>%APPDATA%\SculptForge\SculptForge\sculptforge.log</code></td></tr><tr><td>macOS</td><td><code>~/Library/Application Support/SculptForge/SculptForge/sculptforge.log</code></td></tr><tr><td>Linux</td><td><code>~/.local/share/SculptForge/SculptForge/sculptforge.log</code></td></tr></tbody></table></div>
<p>It holds the version, your system and GPU (the <code>OpenGL ... on ...</code> line), warnings and errors, and each command you ran. If SculptForge crashes, it ends with lines starting <code>CRASH:</code> that say what crashed and what was done last. Every start keeps the previous session's log as <code>sculptforge-previous.log</code> beside it, so after a crash <strong>attach <code>sculptforge-previous.log</code> to your report</strong> (the new <code>sculptforge.log</code> is the session after it). It holds no models and no keys, only command names and messages, which may include file names.</p>
<h3 id="a-performance-trace">A performance trace<a class="anchor" href="#a-performance-trace" aria-label="Link to this section">#</a></h3>
<p>When SculptForge gets slow, <strong>Help > Record a performance trace</strong> shows where the time goes. Turn it on, do what feels slow (the stroke, the orbit, the remesh), then choose it again to stop. <code>sculptforge-trace.log</code> beside the log then lists every frame that took longer than 33 ms with its parts (events, dabs, interface, GPU uploads, drawing, GPU time), each stroke's timings, commands that held up the frames, background jobs starting and ending, the mesh size and levels, and on its first line your GPU, driver and CPU. <strong>Attach it to your report.</strong> It is off by default and costs nothing when off; it stays small (2 MB, then the older lines move to <code>sculptforge-trace-previous.log</code>) and never leaves your computer.</p>
<h2 id="recovering-work-after-a-crash">Recovering work after a crash<a class="anchor" href="#recovering-work-after-a-crash" aria-label="Link to this section">#</a></h2>
<p>SculptForge autosaves unsaved work every 5 minutes by default (<strong>Edit > Preferences > Autosave</strong>, 0 turns it off). After a crash, the next start asks "SculptForge did not close normally last time. Restore the autosaved work?". <strong>Restore</strong> opens it as unsaved work (save it under a name); <strong>Discard</strong> deletes it. See <a href="projects.html">Projects, autosave and snapshots</a>. The dialog also points to the crashed session's <a href="#the-log-file">log file</a>.</p>
<h2 id="frequently-asked-questions">Frequently asked questions<a class="anchor" href="#frequently-asked-questions" aria-label="Link to this section">#</a></h2>
<p><strong>Can SculptForge open another sculpting app's own project files?</strong> Not directly: those formats are proprietary and undocumented. Export OBJ or FBX from that app, or use the <a href="exporting.html#exchange-models-through-the-bridge">Bridge</a>.</p>
<p><strong>Does it have subdivision levels, voxel remesh, quad remesh or UVs?</strong> Yes: <strong>Voxel Remesh</strong>, <strong>Quad Remesh</strong> (with <strong>Project Detail</strong> to bring the detail back; see <a href="retopology.html">Quad retopology</a>), <strong>Auto UV</strong> unwraps any model, and Add Level adds subdivision levels you can step up and down (see <a href="subdivision-levels.html">Subdivision levels</a>). <strong>Dynamic</strong> on the top shelf is dynamic topology, like dynamic topology (see <a href="dynamic-topology.html">Dynamic topology</a>).</p>
<p><strong>Is it really free? Can I sell what I make?</strong> Yes and yes. SculptForge is GPL-3.0-or-later free software; the licence covers the program, not your models. The AI models have their own licences (see <a href="generate-3d.html#privacy-and-model-licences">Image and text to 3D</a>).</p>
<p><strong>Does SculptForge send anything about me anywhere?</strong> No. There is no telemetry and no account. AI features talk only to the service you choose, when you use them.</p>
<p><strong>Does it work offline?</strong> Yes. Everything except the hosted AI services works offline, and Brush Lab and image-to-3D can run on local models (Ollama, LM Studio, your own ComfyUI or generator command).</p>
<p><strong>Where are my brushes?</strong> In the <code>brushes</code> folder in the settings folder above. Brush Lab saves every brush you make or refine there.</p>
<h2 id="report-a-problem">Report a problem<a class="anchor" href="#report-a-problem" aria-label="Link to this section">#</a></h2>
<p>Choose <strong>Help > Report a problem</strong> to open the issue tracker on GitHub (you need a free GitHub account). A good report includes:</p>
<ol>
<li>
<strong>The SculptForge version</strong> (<strong>Help > About SculptForge</strong>) and your operating system.
</li>
<li>
<strong>Your GPU and driver</strong>: the <code>OpenGL ... on ...</code> line SculptForge prints at start-up (see <a href="#sculptforge-doesnt-start">SculptForge doesn't start</a>), or the GPU name from your system settings.
</li>
<li>
<strong>Steps to reproduce</strong>: what you did, what you expected and what happened instead.
</li>
<li>
<strong>The commands you ran</strong>: open the console (the backtick key, left of <kbd>1</kbd>), click <strong>Copy session as script</strong> and paste it into the report. It often reproduces the problem exactly.
</li>
<li>
<strong>After a crash, the log</strong>: <code>sculptforge-previous.log</code> from <strong>Help > Open log folder</strong> (see <a href="#the-log-file">The log file</a>). <strong>When it is slow</strong>, a <a href="#a-performance-trace">performance trace</a> of the slowdown.
</li>
<li>
<strong>A file</strong> if the problem is with a particular model (a small <code>.sfproj</code> or the original file), and a screenshot for display problems.
</li>
</ol>
<p>For a security problem, don't open a public issue; follow <code>SECURITY.md</code> in the repository instead.</p>
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<a href="installing.html">Installing SculptForge</a>
</li>
<li>
<a href="interface.html">The interface</a>
</li>
<li>
<a href="glossary.html">Glossary</a>
</li>
</ul>
</article>
<nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="performance.html"><span>Previous</span>Performance and big meshes</a><a class="next" rel="next" href="glossary.html"><span>Next</span>Glossary</a></nav>
<p class="guide-meta fine">Also in the app: <strong>Help > User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/troubleshooting.md">Edit this page on GitHub</a>.</p>
</main>
<aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#sculptforge-doesnt-start">SculptForge doesn't start</a></li><li><a href="#first-launch-warnings-on-macos-and-windows">First launch warnings on macOS and Windows</a></li><li><a href="#the-viewport-is-slow">The viewport is slow</a></li><li><a href="#pen-tablets">Pen tablets</a></li><li><a href="#ai-services">AI services</a></li><li><a href="#comfyui-errors">ComfyUI errors</a></li><li><a href="#the-interface">The interface</a></li><li><a href="#where-settings-live">Where settings live</a></li><li><a href="#the-log-file">The log file</a></li><li><a href="#recovering-work-after-a-crash">Recovering work after a crash</a></li><li><a href="#frequently-asked-questions">Frequently asked questions</a></li><li><a href="#report-a-problem">Report a problem</a></li><li><a href="#see-also">See also</a></li></ul></aside>
</div>
<footer class="footer">
<div class="wrap footer-grid">
<div>
<a class="brand" href="../index.html"><img class="brand-mark" src="../img/bust-mark-44.png" srcset="../img/bust-mark-88.png 2x, ../img/bust-mark-132.png 3x" width="32" height="32" alt=""><span>SculptForge</span></a>
<p class="fine">Copyright © 2026 The SculptForge contributors.<br>The SculptForge User Guide is part of
SculptForge, licensed under the <a href="https://github.com/islandmed/SculptForge/blob/main/LICENSE">GNU GPL v3.0 or later</a>.</p>
</div>
<div class="links">
<a href="../performance/">Performance</a>
<a href="index.html">User guide</a>
<a href="../supporters.html">Members</a>
<a href="https://github.com/islandmed/SculptForge">Source code</a>
<a href="https://discord.gg/gWrYkEmQhH">Community Discord</a>
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services & privacy</a>
</div>
<p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
</html>