A fast code formatter for Godot's GDScript programming language built with Tree Sitter GDScript and Topiary.
The goal of this project is to provide a simple GDScript code formatter that runs fast enough and that's both easy to contribute to and to maintain while an official one built into the engine remains unavailable. Making it in user space allowed us to get a production-ready tool quickly and to update it anytime from here on.
This project aims to follow the official GDScript style guide
What's new in 0.27.0
A fast code formatter for GDScript in Godot 4.
Changelog
Added
Add --debug/-d to print the formatter configuration applied to a given file (#362)
Godot addon：Add max line length setting for formatting (merged the old linter max line length setting with this) (#316)
Fixed
Fix @export_category annotations sometimes wrapping with variables on a single line (#358)
Fix export annotations not being indempotent when followed by variable with inline setter or getter (#361)
Godot addon：Fix editor config not getting applied (#315, #316)
Learn more about the formatter in the GDScript Formatter documentation
Added --verbose option to print one line per formatted file (#227)
Changed
Removed space between lambda function name and parameter list
Force @export and @onready annotations to stay on the same line as a variable, but keep other annotations separate, including annotations on local variables (#333)
Stop trying to format any code containing parse errors. Until now we tried to still format definitions around the code with errors, but this can lead to cases where the formatter produces invalid code
Add line wrapping for annotation arguments (#330)
Fixed
Fixed an extra comma being inserted after a trailing comment in a lambda function argument (#304)
fixed certain export annotations being moved out of their respective groups (#308)
Preserve up to one blank line used to group elements in "containers" like enums
Fixed losing blank line between statements in a body if the previous statement has an inline comment (#320, thanks @Buitragox for the fix)
Fixed various edge cases with ignored directories：paths are now normalized before comparison
Fixed special get syntax with parentheses having an extra space (#314)
Output warnings to stderr when using reorder and safe mode together (#332)
Removed the space between ... and variadic parameter names (#331)
Fixed incorrect indentation for match patterns using and or or (#328)
…
0.20.1May 26, 2026
A fast code formatter for GDScript in Godot 4. You can learn how to install, use, configure, and integrate the formatter into your workflow on this page: https://www.gdquest.com/library/gdscript_formatter/
Frequently asked questions
Is GDScript Formatter free?
Yes. GDScript Formatter is free and open-source software released under the MIT license.
What is the latest version of GDScript Formatter?
The latest version is 0.27.0, released on Sep 25, 2026.
Is it safe to download GDScript Formatter?
The download button links to the official installer published on github.com, the same file Windows Package Manager installs. You can verify the downloaded file by comparing its SHA-256 checksum with 5da94d9ae2d000b81ee8de23f8e693eb15c0718fe72d4984174c7f153b5b4289.
Which Windows versions does GDScript Formatter support?
GDScript Formatter runs on Windows and is available for 64-bit (x64), ARM64 systems.
How do I uninstall GDScript Formatter?
Open Settings › Apps › Installed apps, find GDScript Formatter and select Uninstall. From the command line, run winget uninstall --id=GDQuest.GDScript.Formatter -e.
Is there a portable version of GDScript Formatter?
Yes. GDScript Formatter is available as a portable ZIP archive (gdscript-formatter-0.27.0-windows-x86_64.exe.zip, 64-bit (x64)) that runs without installation. Copy it to any folder or USB drive and run it from there.
Alternatives to GDScript Formatter
Other Programming Languages programs for Windows from different developers.
