aspizu/goboscript: goboscript is the Scratch compiler

Installation and documentation

goboscript is a text-based programming language which compiles to Scratch. It allows
you to write Scratch projects in text, and compile it into a .sb3 file – which can be
opened in the Scratch editor, TurboWarp or be uploaded to the Scratch website.

goboscript allows you to create advanced Scratch projects with ease, you can use any
text editor, use a version control system such as git. You can refactor your code
using search and replace. Text code can be copy pasted, which allows you to easily reuse
code or share it with others. goboscript syntax is concise and easy to read.

goboscript allows you to integrate external tooling and workflows, such as using a
script to generate costumes for a text rendering engine. Or loading in images into
lists.

goboscript has a powerful macro system – similar to Rust’s macro system. This allows
you to write macros to generate code.

goboscript is more than just an 1:1 mapping of Scratch blocks to text, it also has
additional features like local variables for procedures (custom blocks).

goboscript also performs optimizations, detects problems and unused code.

goboscript welcomes contributions in the form of Pull Requests.

goboscript is written in Rust. You’ll need to install the Rust toolchain
for development.

git clone https://github.com/aspizu/goboscript
cd goboscript

After cloning the repository, run goboscript locally from the repository root with:

cargo run -- build -i your_project/

But, to make development easier, and to validate the generated Scratch project – use
the tools/run script:

This assumes that you have set-up a testing project at playground/.
It will compile the project, validate it using the schemas from scratch-parser.
If the validation fails, Scratch will refuse to load the project. To further debug
the project, the generated project.json file is extracted from the .sb3 file in the
playground/ directory.

Lets say that you modified the generated project in the Scratch editor or Turbowarp,
and you want to look at the project.json. You can extract it with:

Lets say that goboscript produced a broken project, and you are able to fix it by hand –
by modifying the project.json. You can add back the project.json to the .sb3 file
with:

If you want to validate some .sb3 file, use:

tools/run check path/to/project.sb3

goboscript was one of the first-place winners of FOSS HACK 25, and was awarded a 50,000 Rs. prize.
FOSS HACK 25 was a open-source hackathon conducted on 22nd – 23rd February 2025 by the FOSS United
Foundation. During the 48-hour hackathon, I had worked on several goboscript issues and feature
implementation. Thank you FOSS United for the platform and oportunity.

This section will be updated with information about how the funds will be utilized.

Keep your files stored safely and securely with the SanDisk 2TB Extreme Portable SSD. With over 69,505 ratings and an impressive 4.6 out of 5 stars, this product has been purchased over 8K+ times in the past month. At only $129.99, this Amazon’s Choice product is a must-have for secure file storage.

Help keep private content private with the included password protection featuring 256-bit AES hardware encryption. Order now for just $129.99 on Amazon!

Help Power Techcratic’s Future – Scan To Support

If Techcratic’s content and insights have helped you, consider giving back by supporting the platform with crypto. Every contribution makes a difference, whether it’s for high-quality content, server maintenance, or future updates. Techcratic is constantly evolving, and your support helps drive that progress.

As a solo operator who wears all the hats, creating content, managing the tech, and running the site, your support allows me to stay focused on delivering valuable resources. Your support keeps everything running smoothly and enables me to continue creating the content you love. I’m deeply grateful for your support, it truly means the world to me! Thank you!