Reads a new ToggleShutterInputActionLineEdit setting and checks it in _process() with Input.is_action_just_pressed() instead of _input(), since the Shutter is its own native Window: its _input() only fires while it has OS focus, and stops entirely once hidden. Input's action state is global to the process, so this lets the configured key show the Shutter again from the main Play window.
Screenshots
Godot addon that lets you rapidly take screenshots. Supports taking bursts in multiple resolutions, locales, and formats.
Installation
- Download the addon from AssetLib within the Godot Editor
- Enable the addon in the Project Settings
Usage
- Play a scene
- (Optional) Adjust settings in the Debugger panel
- Press the shutter button
- View your screenshots in the Camera Roll or click on the link in the Output panel
Configuration
Configure the addon from its Debugger panel. Settings are stored at settings.cfg.
Shutter
-
Show shutter: Toggle shutter visibility
-
Only run in Editor: If the game is running outside the editor (
OS.has_feature("editor")isfalse), hide the shutter and disable input processing -
Pauses game: Pause execution while taking screenshots. Useful for ensuring consistency across burst captures.
-
Shutter sounds: Whether to play shutter sound effect
-
Input Action: Set an Input Action to trigger a screenshot
Resolution
- Specify one or more target sizes. The addon calls
DisplayServer.window_set_size()for each size before capturing.
Locales
- Select locales to load before taking screenshots.
Save
- Path: Screenshot save location (default:
user://screenshots) - Formats: PNG, JPG, WEBP
- Use subfolders: Organize bursts into folders with this structure
projectname_timestamp/locale/resolution
API
Accessible through the Screenshots singleton.
Methods
take_burst()
Takes one or more screenshots (a burst) using settings specified in the Debugger panel.
Signals
burst_starting
Fires before capture. Use this to hide debug UI elements.
image_captured(image: Image)
Fires after each individual capture.
burst_ended
Fires after the burst is completed. Use it to unhide debug UI elements.
Example
func _ready() -> void:
Screenshots.burst_starting.connect(_hide_debug_ui)
Screenshots.burst_ended.connect(_show_debug_ui)
Version Compatibility
Tested on Godot 4.5 (Linux and macOS)
Support
For bugs and feature requests, please open an issue. Additional questions? Email hello@pumpkintree.games
Credits
- Developed by Davide Di Staso
- Uses Directory Watcher by Tomek
- Screenshots addon icon based on modified Godot Editor icons
- Shutter icon by Bootstrap
- Shutter sound effect by ALEXIS_GAMING_CAM from Pixabay
- Editor Theme Explorer by Yuri Sizov and Godot Plugin Reloader by Iceflower have been used during development
