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.

38.9 KB
Raw Blame
<!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&#x27;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&#x27;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 &gt; Preferences &gt; Tablet &gt; Mouse mode (relative)</strong></td></tr><tr><td>&quot;Windows protected your PC&quot;</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 &gt; Preferences &gt; Interface &gt; 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 &gt; Preferences &gt; Config &gt; 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 &gt; Preferences &gt; Interface &gt; Look &gt; Layout &gt; Classic</strong></td></tr></tbody></table></div>
<h2 id="sculptforge-doesnt-start">SculptForge doesn&#x27;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&#x27;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>&lt;jemalloc&gt;: 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&#x27;t code-signed yet, so the operating system warns the first time.</p>
<ul>
<li>
<strong>macOS (Gatekeeper):</strong> &quot;SculptForge can&#x27;t be opened because it is from an unidentified developer&quot;. 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 &amp; Security &gt; Open Anyway<strong>.</strong></p></aside>
<ul>
<li>
<strong>Windows (SmartScreen):</strong> &quot;Windows protected your PC&quot;. 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 &gt; <strong>Website &amp; 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 &gt; Geometry &gt; 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&#x27;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 &gt; 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&#x27;s control panel or the operating system&#x27;s graphics settings).
</li>
<li>
<strong>Edit &gt; Preferences &gt; 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 &quot;Not enough GPU memory&quot; in the status bar didn&#x27;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&#x27;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 &gt; Draw &amp; Tablet</strong>. Under <strong>Tablet</strong> it shows &quot;Pen pressure: 0.42&quot; once the pen has come near the tablet, or &quot;No pen detected&quot;.
</li>
<li>
<strong>Pressure &gt; strength</strong> (on by default) and <strong>Pressure &gt; 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 &gt; Preferences &gt; Input</strong> and <strong>Edit &gt; Preferences &gt; Tablet</strong> show &quot;Pressure: on&quot; once the pen has pressed, or &quot;Pressure: not detected&quot;. Without pressure the pen still draws, at full strength. A tablet plugged in while SculptForge runs works straight away; the status bar says &quot;Tablet connected&quot; (also through Wacom Bridge).</p>
<p>If no pen is detected or pressure doesn&#x27;t change:</p>
<ul>
<li>
Install or update the tablet maker&#x27;s driver.
</li>
<li>
<strong>Windows:</strong> SculptForge reads pressure through Windows Ink, and through the driver&#x27;s Wintab when Windows Ink is off (Wacom Tablet Properties &gt; Mapping &gt; <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&#x27;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&#x27;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&#x27;s ExpressKey set to Alt counts as the keyboard&#x27;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 &gt; Preferences &gt; Tablet &gt; 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&#x27;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&#x27;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 &gt; 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&#x27;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&#x27;s servers, so SculptForge didn&#x27;t download it. The model isn&#x27;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. &quot;Rate limited by the provider&quot; 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&#x27;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&#x27;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&#x27;s editor format</em></td><td>Export it again in ComfyUI with <strong>Workflow &gt; 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 &gt; <strong>Install Missing Custom Nodes</strong>) and restart ComfyUI</td></tr><tr><td><em>...names a model file this server doesn&#x27;t have</em></td><td>Download the model into the right subfolder of ComfyUI&#x27;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&#x27;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&#x27;t want one, change <strong>Edit &gt; Preferences &gt; Interface &gt; 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 &gt; Preferences &gt; Interface &gt; 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 &gt; Display &gt; 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&#x27;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 &gt; Preferences &gt; Config &gt; 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 &gt; Preferences &gt; Config &gt; 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&#x27;t fire while you type in a text field: click the canvas first. Check the key in <strong>Help &gt; Controls</strong> (<kbd>F1</kbd>), which shows every shortcut as currently assigned; a key you reassigned shows in orange in <strong>Edit &gt; Preferences &gt; 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\&lt;you&gt;\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&#x27;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 &gt; Preferences &gt; Library &gt; 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 &gt; Preferences &gt; Config &gt; 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 &gt; 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&#x27;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 &gt; 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&#x27;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 &gt; Preferences &gt; Autosave</strong>, 0 turns it off). After a crash, the next start asks &quot;SculptForge did not close normally last time. Restore the autosaved work?&quot;. <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&#x27;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&#x27;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 &gt; 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 &gt; 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&#x27;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 &gt; 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&#x27;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 &gt; 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&#x27;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 &amp; 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>