Assuming files are in folder scratch_project/ with project.json and assets/:
cd scratch_project
zip -r ../project.sb3 .
Then open or rename as needed (the .zip produced is already correct; give it .sb3 extension if desired).
| Current Format | Action |
|----------------|--------|
| Valid SB3 renamed to .ZIP | Rename back to .sb3 |
| Folder with project.json | ZIP contents → rename to .sb3 |
| SB2 or older ZIP | Use Scratch’s Load menu |
Final tip: Always keep a backup of your original ZIP file before renaming or modifying it. One wrong compression method can break the project structure, but fixing it is usually as simple as re-zipping the contents correctly.
Yes. Use a file manager app that allows renaming extensions. On iPhone, use the “Files” app or a shortcut that changes file extensions.
Converting a file to an (Scratch 3.0 project) file is a simple process because an file is essentially a renamed Direct Conversion Method
If you have a ZIP file containing the necessary Scratch assets (like project.json
, costumes, and sounds), you can convert it by manually changing the file extension: Locate your ZIP file in your computer's file explorer. Right-click the file and select Change the extension project.zip project.sb3 Confirm the change
if your operating system warns you that changing the extension might make the file unusable. Open the file Scratch Editor by going to File > Load from your computer What’s Inside an SB3 File?
For a ZIP-to-SB3 conversion to work, the ZIP must contain specific components in its root directory: project.json
: The core file containing all the blocks, variables, and project logic. Asset Files files named with hexadecimal strings (e.g., cd21...svg ) that represent the costumes and sounds. Troubleshooting & Tools File Extensions Not Visible : If you don't see the
suffix, you may need to enable "File name extensions" in your folder view settings (View > Show > File name extensions on Windows). Direct Modification : If you only need to change the code, you can upload a project.json file directly to the Scratch website Automated Extracts
: If you are trying to extract or rebuild projects for version control, tools like sb3-commit on GitHub
can automate the process of turning ZIP structures back into SB3 files. for sharing? How can I directly modify a .sb3 file? - Discuss Scratch
To convert a ZIP file to an SB3 (Scratch 3.0 project) file, you typically only need to change the file extension, as an SB3 is essentially a ZIP archive containing specific project data. Conversion Methods Manual Extension Change (Recommended):
Ensure your ZIP file contains the necessary Scratch assets at the root level (e.g., project.json and asset files like .svg or .wav) rather than being inside a subfolder. Right-click the file and select Rename. Change the extension from .zip to .sb3.
A warning may appear about changing extensions; select Yes to confirm.
Online Conversion Tools:If you prefer an automated web interface, you can use specialized tools like ezyZip which specifically offers a "ZIP to SB3" conversion process.
TurboWarp Packager:For more advanced projects or if you are trying to "unpackage" a previously bundled project, the TurboWarp Unpackager can help extract or re-bundle files into a compatible format. File Structure Requirements
For the renamed .sb3 file to work in the Scratch Editor, the internal ZIP structure must include:
project.json: The core file containing all scripts and metadata.
Assets: All costumes and sounds, usually named with their MD5 checksums.
Flat Structure: All files must be at the "top level" of the ZIP archive. If they are inside a folder inside the ZIP, Scratch will fail to load the project. Troubleshooting
"Failed to Upload": If Scratch rejects the file, check that the project.json is at the very top level of the archive and not inside a subfolder.
Hidden Extensions: If you don't see the .zip suffix, you may need to enable "File name extensions" in your computer's folder options. json file inside the ZIP before converting it back to SB3? Convert .zip to .sb3? - Discuss Scratch convert zip to sb3
The Ultimate Guide to Converting ZIP to SB3: Unlock Your Scratch Projects
If you’ve ever tried to open a Scratch project only to find a folder full of JSON files and random assets instead of a playable game, you aren’t alone. Many users accidentally end up with a ZIP file when they meant to have an .sb3 file.
In this guide, we’ll break down exactly what these files are and the foolproof ways to convert your ZIP archive back into a working Scratch 3.0 project. What is an SB3 File?
An .sb3 file is the native file format for Scratch 3.0. While it looks like a single specialized file, it is actually a "compressed archive." If you were to peak inside an SB3 file, you would find:
project.json: The "brain" of your project containing all the code and logic. SVG/PNG files: Your costumes and backdrops. WAV/MP3 files: Your sound effects and music. Why do I have a ZIP instead of an SB3?
Usually, this happens because a computer or browser "unzipped" the project automatically, or a user manually changed the extension to .zip to look at the code. Because SB3 files use ZIP compression, computers often treat them as interchangeable—but the Scratch editor only recognizes the .sb3 extension. Method 1: The Quick Rename (Easiest)
In 90% of cases, you don’t need a converter tool. You simply need to tell your computer to treat the ZIP as an SB3. Locate your ZIP file on your computer. Right-click the file and select Rename.
Delete the .zip at the end of the filename and type .sb3 instead.
A warning will pop up saying, "If you change a file name extension, the file might become unusable." Click Yes or Use .sb3.
Open the Scratch Online Editor, go to File > Load from your computer, and select your new file. Method 2: Re-Zipping Extracted Files
If your project is currently a folder full of files (like project.json and various images), you need to package them back up correctly. Open the folder containing the project files.
Highlight all the items inside the folder (Ctrl+A or Cmd+A).
Note: Do not zip the folder itself; zip the files inside the folder.
Right-click and choose Compress or Send to > Compressed (zipped) folder.
Once the new .zip is created, follow the renaming steps in Method 1 to change the extension to .sb3. Method 3: Using Online Conversion Tools
If you are on a mobile device (like an iPad or Chromebook) where renaming file extensions is difficult, online tools can help.
File Converters: Sites like CloudConvert or Zamzar can sometimes handle extension swaps, though they are often overkill for this specific task.
Scratch Tools: Some community-made "Scratch Tools" or "Project Downloaders" allow you to upload assets and export them directly as a finished SB3. Troubleshooting Common Issues
"Project could not load" Error:This usually happens if the internal structure is wrong. Ensure that the project.json file is in the root of the ZIP archive, not tucked away inside a sub-folder.
Missing Assets:If your sprites or sounds are missing after conversion, check the original ZIP. If the files were renamed (e.g., from a1b2...png to costume1.png), Scratch won't be able to find them. The filenames inside the ZIP must match the references inside the project.json file.
Converting ZIP to SB3 is less about "converting" and more about "relabeling." Because an SB3 file is a ZIP file, a simple name change is usually all it takes to get back to coding your masterpiece.
Title: The Complete Guide to Converting ZIP to SB3: Unpacking Scratch Projects
Introduction
If you have ever downloaded a project from the Scratch website (scratch.mit.edu) or received a game file from a friend, you might have noticed two distinct file types: .sb3 and .zip. At first glance, these seem completely different. One is a playable project file; the other is a compressed archive. Assuming files are in folder scratch_project/ with project
However, in the world of Scratch programming, these two formats are much more closely related than most people think. In fact, with a simple tweak of your computer’s settings, you can convert a ZIP file into an SB3 file—and vice versa—in seconds.
This post will explain exactly what the SB3 format is, why it acts like a ZIP file, how to convert between them safely, and when you should (and shouldn’t) use this trick.
Part 1: What is an SB3 File?
First, let’s look under the hood. When you save a project in Scratch 3.0, the software creates a file ending in .sb3. But what is inside that file?
Contrary to what many beginners think, an SB3 is not a single image or a block of code. It is a packaged container. Specifically, an SB3 file is a JSON-based archive that holds three things:
The Critical Fact: The .sb3 file is actually a standard ZIP archive internally. Scratch simply changes the file extension from .zip to .sb3 so that the Scratch app (or website) recognizes it as a playable project.
Part 2: Why Would You Want to Convert ZIP to SB3?
You might be wondering, "Why would I ever need to do this conversion?" Here are the three most common scenarios:
Scenario 1: You downloaded a project as a ZIP file.
Some websites (including older GitHub repositories or email attachments) automatically rename .sb3 files to .zip to avoid security filters. Converting it back restores the project.
Scenario 2: You want to manually edit assets.
If you have a corrupted project that won't open in Scratch, or if you want to extract all the images and sounds from a game you like (with permission), converting SB3 to ZIP is the only way. You can unzip it, replace a costume in the assets folder, and then re-zip it back to SB3.
Scenario 3: You need to recover a broken project.
If Scratch crashes while saving, the project file might become unreadable. By renaming the .sb3 to .zip, you can often open the archive, extract the project.json file, and manually repair the JSON syntax to rescue your work.
Part 3: How to Convert ZIP to SB3 (Step-by-Step)
The "conversion" process does not require special software. It is simply a file renaming trick.
Method 1: Windows (File Explorer)
Method 2: macOS (Finder)
Method 3: Using Terminal (Advanced / Batch Conversion)
If you have 100 ZIP files to convert, use this command (Mac/Linux/WSL):
for file in *.zip; do mv "$file" "$file%.zip.sb3"; done
Part 4: The Reverse Process – SB3 to ZIP
This is actually more common. To extract a Scratch project's media:
Note: You cannot simply rename a ZIP to SB3 if you have extracted the folder. The folder must be recompressed into a ZIP file first, then renamed.
Part 5: Common Mistakes & Troubleshooting
Mistake #1: "The converted SB3 file won't load in Scratch."
Mistake #2: "I renamed the file, but it still shows as a ZIP icon."
Mistake #3: "My antivirus deleted the SB3 file." Then open or rename as needed (the
Part 6: Security Warning – A Critical Note
While converting ZIP to SB3 is technically safe, you must be cautious about where you get your ZIP files.
Why? Because an SB3 file can contain JavaScript inside project.json (via "extension" blocks). A malicious actor could theoretically embed harmful code that exploits an old version of the Scratch app. Always scan ZIP files with an antivirus before renaming them to SB3.
Part 7: When NOT to Convert
Do not convert a ZIP to SB3 if:
Conclusion
Converting a ZIP file to an SB3 file is one of the simplest yet most powerful tricks in a Scratch power user's toolkit. It takes five seconds to rename a file, but it gives you the ability to rescue corrupted projects, extract assets, and understand how the Scratch file format really works.
Remember: SB3 = ZIP. The only difference is the name on the tin.
So the next time someone sends you a "Scratch project" that ends in .zip, don't panic. Just rename it, and you'll be coding again in no time.
Call to Action: Have you ever used this trick to fix a broken project? Share your story in the comments below. And if you found this guide helpful, bookmark it for the next time Scratch refuses to open your file.
Happy Coding!
Converting a ZIP file back into an SB3 file is a common task for Scratch developers who want to manually edit project code or assets. Since an .sb3 file is essentially a renamed ZIP archive containing a project.json file and various media assets, the "conversion" is primarily about proper re-packaging. Method 1: Manual Renaming (Fastest)
If your ZIP file already contains the correct Scratch file structure (a project.json file and asset files like .svg or .wav at the root), you can simply rename the extension. Locate your .zip file in your computer's file explorer. Right-click the file and select Rename. Change the extension from .zip to .sb3. Confirm the change when the warning dialog appears.
Test: Open the Scratch Online Editor, click File > Load from your computer, and select your new .sb3 file. Method 2: Re-Zipping (If you extracted the files)
If you extracted the contents of an SB3 file to edit them, you must zip them correctly to turn them back into a functional Scratch project.
Crucial Step: Do not zip the folder containing the files. Instead, open the folder, select all the individual files inside (including project.json), and then zip those specific items.
Rename: Once you have the new .zip archive, rename it to .sb3 as described in Method 1. Method 3: Using Online Tools
If you prefer an automated approach or are having trouble with manual renaming:
ezyZip: A free online tool specifically designed to extract or convert archives into .sb3 format.
TurboWarp Unpackager: Useful if the ZIP was originally a "packaged" project (e.g., from an HTML or EXE conversion) and you need to get it back into a standard Scratch format. Why "Convert" ZIP to SB3?
Editing JSON: To change project metadata or complex logic not easily handled in the block editor.
Bulk Asset Swapping: To replace multiple sounds or costumes at once by manipulating the files directly.
Fixing Corrupt Projects: Sometimes manually inspecting the project.json is the only way to find why a project won't load. If you'd like, let me know: Did you manually edit the files inside the ZIP?
Are you getting an error message (like "Project could not load") when trying to open it in Scratch? Are you using Windows, Mac, or a Chromebook? Scratch 3.0 Project - What is .sb3 file and how to open it?
This game may contain content not appropriate for all ages,
or may not be appropriate for viewing at work.
Please enter your birth year.