In other languages

Help the wiki!

The Scratch Wiki is made by and for Scratchers. Do you want to contribute?

Learn more about joining as an editor!

See discussions in the Community Portal

Porting Scratch Projects

SandCastleIcon.png This page has links to outside of the Scratch website or to Wikipedia. Always remember to be safe when using the internet since we can't guarantee the safety of other sites.
Document stub.png This article or section may not have content matching Scratch Wiki editing standards. Please improve it according to Scratch Wiki:Guidelines.
Reason: A lot of these are written like forum posts and not proper Wiki how-to guides

The Scratch project format (.sb or .sb2) can only be read by the Scratch editor. Compiling a scratch project can convert it to another format that can be opened without scratch. Compiling was a popular suggestion for Scratch 2.0,[1] However, it wasn't added in the normal online or offline editors. To get around this, several Scratchers have made ways to turn them into more widely known formats such as exe and app.

This tutorial will cover how to turn a Scratch project into various executable file formats for Windows, Macintosh and Linux.

Scratch online to EXE

Warning Note: This only works on Windows Vista or higher.

This is probably the easiest method if your project is on the Scratch website.

A help video is available.

1. Download the Scratch to EXE converter from here After you download the installer, you must disable your antivirus to allow the converter to work correctly. Then open the installer and click install, then wait until a message appears telling you your install is finished.

2. Open Scratch to EXE, which should be on your desktop, then read the help tab if it's useful.

3. On the second tab enter your project I.D in the box. This is the long number in all scratch project URL's. For example, if your project URL is, then the project I.D would be 117154285.

4. On the third tab fill in the details as described in the help tab. It is also required that you have a .ico file to use as the icon.

5. Finally, on the fourth tab, find a folder to save your EXE and click build.

SB2 (Scratch 2.0) to SB (Scratch 1.4)

It is possible for one to convert an SB2 file from Scratch 2 to a Scratch 1.4 SB file using blob8108's Retro Converter. Then, if desired, other tools can be used to port it to various formats.

Warning Note: The converter can only convert 1.4 blocks. It cannot convert 2.0 This means you cannot use clones, cloud, custom blocks, or other new Scratch 2.0 features.

SB2 to SB

  1. Download your 2.0 project from the Scratch Website or the 2.0 Offline Editor.
  2. Go to the Retro Converter and follow the instructions there to convert to SB.
  3. Once converted, a pop-up should appear and you will be able to download a 1.4 version (SB) of your 2.0 (SB2) Scratch project.

SB to Other Formats

  1. Now, follow the other Scratch 1.4 tutorials on this page to convert to various other formats.


Warning Note: This converts to an EXE on Windows, and an APP on Mac OS X.
  1. Install BYOB (see resources and links for a link to the website).
  2. Open your SB file.
  3. Click "Compile this project" under the Share menu.


SB to JAR (Java executable)

Works on all operating systems with a Java runtime installed. (Mac, Windows, and Linux)

  1. Download ToJAR (see resources and links)[2]
  2. Unpack/extract the .zip file by right clicking and choosing extract all... on Windows and by double clicking on Mac
  3. In the ToJAR folder, double click on the program folder, then on the dist folder and then double click on the ToJAR.jar file.
  4. This will launch the ToJAR application which looks like this


  1. Click the first select button and choose your input (SB) file.
  2. Choose your output name, and be sure to append the .jar file extension, for example Example.jar
  3. Choose your output location, being sure to put the name of your JAR file at the end. For example, C:/Documents and Settings/Documents/Example.jar
  4. Click compile

SB to APP via Java

Warning Note: This only works on Mac OS X.
  1. Follow the steps above to make a JAR file.
  2. Find the Jarbundler application.
  3. Launch it, it should look something like this


  1. From the tabs at the top, the first tab says build information. You can set a custom icon. The icon must be in .icns format. Use Icon Composer (comes with Mac) to convert a PNG file into .icns format. An icon is optional.
  2. Then choose your JAR file you created as the Main Class.
  3. Click the button at the bottom that says Create Application...
  4. Choose output folder

SB to APP via online player

Using the native Xcode development suite, a Scratch Project can be converted into an application by referencing the online player. To do this, one must open the project and get the Embed URL. Then the embed URL must be used to create an HTML page using the UIWebView Cocoa class.

Creating a project

First, create an Xcode project, and name it iScratchProj. Replace the contents of iScratchProjAppDelegate.h with:

// Import Cocoa framework
#import <Cocoa/Cocoa.h>
// Import WebKit framework
#import <WebKit/WebKit.h>

@interface iBlobAppDelegate : NSObject <NSApplicationDelegate> {
    // Create the window
    NSWindow *window;
    // Get the applet
    IBOutlet id webView;
// Get the window
@property (assign) IBOutlet NSWindow *window;


Next, replace to contents of iScratchProjAppDelegate.m with:

#import "iBlobAppDelegate.h"

@implementation iBlobAppDelegate

@synthesize window;

// When the application loaded...
- (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
    // Add the applet to the screen
    [webView stringByEvaluatingJavaScriptFromString:@"document.write(\"<applet id='ProjectApplet' style='style='position:absolute;left:0;top:-25;' code='ScratchApplet' codebase='' archive='ScratchApplet.jar' height='387' width='482'><param name='project' value='../../static/projects/<#Username#>/<#id#>.sb'></applet>\")"];


Click on the yellow bubbles, and fill in your username and the ID of your project (the number at the end of its URL, e.g.

SB2 to SWF

You can download a SB2 to SWF converter or use an online converter on this site. This is very easy to use and you can change the following settings:

  • Does the bar with the green flag show?
  • Does the project automatically run when it loads?
  • Is turbo mode enabled by default?
  • Will the SWF go fullscreen if you open it with the standalone player?
  • Default width and height of the SWF


This is what a chatbot looks like, running as a bundled JAR. Juliajar.png

An application icon can be added as well. Dockicon.png

Resources and Links


  2. Forum topic
  • This page was last modified on 4 September 2016, at 14:43.