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>Projects, autosave and snapshots - SculptForge User Guide</title>
<meta name="description" content="A SculptForge project (.sfproj) saves your whole scene in one file, so you can close the app and carry on exactly where you stopped. This chapter covers saving and opening projects, the unsaved-changes prompt, recent files, autosave and crash recovery, snapshots, and the Library tabs that show your ">
<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/projects.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Projects, autosave and snapshots - SculptForge User Guide">
<meta property="og:description" content="A SculptForge project (.sfproj) saves your whole scene in one file, so you can close the app and carry on exactly where you stopped. This chapter covers saving and opening projects, the unsaved-changes prompt, recent files, autosave and crash recovery, snapshots, and the Library tabs that show your ">
<meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
<meta property="og:url" content="https://sculptforge.app/guide/projects.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="maya.html" data-next="scripting.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">Projects, autosave and snapshots</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" class="current" aria-current="page">Projects, autosave and snapshots</a><ul class="toc-sections"><li><a href="#what-a-project-keeps">What a project keeps</a></li><li><a href="#save-a-project">Save a project</a></li><li><a href="#open-a-project-or-model">Open a project or model</a></li><li><a href="#start-from-a-starter-mesh">Start from a starter mesh</a></li><li><a href="#the-unsaved-changes-prompt">The unsaved-changes prompt</a></li><li><a href="#autosave-and-crash-recovery">Autosave and crash recovery</a></li><li><a href="#snapshots">Snapshots</a></li><li><a href="#your-library-folder-and-the-library">Your library folder and the Library</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></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">Troubleshooting: tablets, display, crashes and FAQ</a></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="projects-autosave-and-snapshots">Projects, autosave and snapshots</h1>
<p>A SculptForge project (<code>.sfproj</code>) saves your whole scene in one file, so you can close the app and carry on exactly where you stopped. This chapter covers saving and opening projects, the unsaved-changes prompt, recent files, autosave and crash recovery, snapshots, and the Library tabs that show your work.</p>
<h2 id="what-a-project-keeps">What a project keeps<a class="anchor" href="#what-a-project-keeps" aria-label="Link to this section">#</a></h2>
<p>A <code>.sfproj</code> file holds everything SculptForge knows about the scene:</p>
<ul>
<li>
every <a href="parts.html">Part</a>, with its name, visibility, mesh, mask, vertex paint, face groups, hidden faces and UVs;
</li>
<li>
every <a href="layers.html">sculpt layer</a> with its weight, and the active layer of each Part;
</li>
<li>
each Part's <a href="retopology.html#quad-remesh-guides">Quad Remesh Guides</a>, the curves Quad Remesh's edge loops follow;
</li>
<li>
loaded <a href="splats.html">Gaussian splats</a> and their placement;
</li>
<li>
your custom brushes, so a project opened on another computer still has them;
</li>
<li>
the camera, the material and display settings, the brush, Size, Intensity (and Smooth's), Colour intensity, Falloff, paint colour and symmetry;
</li>
<li>
a thumbnail, shown in the Library.
</li>
</ul>
<p>Undo history isn't saved: an opened project starts with a clean history.</p>
<p>Model formats such as OBJ, GLB or FBX can't hold all of this (masks, hidden faces, splats, brushes), so writing them is an export, not a save. See <a href="exporting.html">Exporting</a>.</p>
<h2 id="save-a-project">Save a project<a class="anchor" href="#save-a-project" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<strong>File > Save</strong> (<kbd>Ctrl</kbd>+<kbd>S</kbd>) saves to the current project. The first time, it asks for a file name.
</li>
<li>
<strong>File > Save As...</strong> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd>) saves under a new name.
</li>
<li>
In the Classic layout, clicking the document name in the title strip also saves.
</li>
</ul>
<p>The bar along the top shows the file name with <code>*</code> after it while there are unsaved changes, and so does the window title, which starts with the file name. Any edit in any Part counts, as do splat edits and layer weight changes. The window title and the top bar also show the SculptForge version, so a screenshot says which one you run.</p>
<p>If you opened a model file (an OBJ, say) rather than a project, <strong>Save</strong> asks where to save a new <code>.sfproj</code>; the original model file is left alone.</p>
<h2 id="open-a-project-or-model">Open a project or model<a class="anchor" href="#open-a-project-or-model" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<strong>File > Open...</strong> (<kbd>Ctrl</kbd>+<kbd>O</kbd>) opens a project, a model or a splat capture. Opening a project or model replaces the scene.
</li>
<li>
<strong>File > Open Recent</strong> lists the last 10 files you opened or saved. Files that no longer exist are dropped from the list. <strong>Clear Recent</strong> empties it.
</li>
<li>
Drop a file onto the window to open it.
</li>
<li>
In the <a href="interface.html">Library</a>, double-click a project or model.
</li>
</ul>
<p><strong>File > New Sphere</strong> (<kbd>Ctrl</kbd>+<kbd>N</kbd>) and <strong>File > New Plane</strong> start a fresh scene.</p>
<p>When you open a project, its saved camera, material and brush settings come back too.</p>
<h2 id="start-from-a-starter-mesh">Start from a starter mesh<a class="anchor" href="#start-from-a-starter-mesh" aria-label="Link to this section">#</a></h2>
<p>Instead of a sphere, start from a base mesh with clean, even quads: <strong>File > New from Starter Mesh</strong> lists them, the Library's <strong>Tool</strong> tab has a <strong>Starter meshes</strong> folder with a thumbnail of each, and the welcome's <strong>Start from a head</strong> opens the human head straight away.</p>
<div class="table-wrap"><table><thead><tr><th>Starter mesh</th><th>What it is</th></tr></thead><tbody><tr><td>Human Head</td><td>A neutral head and neck with loops round the eyes and mouth, for portraits</td></tr><tr><td>Bust</td><td>Head, neck, shoulders and upper chest</td></tr><tr><td>Full Body</td><td>A human figure in A-pose, 167 cm tall</td></tr><tr><td>Hand, Foot, Ear</td><td>A left hand (raised, palm to the front), a left foot and ankle, a left ear</td></tr><tr><td>Eye</td><td>An eyeball 24 mm across, with the cornea and rings of quads round the pupil</td></tr><tr><td>Stylised Head</td><td>A cartoon head: big cranium and eyes, small nose and jaw</td></tr><tr><td>Creature Head</td><td>A dragon or creature blockout: skull, jaw and two horns, each its own <a href="parts.html">Part</a></td></tr><tr><td>Torso</td><td>A human torso from the neck to the upper thighs</td></tr><tr><td>Rounded Box, Cylinder, Capsule, Ring</td><td>Hard-surface primitives with bevelled edges and quad caps</td></tr></tbody></table></div>
<p>Every starter mesh is life size in centimetres, centred, standing on the ground and looking down +Z, and the symmetric ones are exactly symmetric, so <a href="sculpting.html">X symmetry</a> works from the first stroke. The Hand, Foot, Ear, Head, Bust and Torso are cut from a body, so they have open edges where they were cut.</p>
<p>A starter mesh opens with subdivision levels (two, or one for the Full Body): block out the big forms at <strong>Level 1</strong>, the base cage, and step up for the detail (see <a href="geometry.html">Geometry</a>). It opens as a new, unsaved scene: <strong>Save</strong> asks for a name. Double-click a tile to open it; <kbd>Shift</kbd>+double-click appends its base cage as a Part, for example an Eye next to a head.</p>
<p>The human meshes come from the MakeHuman base mesh, which MakeHuman released into the public domain (CC0); the others are made by SculptForge's own build script. You may use them for anything, including commercial work.</p>
<h2 id="the-unsaved-changes-prompt">The unsaved-changes prompt<a class="anchor" href="#the-unsaved-changes-prompt" aria-label="Link to this section">#</a></h2>
<p>When the scene has unsaved changes, <strong>New Sphere</strong>, <strong>New Plane</strong>, <strong>Open...</strong>, <strong>Open Recent</strong>, dropping a model or project, <strong>Quit</strong> (<kbd>Ctrl</kbd>+<kbd>Q</kbd>) and closing the window first ask:</p>
<ul>
<li>
<strong>Save</strong> saves the project (asking for a name if it has none), then carries on;
</li>
<li>
<strong>Don't Save</strong> discards the changes and carries on;
</li>
<li>
<strong>Cancel</strong> goes back to your work.
</li>
</ul>
<p>Dropping an image or a <code>.sfbrush</code> file never asks, because it doesn't replace the scene.</p>
<h2 id="autosave-and-crash-recovery">Autosave and crash recovery<a class="anchor" href="#autosave-and-crash-recovery" aria-label="Link to this section">#</a></h2>
<p>While the scene has unsaved changes, SculptForge writes a recovery copy every few minutes (every 5 minutes by default; it waits until you finish a stroke). Change the interval, or turn it off with 0, in <strong>Edit > Preferences > Autosave</strong> or with the <strong>Autosave (min)</strong> slider in the File palette (0 to 60 minutes).</p>
<p>The recovery copy is <code>autosave.sfproj</code> in the SculptForge settings folder (see <a href="troubleshooting.html">Troubleshooting</a> for where that is on your system). It is deleted once your work is saved or you discard the changes.</p>
<p>If SculptForge didn't close normally (a crash or power cut), the next start asks <strong>Restore Autosave?</strong>:</p>
<ul>
<li>
<strong>Restore</strong> opens the autosaved scene as an untitled, unsaved document. Save it to keep it.
</li>
<li>
<strong>Discard</strong> deletes the recovery copy.
</li>
</ul>
<p>The autosave also appears first in the Library <strong>Snapshots</strong> tab while it exists.</p>
<aside class="callout callout-note"><p><strong>Note:</strong> Autosave is a safety net, not a substitute for saving. It keeps only the latest copy and is removed as soon as you save.</p></aside>
<h2 id="snapshots">Snapshots<a class="anchor" href="#snapshots" aria-label="Link to this section">#</a></h2>
<p><strong>File > Save Snapshot</strong> (also the <strong>Snapshot</strong> button in the Classic layout's title strip) saves a timestamped copy of the whole scene (experienced sculptors: QuickSave). Your project file, its name and its unsaved state are not changed, so a snapshot is safe to take before any risky step.</p>
<ul>
<li>
Copies go to the <code>QuickSave</code> folder of your library (by default <code>Documents/SculptForge/QuickSave</code>), named like <code>Snapshot 2026-10-21 23-15-04.sfproj</code> (older <code>QuickSave ...</code> files are listed too).
</li>
<li>
The last 10 snapshots are kept; older ones are deleted.
</li>
<li>
They appear in the Library <strong>Snapshots</strong> tab, newest first, labelled with their date and time. Double-click one to open it. The tab also has a <strong>Save now</strong> button.
</li>
</ul>
<p>With the Classic sculpting keys (<strong>Edit > Preferences > Input</strong>) <kbd>9</kbd> takes a snapshot; otherwise it has no default shortcut. To give it one, hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd>, click the <strong>Snapshot</strong> button and press a key (see <a href="interface.html">The interface</a>).</p>
<h2 id="your-library-folder-and-the-library">Your library folder and the Library<a class="anchor" href="#your-library-folder-and-the-library" aria-label="Link to this section">#</a></h2>
<p>SculptForge keeps a library folder for your work, by default <code>SculptForge</code> in your Documents folder. It is created on first use with these sub-folders:</p>
<div class="table-wrap"><table><thead><tr><th>Folder</th><th>Library tab</th><th>What goes there</th></tr></thead><tbody><tr><td><code>Projects</code></td><td>Project</td><td>Your <code>.sfproj</code> files</td></tr><tr><td><code>Tools</code></td><td>Tool</td><td>Models to open or append as Parts</td></tr><tr><td><code>Brushes</code></td><td>Brush</td><td><code>.sfbrush</code> files</td></tr><tr><td><code>Alphas</code></td><td>Alpha</td><td>Grayscale images for brush alphas</td></tr><tr><td><code>LitSpheres</code></td><td>Material</td><td>Lit Sphere images, loaded as materials at start-up</td></tr><tr><td><code>Images</code></td><td>Image</td><td>Sketches and concept art for Generate 3D</td></tr><tr><td><code>Splats</code></td><td>Splats</td><td>Gaussian splat captures</td></tr><tr><td><code>QuickSave</code></td><td>Snapshots</td><td>Snapshots</td></tr></tbody></table></div>
<p>Change it in <strong>Edit > Preferences > Library > Library folder</strong>; the setting saves itself.</p>
<p>Press <kbd>,</kbd> (comma) to show the Library. The tabs that matter for projects:</p>
<ul>
<li>
<strong>Project</strong>: the projects in your <code>Projects</code> folder, plus any recent project saved elsewhere. Each shows the thumbnail saved with it.
</li>
<li>
<strong>Snapshots</strong>: the autosave (when there is one) and your snapshots, newest first.
</li>
<li>
<strong>Recent</strong>: everything in <strong>Open Recent</strong>, of every kind.
</li>
</ul>
<p>Double-click a tile to open it (you are asked about unsaved changes first). In the <strong>Tool</strong> tab, <kbd>Shift</kbd>+double-click a model to append it as a Part instead.</p>
<figure class="shot"><a href="images/library.jpg" class="zoom"><img src="images/library.jpg" alt="The Library showing project thumbnails" width="930" height="145" loading="lazy" decoding="async"></a><figcaption>The Library showing project thumbnails</figcaption></figure>
<h2 id="scripting">Scripting<a class="anchor" href="#scripting" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Command</th><th>What it does</th></tr></thead><tbody><tr><td><code>save_project path=work/dragon.sfproj</code></td><td>Save the project (without <code>path</code>, to the current project)</td></tr><tr><td><code>open_project path=work/dragon.sfproj</code></td><td>Open a project (<code>open</code> also recognises <code>.sfproj</code>)</td></tr><tr><td><code>open path=scan.obj</code></td><td>Open a model, splat capture or project</td></tr><tr><td><code>new_sphere subdivisions=6</code> / <code>new_plane resolution=128</code></td><td>Start a new scene</td></tr><tr><td><code>new_starter_mesh name=human-head</code></td><td>Start from a starter mesh (<code>levels=0</code> for the bare base cage)</td></tr></tbody></table></div>
<p>Projects saved by <code>sculptforge-cli</code> or Python open in the app too. For the file layout, see <a href="https://github.com/islandmed/SculptForge/blob/main/docs/project-format.md" rel="noopener">docs/project-format.md</a>.</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="interface.html">The interface</a>: Library, shortcuts and saving the layout
</li>
<li>
<a href="parts.html">Parts</a>
</li>
<li>
<a href="exporting.html">Exporting</a>: formats for other applications
</li>
<li>
<a href="troubleshooting.html">Troubleshooting</a>: where settings and the autosave live
</li>
</ul>
</article>
<nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="maya.html"><span>Previous</span>Working with Maya</a><a class="next" rel="next" href="scripting.html"><span>Next</span>Scripting and automation</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/projects.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="#what-a-project-keeps">What a project keeps</a></li><li><a href="#save-a-project">Save a project</a></li><li><a href="#open-a-project-or-model">Open a project or model</a></li><li><a href="#start-from-a-starter-mesh">Start from a starter mesh</a></li><li><a href="#the-unsaved-changes-prompt">The unsaved-changes prompt</a></li><li><a href="#autosave-and-crash-recovery">Autosave and crash recovery</a></li><li><a href="#snapshots">Snapshots</a></li><li><a href="#your-library-folder-and-the-library">Your library folder and the Library</a></li><li><a href="#scripting">Scripting</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>