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

Scratch 1.4 Network Installation

Scratch Cat-cropped.png This article has been created and is maintained by the Scratch Team. As such, it should be treated as an official informational page. Please avoid largely modifying this page's content.

You can customize the Scratch 1.4 installation to suit your specific needs. For example, you may be installing Scratch on a school network and need to control where user Scratch projects are stored, or what drives should be visible. You may need to change settings for a proxy server. Or you may want to change the default sprite, default language, or default project notes.

If you are looking to customize your Scratch installation you must edit your Scratch.ini file. On Windows and Mac versions f Scratch, you will find this file in the /Scratch application folder. On Linux versions of Scratch the file is called .scratch.ini, and resides in the user's home folder.

Contents

Where to install Scratch

Scratch looks for various files and folders within the Scratch folder. The Scratch folder is the the folder than contains the Scratch application (Scratch.exe or Scratch.app) and Scratch.image file (even if the folder name is different). Some of the folders Scratch looks for in the Scratch folder are the Help, Media, and Projects folders. Scratch keeps its settings in the file Scratch.ini in the Scratch folder. It's best to keep the Scratch folder structure intact and not rename any of its subfolders.

It's possible to install a single copy of Scratch on a shared network drive if desired.

MSI Installer

The MSI installer package available on the Scratch 1.4 download page may help you automate the installation process on Windows networks. During installation, it copies the Scratch.ini file located in the same folder as the installer to the target machine. So it's possible to customize your Scratch.ini file before installing Scratch on the computers in your network. The installer package can be deployed in silent / quiet mode.

Customizing the default home folder

By default, Scratch assumes that the user folder is on the local C: drive. However, in networked settings, user folders are often kept on a networked drive. Adding this to the Scratch.ini file...

...on Windows computers:

Home=J:\MySchool\Students\Grade5\*

...on Macintosh computers:

Home=/MySchool/Students/Grade5/*

...will tell Scratch that user folders are kept in the folder MySchool\Students\Grade5\. Note that the asterisk is replaced by the name of the logged in user. You may omit the asterisk if you want all users to share the same folder for their Scratch projects. That might be done to facilitate students working together. When specifying a drive by letter only, be sure to omit the " \ " For example: Home=J:

Hiding drives

NOTE: Hiding drives only works on Windows.

In network Windows settings, it is sometimes useful to limit which drives are visible to the user. This can by done by adding a line such as:

VisibleDrives=J:,M:

to the Scratch.ini file. If visible drives are set, users will not be able to see any other drives (including USB drives), and they won't be able to navigate up the file hierarchy to parts of the disk outside of the Scratch folder and their home folder.

Disabling the 'Share' buttons

In some cases, you may not want users to share their Scratch projects online at all. Adding the following line to Scratch.ini will hide the "Share" menu and button:

Share=0

Customizing the default language

Scratch starts using the language specified by the "locale" of the computer, but this can be overridden. In Scratch.ini file add the line:

Language = [ISO-639-2 code]

Note that this setting will be changed whenever the user changes the language setting (if the Scratch.ini file is writeable) so that Scratch will start up in the language that was last in use.

About proxy servers

Proxy server settings can be specified in the Scratch.ini file using the following entries:

ProxyServer=[server name or IP address]
ProxyPort=[port number]

Here's an example of how these settings must be formatted in your Scratch.ini file:

ProxyServer=192.168.120.150
ProxyPort=8080

Customizing the default sprite

You can replace the default cat sprite with a sprite of your own. You default sprite can include multiple costumes, sounds, and even scripts. To set this up, just create your sprite and export it. (To export, right-click on the sprite and choose "export this sprite."). Then rename it "default.sprite" and place it in the Costumes folder.

Customizing the default project notes

Some people have asked for a way to provide some guiding questions or instructions to users when they first edit the notes for a project. Just make a text file with your default notes, save it with UTF8 encoding, name it defaultNotes.txt, and put it into the Scratch folder.

If the user does not edit the default notes text then nothing is saved in the project notes. This is to prevent lots of projects with default notes text from appearing on the Scratch website. The user has to change at least one character for the notes to be saved in the project.

More questions or concerns?

Please email helpatscratch [dot] mit [dot] edu if you have more questions regarding your Scratch installation.

  • This page was last modified on 23 January 2014, at 00:43.