Scratch Desktop (Scratch 3.0 Offline Editor) on GNU/Linux

config-deb-i386.json

{
	"src": "/tmp/scratch-desktop/",
	"dest": "/tmp/",
	"arch": "i386",
	"icon": "/tmp/scratch-desktop/resources/Icon.png",
	"categories": [
		"Education"
	]
}

config-deb.json

{
	"src": "/tmp/scratch-desktop/",
	"dest": "/tmp/",
	"arch": "amd64",
	"icon": "/tmp/scratch-desktop/resources/Icon.png",
	"categories": [
		"Education"
	]
}

config-rpm.json

{
	"src": "/tmp/scratch-desktop/",
	"dest": "/tmp/",
	"arch": "x86_64",
	"icon": "/tmp/scratch-desktop/resources/Icon.png",
	"categories": [
		"Education"
	]
}

create-deb-i386.sh

#!/bin/sh

######## install electron
sudo apt-get install -yq npm gdebi p7zip-full
cd ~
npm install electron --save-dev


######## extract scratch-desktop
rm -rf /tmp/scratch-desktop
mkdir /tmp/scratch-desktop
wget --max-redirect 5 -c -O /tmp/scratch-desktop.exe 'https://downloads.scratch.mit.edu/desktop/Scratch%20Setup.exe'
7za x -aoa -y /tmp/scratch-desktop.exe -o/tmp/scratch-desktop


######## create electron app
cp -rf ~/node_modules/electron/dist/* /tmp/scratch-desktop/
ln -fsr /tmp/scratch-desktop/electron /tmp/scratch-desktop/scratch-desktop


######## fix permissions
chmod 755 /tmp/scratch-desktop/locales
chmod 755 /tmp/scratch-desktop/swiftshader
chmod 755 /tmp/scratch-desktop/resources
chmod 755 /tmp/scratch-desktop/resources/static
chmod 755 /tmp/scratch-desktop/resources/static/assets


######## get application icon
wget -c -O /tmp/scratch-desktop/resources/Icon.png 'https://scratch.mit.edu/images/download/icon.png'


######## create deb package
cd ~
npm install [email protected]
wget -c -O /tmp/config-deb-i386.json 'https://gist.githubusercontent.com/lyshie/0c49393076b8b375ca1bd98c28f95fb0/raw/9c08b1390cef3df4a0c1622b26875450adb108cd/config-deb-i386.json'
~/node_modules/.bin/electron-installer-debian --config /tmp/config-deb-i386.json


######## install deb file
sudo gdebi /tmp/scratch-desktop_3.12.0_i386.deb

create-deb-raspbian.sh

#!/bin/sh

######## install electron
sudo apt-get install -yq npm gdebi p7zip-full
cd ~
## https://github.com/electron/electron/releases/download/v4.2.5/electron-v4.2.5-linux-arm64.zip
## https://github.com/electron/electron/releases/download/v4.2.5/electron-v4.2.5-linux-armv7l.zip
npm install electron --save-dev


######## extract scratch-desktop
rm -rf /tmp/scratch-desktop
mkdir /tmp/scratch-desktop
wget --max-redirect 5 -c -O /tmp/scratch-desktop.exe 'https://downloads.scratch.mit.edu/desktop/Scratch%20Setup.exe'
7za x -aoa -y /tmp/scratch-desktop.exe -o/tmp/scratch-desktop


######## create electron app
cp -rf ~/node_modules/electron/dist/* /tmp/scratch-desktop/
ln -fsr /tmp/scratch-desktop/electron /tmp/scratch-desktop/scratch-desktop


######## fix permissions
chmod 755 /tmp/scratch-desktop/locales
chmod 755 /tmp/scratch-desktop/swiftshader
chmod 755 /tmp/scratch-desktop/resources
chmod 755 /tmp/scratch-desktop/resources/static
chmod 755 /tmp/scratch-desktop/resources/static/assets


######## get application icon
wget -c -O /tmp/scratch-desktop/resources/Icon.png 'https://scratch.mit.edu/images/download/icon.png'


######## create deb package
cd ~
npm install electron-installer-debian
wget -c -O /tmp/config-deb.json 'https://gist.githubusercontent.com/lyshie/0c49393076b8b375ca1bd98c28f95fb0/raw/223cc112d99c3bdc1829fc25b19c260856134a82/config-deb.json'
~/node_modules/.bin/electron-installer-debian --config /tmp/config-deb.json


######## install deb file
sudo gdebi /tmp/scratch-desktop_3.12.0_amd64.deb

create-deb.sh

#!/bin/sh

######## install electron
sudo apt-get install -yq npm gdebi p7zip-full
cd ~
npm install electron --save-dev


######## extract scratch-desktop
rm -rf /tmp/scratch-desktop
mkdir /tmp/scratch-desktop
wget --max-redirect 5 -c -O /tmp/scratch-desktop.exe 'https://downloads.scratch.mit.edu/desktop/Scratch%20Setup.exe'
7za x -aoa -y /tmp/scratch-desktop.exe -o/tmp/scratch-desktop


######## create electron app
cp -rf ~/node_modules/electron/dist/* /tmp/scratch-desktop/
ln -fsr /tmp/scratch-desktop/electron /tmp/scratch-desktop/scratch-desktop


######## fix permissions
chmod 755 /tmp/scratch-desktop/locales
chmod 755 /tmp/scratch-desktop/swiftshader
chmod 755 /tmp/scratch-desktop/resources
chmod 755 /tmp/scratch-desktop/resources/static
chmod 755 /tmp/scratch-desktop/resources/static/assets


######## get application icon
wget -c -O /tmp/scratch-desktop/resources/Icon.png 'https://scratch.mit.edu/images/download/icon.png'


######## create deb package
cd ~
npm install electron-installer-debian
wget -c -O /tmp/config-deb.json 'https://gist.githubusercontent.com/lyshie/0c49393076b8b375ca1bd98c28f95fb0/raw/223cc112d99c3bdc1829fc25b19c260856134a82/config-deb.json'
~/node_modules/.bin/electron-installer-debian --config /tmp/config-deb.json


######## install deb file
sudo gdebi /tmp/scratch-desktop_3.12.0_amd64.deb

create-rpm.sh

#!/bin/sh

######## install electron
cd ~
#npm install [email protected] --save-dev
npm install electron --save-dev


######## extract scratch-desktop
rm -rf /tmp/scratch-desktop
mkdir /tmp/scratch-desktop
wget --max-redirect 5 -c -O /tmp/scratch-desktop.exe 'https://downloads.scratch.mit.edu/desktop/Scratch%20Setup.exe'
7za x -aoa -y /tmp/scratch-desktop.exe -o/tmp/scratch-desktop


######## create electron app
cp -rf ~/node_modules/electron/dist/* /tmp/scratch-desktop/
ln -fsr /tmp/scratch-desktop/electron /tmp/scratch-desktop/scratch-desktop


######## fix permissions
chmod 755 /tmp/scratch-desktop/locales
chmod 755 /tmp/scratch-desktop/swiftshader
chmod 755 /tmp/scratch-desktop/resources
chmod 755 /tmp/scratch-desktop/resources/static
chmod 755 /tmp/scratch-desktop/resources/static/assets


######## get application icon
wget -c -O /tmp/scratch-desktop/resources/Icon.png 'https://scratch.mit.edu/images/download/icon.png'


######## create rpm package
sudo dnf install rpm-build
cd ~
npm install electron-installer-redhat
wget -c -O /tmp/config-rpm.json 'https://gist.githubusercontent.com/lyshie/0c49393076b8b375ca1bd98c28f95fb0/raw/223cc112d99c3bdc1829fc25b19c260856134a82/config-rpm.json'
~/node_modules/.bin/electron-installer-redhat --config /tmp/config-rpm.json

scratch-desktop.md

Scratch Desktop (Scratch 3.0 Offline Editor) on GNU/Linux

Install electron

$ cd ~
$ npm install electron --save-dev
$ ls ~/node_modules/electron/dist

Extract scratch-desktop

$ rm -rf /tmp/scratch-desktop
$ mkdir /tmp/scratch-desktop
$ wget --max-redirect 5 -c -O /tmp/scratch-desktop.exe 'https://downloads.scratch.mit.edu/desktop/Scratch%20Setup.exe'
$ 7za x -aoa -y /tmp/scratch-desktop.exe -o/tmp/scratch-desktop

Create and launch electron app

$ cp -rf ~/node_modules/electron/dist/* /tmp/scratch-desktop/
$ ln -fsr /tmp/scratch-desktop/electron /tmp/scratch-desktop/scratch-desktop
$ /tmp/scratch-desktop/scratch-desktop

Fix permissions

$ chmod 755 /tmp/scratch-desktop/locales
$ chmod 755 /tmp/scratch-desktop/swiftshader
$ chmod 755 /tmp/scratch-desktop/resources
$ chmod 755 /tmp/scratch-desktop/resources/static
$ chmod 755 /tmp/scratch-desktop/resources/static/assets

Inside the app.asar

$ cd /tmp/scratch-desktop/resources/
$ ~/node_modules/.bin/asar extract app.asar app
$ cat app/package.json

Create RPM package

$ sudo dnf install rpm-build
$ cd ~
$ npm install electron-installer-redhat

$ chmod 755 /tmp/scratch-desktop/locales
$ chmod 755 /tmp/scratch-desktop/swiftshader
$ chmod 755 /tmp/scratch-desktop/resources
$ chmod 755 /tmp/scratch-desktop/resources/static
$ chmod 755 /tmp/scratch-desktop/resources/static/assets

$ ~/node_modules/.bin/electron-installer-redhat /tmp/config-rpm.json

OR

$ ~/node_modules/.bin/electron-installer-redhat --src /tmp/scratch-desktop/ --dest /tmp/ --arch x86_64

$ sudo dnf install /tmp/scratch-desktop-3.10.2-1.x86_64.rpm

Create DEB package

$ sudo apt-get install -yq npm gdebi p7zip-full
$ ls /tmp
create-deb.sh   config-deb.json

$ sh /tmp/create-deb.sh

$ sudo gdebi /tmp/scratch-desktop_3.10.2_amd64.deb

Dear Sirs,
After one year, I try to remake a new SCRATCH64bit.DEB for Linux.
From LINUX MINT 20.1 (Ubuntu 20.1) 64bit., I used the .sh script file I used in the past...
I just changed the version of scratch, but the command:

wget -O /tmp/scratch-desktop.exe 'https://downloads.scratch.mit.edu/desktop/Scratch%20Desktop%20Setup%VERSIONNUMBER.exe'

Is no more valid. So **I downloaded manually the .exe and and put in /temp the "scratch-desktop.exe" file. the .DEB was created, about 207Mbyte. the installation of .deb works, the menu icon is created but Scatch doesn't start!

From terminal:

`
linux@Mint201:~$ scratch-desktop
internal/modules/cjs/loader.js:586
throw err;
^

Error: Cannot find module '/usr/lib/scratch-desktop/resources/electron.asar/browser/init.js'
at Function.Module._resolveFilename (internal/modules/cjs/loader.js:584:15)
at Function.Module._load (internal/modules/cjs/loader.js:510:25)
at Function.Module.runMain (internal/modules/cjs/loader.js:746:12)
at startup (internal/bootstrap/node.js:282:19)
at bootstrapNodeJSCore (internal/bootstrap/node.js:759:3)
`

I managed to run the latest version of Scratch on the latest Debian Buster by doing the following:

1. When I followed the deb (amd64) instructions, I get a chrome-sandbox error. This should be fixed by executing: chmod 4755 chrome-sandbox as root.
2. Then after this, I got stuck with the Scratch is loading... screen. After A LOT of investigation, I solved the problem as follows:

• Go to directory resources/app
• vim main.js
• find nodeIntegration: true
• after true add: ,\n contextIsolation: false\n
• save and run scratch-desktop

Hope this helps someone!

Thanks a lot @bert003! In my case, to modify the file I had to first unpack the app.asar file (also in resources/). I did

• npm install asar
• asar extract app.asar modif
• edit the file modif/main.js
• asar pack modif app.asar

And then it works.

Thanks a lot @bert003 and @bidaian
I'll bring this to arch.

Dear Sirs,

I have followed the procedure and I obtained a working .deb installation file using the latest verison "Scratch-desktop v3.26.0"
After installed into Linux Mint 20.3 MATE 64bit, I have the ""SCRATCH IS LOADING" screen..
Then I try to modify the main.js
I had problem installing via terminal, of "npm install asar", so I used SNAP to install asar...

sudo rm /etc/apt/preferences.d/nosnap.pref && sudo apt update && sudo snap install asar --classic

after that,
cd /lib/scratch-desktop/resources sudo asar extract app.asar modif cd modif sudo nano main.js (and into the line "nodeIntegration: true" I changed it nto: "true,\n contextIsolation: false\n") cd .. sudo asar pack modif app.asar
Now If I launch Scratch, NO screen appear, anche the program close without showimg the Scratch windows (this is differemt from the starting issue with freezing screen "SCRATCH IS LOADING" )

Try to start Scratch via terminal, I obtain:

linux@Mint:/lib/scratch-desktop/resources$ /usr/lib/scratch-desktop/electron "/usr/lib/scratch-desktop/Scratch-desktop"
A JavaScript error occurred in the main process Uncaught Exception: SyntaxError: Unexpected identifier at Object.call (/usr/lib/scratch-desktop/resources/app.asar/main.js:1323:181) at e (/usr/lib/scratch-desktop/resources/app.asar/webpack:/webpack/bootstrap:25:22) at Object.call (/usr/lib/scratch-desktop/resources/app.asar/main.js:1328:97) at __webpack_require__ (/usr/lib/scratch-desktop/resources/app.asar/webpack:/webpack/bootstrap:25:22) at module.exports../node_modules/ajv/lib/ajv.js (/usr/lib/scratch-desktop/resources/app.asar/webpack:/webpack/bootstrap:96:10) at Object.<anonymous> (/usr/lib/scratch-desktop/resources/app.asar/main.js:1:1052) at Module._compile (node:internal/modules/cjs/loader:1116:14) at Object.Module._extensions..js (node:internal/modules/cjs/loader:1169:10) at Module.load (node:internal/modules/cjs/loader:988:32) at Module._load (node:internal/modules/cjs/loader:829:12) libva error: vaGetDriverNameByIndex() failed with unknown libva error, driver_name = (null) [2870:0122/203824.204885:ERROR:viz_main_impl.cc(161)] Exiting GPU process due to errors during initialization libva error: vaGetDriverNameByIndex() failed with unknown libva error, driver_name = (null) [2886:0122/203824.280940:ERROR:sandbox_linux.cc(376)] InitializeSandbox() called with multiple threads in process gpu-process.

Seems that the ASAR procedure to modify the file main.js has broke someting...Is it possible to solve this problem?
Many thanks in advance for your job!

I am trying to install .deb package on Ubuntu 22.04. I could successfully get upto cd /tmp/scratch-desktop/resources/ command.
However, when I try the next command i.e. ~/node_modules/.bin/asar extract app.asar app, I get /home/user/node_modules/.bin/asar: No such file or directory.
Please help.

@shaileshparanjpe : To avoid that problem just install asar with:
npm install @electron/asar

Anyway, if you're using Ubuntu, instead of pasting all those lines, the only thing you need to do is this:

wget https://gist.githubusercontent.com/lyshie/0c49393076b8b375ca1bd98c28f95fb0/raw/e6bca7386ac58a99ce8de07489481a2e579b170f/create-deb.sh
chmod +x create-deb.sh
,/create-deb.sh

That's it.

If you're using a Raspberry Pi 4 with Ubuntu, you should change the architecture to arm64 (or armhf if you're running on 32-bit) in the config-deb.json file (you'll have to download it manually, edit it, then remove the "wget -c -O /tmp/config-rpm.json ..." line from the create-deb.sh file to avoid overwriting your arch modification). But this version of Scratch won't have access to the GPIO and SenseHat extensions for the Raspberry Pi, sadly, since those extensions are exclusive to the special version of Scratch Desktop that comes with the official Raspberry Pi OS.

Thank you for your job, @lyshie !!

Thank you for this tutorial, is really helpful. Keep up with the good work.

In create-deb.sh, the last line should be sudo gdebi /tmp/scratch-desktop_3.29.1_amd64.deb, not sudo gdebi /tmp/scratch-desktop_3.12.0_amd64.deb