[brand-header]

![Simple Capture](Simple-Capture_man_images/simple-capture-logotype.svg)

# SIMPLE CAPTURE addon

Created by Chipp Walters, 2025

***Currently only tested on Windows***

[https://youtu.be/LAQBPPnbLBM](https://youtu.be/LAQBPPnbLBM)

## Overview

**Simple Capture** is a utility for Blender that allows you to perform screen captures directly from the 3D viewport. It provides tools for taking single snapshots, capturing timed image sequences, and recording video with audio.

You can find it in the N panel named ♥SC. When you are ready to record, one button hides that panel and puts the recording buttons in the 3D Viewport header, so the panel is not in your video.

![How Simple Capture works: install FFmpeg, name it, pick the job, open the folder](Simple-Capture_man_images/how-it-works.webp)

## Quick Start Video

[https://youtu.be/kIkhnfEtuPI](https://youtu.be/kIkhnfEtuPI)

*Every step of using Simple Capture, start to finish, in about three minutes: snapshots, timelapses, video recording and trimming.*

---

## Requirements & Status

This addon relies on one external program, **FFmpeg**. It does all the capturing: snapshots, image sequences, video, compiling and trimming. Pillow is no longer needed (since version 1.2.0).

If FFmpeg is not found, an **FFmpeg Required** box appears at the top of the panel:

![The FFmpeg Required box](Simple-Capture_man_images/setup.svg)

1. **Install FFmpeg**: Downloads FFmpeg (about 115 MB on Windows, 30 MB on macOS) into the addon's own folder and starts using it right away. No PATH setup and no restart. Nothing else on your computer is changed. The panel shows the download progress.

* The download needs Blender's online access: turn on `Edit > Preferences > System > Network > Allow Online Access` first.  
* If FFmpeg is already installed on your computer, the addon finds and uses it, and the box never appears.

The same status and button are in the addon's preferences (`Edit > Preferences > Add-ons > SIMPLE CAPTURE`).

---

## File Management

This section controls where your captures are saved.

![File Management](Simple-Capture_man_images/file-management.svg)

1. **File Name**: The base name used for all saved files (e.g., "capture"). Files will be automatically numbered, like `capture_001.png` or `capture_001.mp4`.
2. **Output Folder**: The folder on your computer where all captures will be saved.
3. **Open Folder**: Opens the selected output folder in your system's default file explorer.
4. **Clear Output Folder**: Deletes this addon's capture files (files matching your File Name, such as capture\_001.png, capture\_000001.png, capture\_001.mp4 or capture\_001\_trim.mp4) from the output folder. Any other files in the folder are left untouched. A confirmation dialog tells you exactly how many capture files will be deleted before anything is removed.

## Note on the Output Folder

You can set a global **Default Output Folder** for the addon in Blender’s preferences (`Edit > Preferences > Add-ons > SIMPLE CAPTURE`). This default path will be automatically used for any new project you create.

![The addon's preferences](Simple-Capture_man_images/preferences.svg)

1. **Default Output Folder**: The folder used by every project that has not set its own.
2. **FFmpeg**: Shows which FFmpeg the addon uses. If none was found, the **Install FFmpeg** button is here too.

However, the **Output...** path in the main panel is saved with your individual `.blend` file. If you set a path here, it will override the global default for that specific project.

---

## Images

This section contains all the tools for capturing still images, either one at a time or in a sequence.

![Images](Simple-Capture_man_images/images.svg)

1. **Image Format**: Sets the file type for all saved images (`BMP`, `PNG`, or `JPG`).
2. **Capture Region**: Defines the output resolution for the capture.
   * **Blender Window**: Captures the entire Blender window as-is.
   * **Specific Resolutions (e.g., 1920x1080)**: Crops or pads the capture from the center to match the target resolution.
   * To capture a specific resolution like 1920x1080, it's best to resize the Blender window to match that size first. While Blender cannot do this automatically, you can use external utilities for precise control. Windows users can look into **Microsoft PowerToys (FancyZones)**, while macOS users might find apps like **Moom** helpful for this purpose.

## Image Snapshots

*The numbers refer to the picture in Images above.*

3. **Snapshot:** Takes a single screenshot of the Blender window and saves it as an image in the output folder. The mouse pointer is not included.
4. **Snapshot & Open**: Takes a snapshot and immediately opens the saved image file with your system's default image viewer.

---

## Image Sequence

This allows you to capture frames automatically at a set framerate.

![Image Sequence and Compile Sequence](Simple-Capture_man_images/sequence.svg)

1. **Sequence FPS**: The number of frames to capture per second. This single setting is also used to set the framerate when compiling the sequence to video. The frames are written by FFmpeg in the background, so Blender stays responsive; high values still use a lot of processor time and disk space.
2. **Hi FPS limits performance**: This warning appears when Sequence FPS is above 2.
3. **Start/Stop Sequence**: Toggles the sequence capture. When active, it will save images at the specified FPS until you press the button again to stop it. A dot flashes in the status bar for each frame saved, and the status bar tells you how many frames were saved when you stop.

*NOTE: When you start and stop a sequence, it will next pick up from the last named file in your output folder. This is an effective way to pause Sequence recording.*

*NOTE: The area that is captured is fixed when the sequence starts. Do not move or resize the Blender window while it runs.*

---

## Compile Sequence

*The number refers to the picture in Image Sequence above.*

4. **Compile Images**: Uses the **current value** of the **Sequence FPS** setting to combine all the numbered sequence images in your output folder into a single MP4 video. Blender stays responsive while it runs; the button shows the progress and the status bar tells you when the video is saved. If the folder holds no sequence images for the current File Name and Image Format, the button tells you so.  
   This means you can capture at a low framerate (e.g., 1 FPS) and then change the **Sequence FPS** to a higher value (e.g., 30 FPS) *before* compiling to create a fast-motion/timelapse video from your captured frames.  
   Only sequence images (six-digit numbers, like `capture_000001.png`) are compiled. Snapshots (`capture_001.png`) are left out.

---

## Video Capture

This section allows you to record the Blender window directly to a video file, bypassing the need for an image sequence.

## Audio Settings

![Audio Settings](Simple-Capture_man_images/audio.svg)

1. **Include Audio:** Check this box to record audio along with the video.
2. **Audio Device Dropdown**: Select the audio input device (like a microphone) you want to record from. The list is filled when Blender starts. If your device doesn't appear, press the **Refresh** button (🔄) next to it to rescan for devices.
3. **Normalize Audio**: When checked, the addon will automatically process the video file after recording stops to adjust the audio volume to a standard, balanced level. This happens in the background.

## Ready to Capture

![The capture buttons in the panel](Simple-Capture_man_images/ready.svg)

1. **Show Keys and Mouse:** Shows the keys you press in the 3D Viewport. See *Show Keys and Mouse* below.
2. **Ready to Capture:** Click this when your settings are done. The sidebar closes, and five buttons appear at the right end of the 3D Viewport header. Nothing is recorded yet.
3. **Start Video Record:** Records without closing the sidebar. See *Recording from the panel* below.

After **Ready to Capture**, these buttons are in the 3D Viewport header:

![Recording buttons in the 3D Viewport header](Simple-Capture_man_images/header-buttons.svg)

1. **Record**: Starts recording the Blender window. The button turns red while recording. When the recording is paused, it continues it.
2. **Pause**: Pauses the recording. The button turns into **Resume**. Whatever happens while paused is cut out of the saved video.
3. **Stop**: Stops recording and saves the MP4 file. Blender stays responsive while the video is finished; the status bar at the bottom of the window says `Recording saved: capture_001.mp4` when it is done.
4. **Delete** (trash can): Stops recording and throws this recording away. It is moved to the Recycle Bin (Trash on macOS), so a wrong click can be undone. **Delete only removes the recording in progress. Recordings you already saved are never touched.**
5. **X**: Removes the buttons and opens the sidebar again. It is disabled while a recording is running.

The buttons change with what is happening. From top to bottom: ready, recording, paused, and a problem with the last recording.

![The header buttons in four states](Simple-Capture_man_images/header-states.png)

When the 3D Viewport is too narrow for the names, the buttons show only their icons. A red warning sign next to the buttons means the last recording had a problem; the message is in the status bar and at the top of the Simple Capture panel.

You can open the sidebar at any time with the `N` key. The buttons stay in the header until you press **X** or **Exit Capture Mode** in the panel.

*NOTE: The area that is recorded is fixed when you press Record. Do not move or resize the Blender window during a recording, also not while it is paused.*

## Show Keys and Mouse

* **Show Keys and Mouse:** When checked, the keys and mouse buttons you press are shown in the bottom left corner of the largest 3D Viewport, for example `Ctrl + Shift + R`, `Shift + MMB` or `Wheel Up`. This is useful for tutorials. The display is only active while you are ready to capture (the header buttons are showing).

![Keys shown in the corner of the 3D Viewport](Simple-Capture_man_images/keys-overlay.png)

* The last combination stays readable for a moment after you let go, then fades.  
* On Windows, keys are only shown while Blender is the active window, and they are also shown while a tool is running (for example `X` or `Y` during a Grab).  
* On macOS, keys pressed while another tool is running are not shown, and Blender's auto-save is paused while the display is on.

## Recording from the panel

* **Start/Stop Video Record:** Starts a recording without closing the sidebar, and stops and saves it. Use this when you do not mind the panel being in the video.

## Trim Last Take

Cuts the unwanted seconds off the beginning and end of your last recording, for example the moment you reach for the Stop button.

![Trim Last Take](Simple-Capture_man_images/trim.svg)

1. **Start** / **End**: How many seconds to cut from the start and from the end.
2. **Trim Last Take**: Saves a trimmed copy next to the recording, named like `capture_001_trim.mp4`. The original recording is kept, so you can try other values; trimming again replaces the copy.

The video is not re-encoded, so trimming is fast and loses no quality. For that reason the cut at the start lands on the whole second at or just before the time you set.

"Last take" is the last recording saved since Blender started. If there is none yet, it is the recording with the highest number in the output folder.

---

## Hotkeys

* **Start/Stop Video Recording**: `Ctrl + Shift + Alt + F12` (`Ctrl + Shift + Option + F12` on macOS)

## Interface

![The Simple Capture panel](Simple-Capture_man_images/interface.svg)

1. Version number and Docs button
2. Use audio for video capture
3. Choose the microphone; the button next to it rescans for devices
4. Normalize audio (recommended)
5. Show the keys and mouse buttons you press in the 3D Viewport while ready to capture
6. Hide this panel and show the Record, Pause, Stop and Delete buttons in the 3D Viewport header
7. Start/Stop video record from the panel (kbd: Ctrl+Shift+Alt+F12)
8. Seconds to cut from the start and the end of the last recording
9. Save a trimmed copy of the last recording
10. Name to use for all images and videos
11. Output folder (set default in prefs)
12. Open output folder, and clear output folder of this addon's capture files (other files are kept)
13. Image save format. Use BMP if you’re doing sequence saves as they compile into a video much faster
14. Capture Region (or padding). Use 1920x1080 to add padding (black) to make compatible with video editors
15. Take a snapshot of the current screen
16. Take a snapshot of the current screen and open it with the default image editor
17. How many images are captured per second when using Sequence capturing. Also used for Compiling
18. Warning if you exceed 2 FPS as it uses a lot of processor time and disk space
19. Start sequence capture. Button turns blue and then says Stop Sequence
20. When finished with sequence, compile all the sequence images in the output folder into one video

## Troubleshooting

Please contact us at [https://cw1.me/discord](https://cw1.me/discord) for any help needed.

### Not capturing correctly with 2 monitors

Fixed in the latest version. Snapshots and video recording now capture correctly on any monitor, including secondary displays. If you still see wrong or black captures, update SIMPLE CAPTURE to the latest version and restart Blender.

### The recording shows the wrong area, or another window

The addon records the part of the screen where the Blender window was when you pressed Record. If you move or resize Blender afterwards, or put another window on top of it, that is what gets recorded. Keep Blender in place and in front while recording.

### "Recording did not start"

The message includes the reason FFmpeg gave. The most common one is an audio device that is no longer connected: press the **Refresh** button next to the audio device list and choose a device, or uncheck **Include Audio**.

### FFmpeg not found

Click **Install FFmpeg** in the panel (see Requirements & Status). If the button reports that Blender is offline, turn on `Edit > Preferences > System > Network > Allow Online Access`.

If you would rather use an FFmpeg you installed yourself and the addon does not find it, this usually happens when:

* Blender was installed from Steam or a portable zip (doesn’t inherit Windows PATH properly)

* Or the user installed FFmpeg only for their user account, not globally (so cmd sees it but Blender doesn’t)

* Or Blender is running as administrator while ffmpeg is in a user PATH

In those cases, set the environment variable `SIMPLE_CAPTURE_FFMPEG` to the full path of `ffmpeg.exe` and restart Blender, or use the **Install FFmpeg** button.
