Scratch 2.0 File Format - Revision history

Ross-spencer: Add examples for 2.0

2025-04-18T14:22:01Z

Add examples for 2.0

Ross-spencer: Fixup link and provide other versions

2025-04-18T13:57:14Z

Fixup link and provide other versions

Kayvon2008 at 19:30, 12 January 2022

2022-01-12T19:30:33Z

Dan Tobias at 21:33, 18 September 2019

2019-09-18T21:33:51Z

Jsummers: Category:JSON based file formats

2017-04-23T16:21:38Z

Category:JSON based file formats

Dan Tobias: /* Documentation */

2013-07-25T21:48:45Z

‎Documentation

Dan Tobias at 23:53, 23 July 2013

2013-07-23T23:53:25Z

Dan Tobias at 13:27, 12 May 2013

2013-05-12T13:27:08Z

Dan Tobias at 12:45, 10 May 2013

2013-05-10T12:45:42Z

Dan Tobias at 12:45, 10 May 2013

2013-05-10T12:45:04Z

← Older revision		Revision as of 14:22, 18 April 2025
Line 8:		Line 8:

	Detailed documentation can be found in the Scratch wiki.		Detailed documentation can be found in the Scratch wiki.
		+
		+	== Examples ==
		+
		+	Empty project (via the Scratch wiki):
		+
		+	<pre>
		+	{
		+	"objName": "Stage",
		+	"costumes": [{
		+	"costumeName": "backdrop1",
		+	"baseLayerID": 1,
		+	"baseLayerMD5": "739b5e2a2435f6e1ec2993791b423146.png",
		+	"bitmapResolution": 1,
		+	"rotationCenterX": 240,
		+	"rotationCenterY": 180
		+	}],
		+	"currentCostumeIndex": 0,
		+	"penLayerMD5": "5c81a336fab8be57adc039a8a2b33ca9.png",
		+	"penLayerID": 0,
		+	"tempoBPM": 60,
		+	"videoAlpha": 0.5,
		+	"children": [],
		+	"info": {
		+	"userAgent": "Scratch 2.0 Offline Editor",
		+	"videoOn": false,
		+	"scriptCount": 0,
		+	"flashVersion": "WIN 32,0,0,182",
		+	"spriteCount": 0,
		+	"swfVersion": "v461"
		+	}
		+	}
		+	</pre>
		+
		+	Default project (via the Scratch wiki):
		+
		+	<pre>
		+	{
		+	"objName": "Stage",
		+	"sounds": [{
		+	"soundName": "pop",
		+	"soundID": 1,
		+	"md5": "83a9787d4cb6f3b7632b4ddfebf74367.wav",
		+	"sampleCount": 258,
		+	"rate": 11025,
		+	"format": ""
		+	}],
		+	"costumes": [{
		+	"costumeName": "backdrop1",
		+	"baseLayerID": 3,
		+	"baseLayerMD5": "739b5e2a2435f6e1ec2993791b423146.png",
		+	"bitmapResolution": 1,
		+	"rotationCenterX": 240,
		+	"rotationCenterY": 180
		+	}],
		+	"currentCostumeIndex": 0,
		+	"penLayerMD5": "5c81a336fab8be57adc039a8a2b33ca9.png",
		+	"penLayerID": 0,
		+	"tempoBPM": 60,
		+	"videoAlpha": 0.5,
		+	"children": [{
		+	"objName": "Sprite1",
		+	"sounds": [{
		+	"soundName": "meow",
		+	"soundID": 0,
		+	"md5": "83c36d806dc92327b9e7049a565c6bff.wav",
		+	"sampleCount": 18688,
		+	"rate": 22050,
		+	"format": ""
		+	}],
		+	"costumes": [{
		+	"costumeName": "costume1",
		+	"baseLayerID": 1,
		+	"baseLayerMD5": "f9a1c175dbe2e5dee472858dd30d16bb.svg",
		+	"bitmapResolution": 1,
		+	"rotationCenterX": 47,
		+	"rotationCenterY": 55
		+	},
		+	{
		+	"costumeName": "costume2",
		+	"baseLayerID": 2,
		+	"baseLayerMD5": "6e8bd9ae68fdb02b7e1e3df656a75635.svg",
		+	"bitmapResolution": 1,
		+	"rotationCenterX": 47,
		+	"rotationCenterY": 55
		+	}],
		+	"currentCostumeIndex": 0,
		+	"scratchX": 0,
		+	"scratchY": 0,
		+	"scale": 1,
		+	"direction": 90,
		+	"rotationStyle": "normal",
		+	"isDraggable": false,
		+	"indexInLibrary": 1,
		+	"visible": true,
		+	"spriteInfo": {
		+	}
		+	}],
		+	"info": {
		+	"userAgent": "Scratch 2.0 Offline Editor",
		+	"videoOn": false,
		+	"scriptCount": 0,
		+	"flashVersion": "WIN 32,0,0,182",
		+	"spriteCount": 1,
		+	"swfVersion": "v461"
		+	}
		+	}
		+	</pre>

	== Documentation ==		== Documentation ==

@@ Line 10: / Line 10: @@
 == Documentation ==
-* [http://wiki.scratch.mit.edu/wiki/Scratch_File_Format_%282.0%29 Scratch 2.0 File Format]
+* [https://en.scratch-wiki.info/wiki/Scratch_File_Format_(2.0) Scratch 2.0 File Format]
 == Other links ==
 * [http://scratch.mit.edu/ Official Scratch site]
 [[Category:ZIP based file formats]]
 [[Category:JSON based file formats]]
 [[Category:MIT]]

@@ Line 1: / Line 1: @@
 {{FormatInfo
 |subcat=Source code
-|extensions={{ext|sb2}}
+|extensions={{ext|sb2}}, {{ext|sprite2}}
 }}
 The '''Scratch 2.0 File Format''' saves projects in version 2.0 of the [[Scratch]] programming language. Scratch is a language designed to teach programming to young children. Since the program code consists of graphical tiles rather than text-based source code, a binary format was used for the earlier [[Scratch 1.4 File Format]], but the format has changed with 2.0. Scratch 2.0 runs from a web browser, so no installation is needed as with the earlier versions. Registered users can save their programs on the server, but unregistered users can still run Scratch online and upload/download programs saved on their own computer.

← Older revision		Revision as of 21:33, 18 September 2019
Line 17:		Line 17:
	[[Category:ZIP based file formats]]		[[Category:ZIP based file formats]]
	[[Category:JSON based file formats]]		[[Category:JSON based file formats]]
		+	[[Category:MIT]]

@@ Line 3: / Line 3: @@
 |extensions={{ext|sb2}}
 }}
 The '''Scratch 2.0 File Format''' saves projects in version 2.0 of the [[Scratch]] programming language. Scratch is a language designed to teach programming to young children. Since the program code consists of graphical tiles rather than text-based source code, a binary format was used for the earlier [[Scratch 1.4 File Format]], but the format has changed with 2.0. Scratch 2.0 runs from a web browser, so no installation is needed as with the earlier versions. Registered users can save their programs on the server, but unregistered users can still run Scratch online and upload/download programs saved on their own computer.
@@ Line 17: / Line 16: @@
 [[Category:ZIP based file formats]]

← Older revision		Revision as of 23:53, 23 July 2013
Line 15:		Line 15:
	== Other links ==		== Other links ==
	* [http://scratch.mit.edu/ Official Scratch site]		* [http://scratch.mit.edu/ Official Scratch site]
		+
		+	[[Category:ZIP based file formats]]

@@ Line 4: / Line 4: @@
 }}
-The '''Scratch 2.0 File Format''' saves projects in version 2.0 of the [[Scratch]] programming language (a version that is still unreleased as of this writing, so this is based on pre-release documentation which could change). Scratch is a language designed to teach programming to young children. Since the program code consists of graphical tiles rather than text-based source code, a binary format was used for the earlier [[Scratch 1.4 File Format]], but the format has changed with 2.0.
+The '''Scratch 2.0 File Format''' saves projects in version 2.0 of the [[Scratch]] programming language. Scratch is a language designed to teach programming to young children. Since the program code consists of graphical tiles rather than text-based source code, a binary format was used for the earlier [[Scratch 1.4 File Format]], but the format has changed with 2.0.
 Scratch projects are stored in files with a '''.sb2''' extension. The contents are [[ZIP]]-compressed data, including various items which are part of the project (.[[PNG|png]], .[[SVG|svg]], and .[[WAV|wav]] files, named with numbers). The main item is a file called '''project.json''', in [[JSON]] format.