Warn when running low on disk space when performing certain editor operations by Calinou · Pull Request #105755 · godotengine/godot

Calinou · 2025-04-25T15:55:44Z

Follow-up to Warn if available disk space is low when Movie Maker mode is enabled #62418.

The following editor operations will now warn the user if the available space on the target disk is low:

Saving a scene (< 1 GiB).
Importing a set of resources (< 2 GiB).
Downloading an export template (< 1 GiB, checked per-file).
Installing export templates from a TPZ (< 4 GiB).
Exporting a project (< 10 GiB).
Packing a project as a ZIP file (< 10 GiB).

This closes Warn when disk space is low before installing export templates in the editor #95111.
See Godot writes empty files when there is no space left on disk. #45354
and Invalid PCK on export when running out of disk space #105742.

Alex2782 · 2025-04-29T13:15:59Z

I increased it to 100GB everywhere to test the warning.

The warning is not yet displayed in the Advanced Import Settings dialog, so I think it should be included there as well, or is there anything against it? There are also import dialogs for "Font" and "Audio".

screenshot

On MacOS, according to "Finder" I have more free space.

Calinou · 2025-04-29T13:44:08Z

The warning is not yet displayed in the Advanced Import Settings dialog, so I think it should be included there as well, or is there anything against it? There are also import dialogs for "Font" and "Audio".

I've added the warning to all advanced import settings dialogs.

On MacOS, according to "Finder" I have more free space.

This is a GiB (binary prefix) versus GB (decimal prefix) difference. It's why when you buy a 500 GB hard drive, it appears to be 465 GB in the OS 🙂

bruvzg · 2025-04-29T14:04:35Z

On MacOS, according to "Finder" I have more free space.

This is a GiB (binary prefix) versus GB (decimal prefix) difference.

This + Finder also include "purgeable" space (local time machine snapshots and similar stuff).

Alex2782

Looks good, tested on MacOS and Android.

akien-mga · 2025-06-02T09:31:05Z

Exporting a project (< 10 GiB).
Packing a project as a ZIP file (< 10 GiB).

I think this might be too restrictive.

Some people can use Godot on mobile devices (tablets, phones, Steam Deck) where storage is at a premium, and it's totally reasonable to export e.g. a simple 2D game with 200 MB of assets when you're on a 64 GB SD card with only 3-4 GB left.

Ideally we should get a feeling for how heavy the PCK is going to be (e.g. by checking the size of .godot) so that the warning is somewhat more accurate.

I haven't tested the PR to check, but if we can't get a level of accuracy which actually matches the developer's available disk space and project needs, maybe we should just have the possibility to disable these warnings for users who know they're operating within narrow limits.

insomniacUNDERSCORElemon · 2025-06-22T19:27:38Z

Some people can use Godot ... where storage is at a premium, and it's totally reasonable to export e.g. a simple 2D game with 200 MB of assets when you're on a 64 GB SD card with only 3-4 GB left

I would say there should be different types of warnings. In output (warnings/errors depending on severity), and in extreme cases (0-50MiB free) warn the user with a dialog when they open a project. Especially as this will continue being an issue until the user intervenes to free up space.

I'm guessing even a modest .godot cleanup could also be a quiet error prevention done at project open as well (this might also be a less annoying log message that still hints at an issue). At least in my case I'm pretty sure the 1.7GiB was all just no-longer-needed cached data related to shaders/fog.

Either way it would be nice to get something in for 4.4.2 (or 4.5). At least for the worst-case-scenarios, even if it does not touch the export process (although I would hope that actually running out of data here would just fail/cancel the export).

…erations The following editor operations will now warn the user if the available space on the target disk is low: - Saving a scene (< 1 GiB). - Importing a set of resources (< 2 GiB). - Downloading an export template (< 1 GiB, checked per-file). - Installing export templates from a TPZ (< 4 GiB). - Exporting a project (< 10 GiB). - Packing a project as a ZIP file (< 10 GiB).

Calinou · 2026-04-27T18:42:13Z

Rebased and tested again, it works as expected. I've applied the fix from #118924 (thanks @aurpine) 🙂

Ideally we should get a feeling for how heavy the PCK is going to be (e.g. by checking the size of .godot) so that the warning is somewhat more accurate.

This should be possible by looping over all files in .godot/imported (and all files outside of .godot/ for Pack Project as ZIP), but I don't know how fast this will be, particularly on large projects on Windows. This could be slow on network drives in particular.

aurpine · 2026-05-03T20:36:57Z

 	static void add_init_callback(EditorNodeInitCallback p_callback) { _init_callbacks.push_back(p_callback); }
 	static void add_build_callback(EditorBuildCallback p_callback);

+	void check_disk_space(const String &p_target_path, float p_size_gib, const String &p_rationale) const;


This can be static and then you won't need get_singleton at the callsites.

aurpine · 2026-05-03T20:39:19Z

 	if (dir->get_space_left() < 10 * Math::pow(1024.0, 3.0)) {
 		// Less than 10 GiB available.
-		WARN_PRINT(vformat("Current available space on disk is low (%s). MovieWriter will fail during movie recording if the disk runs out of available space.", String::humanize_size(dir->get_space_left())));
+		WARN_PRINT(vformat("%s: Current available space on disk is low (%s). MovieWriter will fail during movie recording if the disk runs out of space.", path, String::humanize_size(dir->get_space_left())));


We can use check_disk_space here too.

Calinou requested review from a team as code owners April 25, 2025 15:55

Calinou added enhancement topic:editor topic:export labels Apr 25, 2025

Calinou added this to the 4.5 milestone Apr 25, 2025

Calinou force-pushed the editor-warn-low-space-on-disk branch from c49f784 to a71811a Compare April 25, 2025 16:13

RedMser reviewed Apr 26, 2025

View reviewed changes

Comment thread editor/editor_node.cpp Outdated

Calinou force-pushed the editor-warn-low-space-on-disk branch from a71811a to 2244457 Compare April 29, 2025 00:34

Calinou force-pushed the editor-warn-low-space-on-disk branch from 2244457 to 7e9eb3d Compare April 29, 2025 14:32

Calinou requested a review from a team as a code owner April 29, 2025 14:32

Alex2782 approved these changes Apr 29, 2025

View reviewed changes

bruvzg mentioned this pull request Jun 2, 2025

Incomplete export template install is not reported #107039

Closed

Repiteo modified the milestones: 4.5, 4.6 Jun 19, 2025

Calinou force-pushed the editor-warn-low-space-on-disk branch from 7e9eb3d to fd96935 Compare December 18, 2025 01:22

Calinou requested a review from a team December 18, 2025 01:22

Calinou force-pushed the editor-warn-low-space-on-disk branch from fd96935 to d095a66 Compare December 18, 2025 15:30

akien-mga modified the milestones: 4.6, 4.x Jan 13, 2026

Repiteo requested a review from a team as a code owner February 17, 2026 20:10

aurpine mentioned this pull request Apr 24, 2026

Improve movie writer low disk space: check is specific to path instead of filesystem #118924

Open

Calinou force-pushed the editor-warn-low-space-on-disk branch from d095a66 to 0a5fe2e Compare April 27, 2026 18:41

Calinou requested a review from a team as a code owner April 27, 2026 18:41

aurpine reviewed May 3, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Warn when running low on disk space when performing certain editor operations#105755

Warn when running low on disk space when performing certain editor operations#105755
Calinou wants to merge 1 commit intogodotengine:masterfrom
Calinou:editor-warn-low-space-on-disk

Calinou commented Apr 25, 2025 •

edited

Loading

Uh oh!

Uh oh!

Alex2782 commented Apr 29, 2025 •

edited

Loading

Uh oh!

Calinou commented Apr 29, 2025 •

edited

Loading

Uh oh!

bruvzg commented Apr 29, 2025

Uh oh!

Alex2782 left a comment

Uh oh!

akien-mga commented Jun 2, 2025

Uh oh!

insomniacUNDERSCORElemon commented Jun 22, 2025 •

edited

Loading

Uh oh!

Calinou commented Apr 27, 2026 •

edited

Loading

Uh oh!

aurpine May 3, 2026

Uh oh!

aurpine May 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

Uh oh!

Conversation

Calinou commented Apr 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Alex2782 commented Apr 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Calinou commented Apr 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

bruvzg commented Apr 29, 2025

Uh oh!

Alex2782 left a comment

Choose a reason for hiding this comment

Uh oh!

akien-mga commented Jun 2, 2025

Uh oh!

insomniacUNDERSCORElemon commented Jun 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Calinou commented Apr 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

aurpine May 3, 2026

Choose a reason for hiding this comment

Uh oh!

aurpine May 3, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

Calinou commented Apr 25, 2025 •

edited

Loading

Alex2782 commented Apr 29, 2025 •

edited

Loading

Calinou commented Apr 29, 2025 •

edited

Loading

insomniacUNDERSCORElemon commented Jun 22, 2025 •

edited

Loading

Calinou commented Apr 27, 2026 •

edited

Loading