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>Sculpt Timeline and timelapse - SculptForge User Guide</title>
<meta name="description" content="Every stroke and operation you make is a step on the Sculpt Timeline, the strip along the top of the canvas (or its bottom: Edit > Preferences > Interface > Timeline position). Drag its scrubber to see the model at any point of the session, click a step to go back there, and keep sculpting from it: ">
<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/timeline.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Sculpt Timeline and timelapse - SculptForge User Guide">
<meta property="og:description" content="Every stroke and operation you make is a step on the Sculpt Timeline, the strip along the top of the canvas (or its bottom: Edit > Preferences > Interface > Timeline position). Drag its scrubber to see the model at any point of the session, click a step to go back there, and keep sculpting from it: ">
<meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
<meta property="og:url" content="https://sculptforge.app/guide/timeline.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="dynamic-topology.html" data-next="gizmo.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">Sculpt Timeline and timelapse</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" class="current" aria-current="page">Sculpt Timeline and timelapse</a><ul class="toc-sections"><li><a href="#the-strip">The strip</a></li><li><a href="#branches-undo-without-losing-anything">Branches: undo without losing anything</a></li><li><a href="#re-tuning-a-past-stroke">Re-tuning a past stroke</a></li><li><a href="#big-meshes">Big meshes</a></li><li><a href="#saving-the-history">Saving the history</a></li><li><a href="#timelapse-video">Timelapse video</a></li><li><a href="#scripting">Scripting</a></li></ul></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">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="sculpt-timeline-and-timelapse">Sculpt Timeline and timelapse</h1>
<p>Every stroke and operation you make is a step on the <strong>Sculpt Timeline</strong>, the strip along the top of the canvas (or its bottom: <strong>Edit > Preferences > Interface > Timeline position</strong>). Drag its scrubber to see the model at any point of the session, click a step to go back there, and keep sculpting from it: the steps you had made after it are not thrown away as with a plain undo, they stay as a branch you can switch back to. You can change how strongly a past stroke shows without redoing the strokes after it, and render the whole history as a turntable timelapse video.</p>
<figure class="shot"><a href="images/timeline-strip.jpg" class="zoom"><img src="images/timeline-strip.jpg" alt="The Sculpt Timeline strip (here at the bottom of the canvas): three strokes on the active branch, the scrubber at the last one, and the lane of an earlier continuation above the track" width="960" height="478" loading="lazy" decoding="async"></a><figcaption>The Sculpt Timeline strip (here at the bottom of the canvas): three strokes on the active branch, the scrubber at the last one, and the lane of an earlier continuation above the track</figcaption></figure>
<h2 id="the-strip">The strip<a class="anchor" href="#the-strip" aria-label="Link to this section">#</a></h2>
<p>Each step is a tick on the track: sculpt strokes in light grey, masks in blue, vertex paint in pink, visibility and face groups in green, and topology changes (dynamic topology, remeshing, Add Level, Part changes) as tall teal ticks. The orange scrubber marks the state the canvas shows; the steps after it are dimmed. A dot above a tick marks a re-tuned stroke.</p>
<ul>
<li>
<strong>Drag</strong> along the track to scrub through the history: the model follows as you drag.
</li>
<li>
<strong>Click</strong> a tick to go to the state after that step.
</li>
<li>
<strong>Point</strong> at a tick for what the step was, how many vertices it changed and when.
</li>
<li>
<strong>Right-click</strong> a stroke to re-tune it (see below).
</li>
<li>
The strip is one thin row: the step you are at on the left (point at it for the step's name and the number of branches), the track, then the buttons. The save icon (<strong>Save with project</strong>, lit when on) keeps the history with the project, the film icon exports a timelapse, the unfold icon shows the full strip with a header row (<strong>Edit > Preferences > Interface > Compact timeline</strong> switches it too), and the arrow folds the strip into a small <strong>Timeline</strong> tab (click the tab to open it again; <strong>Sculpt Timeline</strong> in the command palette, F3, does the same).
</li>
</ul>
<p>Undo and Redo (<kbd>Ctrl</kbd>+<kbd>Z</kbd>, <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Z</kbd>) move the scrubber one step, as before. Each Part keeps its own timeline, like its own undo history.</p>
<h2 id="branches-undo-without-losing-anything">Branches: undo without losing anything<a class="anchor" href="#branches-undo-without-losing-anything" aria-label="Link to this section">#</a></h2>
<p>Go back to an earlier step and sculpt: a new branch starts there. The steps you had made after that point stay in the history as a thin lane above the track, starting where the branch splits off. Click the lane to make that branch the active one again; the branch you leave becomes the lane. Nothing is lost by trying an idea and going back.</p>
<h2 id="re-tuning-a-past-stroke">Re-tuning a past stroke<a class="anchor" href="#re-tuning-a-past-stroke" aria-label="Link to this section">#</a></h2>
<p>Right-click a stroke on the track and drag <strong>Strength</strong>: 1 is the stroke as you made it, 0 removes it, 2 makes it twice as strong. The model updates at once and the strokes you made after it are kept.</p>
<p>How it works: the change to that one stroke's displacement is added to the model as it is now. Where later strokes don't touch the area, the result is exactly what you would have had with the new strength. Where later strokes overlap it, they keep the displacement they made at the time, on top of the re-tuned stroke: they are not sculpted again. So a Smooth you did afterwards over the same spot won't smooth the stronger version, and a later Inflate keeps the direction it pushed in then. For most detail passes that is what you want; for a big change under a lot of later work, check the area afterwards.</p>
<p>A stroke can't be re-tuned when a step after it replaced the mesh as a whole (dynamic topology, a remesh, Add Level, a sculpt layer change): the menu says which step is in the way. Strokes made on a sculpt layer can't be re-tuned either.</p>
<h2 id="big-meshes">Big meshes<a class="anchor" href="#big-meshes" aria-label="Link to this section">#</a></h2>
<p>Scrubbing reuses what undo already keeps for each stroke, only the vertices it moved. A run of strokes is swapped in one go, with normals and the view updated once for the whole run, and every few steps the timeline keeps a full copy of the shape (a checkpoint) so a jump across the whole history replays only a few strokes from the nearest one. Measured on an Apple M1 Pro after 220 strokes (a third of them big, up to 4.4 million vertices each), while other heavy programs were running:</p>
<div class="table-wrap"><table><thead><tr><th>Mesh</th><th>One step of the scrubber</th><th>A jump across the history</th></tr></thead><tbody><tr><td>21 million triangles</td><td>5 ms typical, 50 ms for the biggest strokes</td><td>about 0.4 to 0.5 s</td></tr><tr><td>33 million triangles</td><td>5 to 14 ms typical, up to 170 ms for the biggest strokes</td><td>about 0.6 to 1 s</td></tr></tbody></table></div>
<p>See also <a href="performance.html">Performance and big meshes</a>.</p>
<p>The history uses memory: undo keeps up to 1 GB (the oldest steps go first, as before), the timeline up to 1.5 GB more for inactive branches and the extra copy of each stroke that makes fast seeking possible, and up to 1 GB of checkpoints (fewer, further apart, on very big models). With those limits a 21 million triangle model keeps about the last 100 strokes of the size above, a 33 million one about 70; small detail strokes cost far less.</p>
<h2 id="saving-the-history">Saving the history<a class="anchor" href="#saving-the-history" aria-label="Link to this section">#</a></h2>
<p>Turn on <strong>Save with project</strong> (the save icon on the strip) and saving a project also writes its history beside it, as <code>name.sfhist</code> next to <code>name.sfproj</code>. Opening the project brings the timeline back, branches and re-tuned strengths included, as long as the project hasn't been changed elsewhere since. Sculpt strokes, masks, vertex paint, visibility and face groups are saved; a topology change (dynamic topology, remesh, Add Level, sculpt layers) cuts the saved history there, keeping what came after it.</p>
<h2 id="timelapse-video">Timelapse video<a class="anchor" href="#timelapse-video" aria-label="Link to this section">#</a></h2>
<p><strong>Export timelapse</strong> (the film icon in the strip, or <strong>Export timelapse...</strong> in the command palette) renders the history of the active Part, from the start to the step you are at, as a turntable video: the model builds up stroke by stroke while the camera goes once around it, with a short pause at the start and the end. Pick 1080p or 4K, the length, and where to save the MP4. There are no captions or interface in the video. It needs <a href="https://ffmpeg.org/" rel="noopener">ffmpeg</a> installed.</p>
<p>From the command line, for a project saved with its history:</p>
<div class="code-block"><pre class="code"><code>sculptforge creature.sfproj --timelapse creature.mp4 --size 3840x2160 --timelapse-seconds 20</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<h2 id="scripting">Scripting<a class="anchor" href="#scripting" aria-label="Link to this section">#</a></h2>
<p>The timeline is scriptable: <code>timeline_info list=true</code> lists the steps (with their ids), <code>timeline_seek index=N</code> shows step N of the active branch, <code>timeline_select node=ID</code> switches to the branch through a step, <code>timeline_retune node=ID strength=0.5</code> re-tunes a stroke, and <code>timeline_save</code> / <code>timeline_load</code> write and read the <code>.sfhist</code> file.</p>
</article>
<nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="dynamic-topology.html"><span>Previous</span>Dynamic topology</a><a class="next" rel="next" href="gizmo.html"><span>Next</span>Moving, rotating and posing (Gizmo)</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/timeline.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="#the-strip">The strip</a></li><li><a href="#branches-undo-without-losing-anything">Branches: undo without losing anything</a></li><li><a href="#re-tuning-a-past-stroke">Re-tuning a past stroke</a></li><li><a href="#big-meshes">Big meshes</a></li><li><a href="#saving-the-history">Saving the history</a></li><li><a href="#timelapse-video">Timelapse video</a></li><li><a href="#scripting">Scripting</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>