Skip to main content

Scratch Getting Started Guide

Profile picture for user PocketLab
Submitted by PocketLab on Thu, 06/29/2017 - 01:21


PocketLab Scratch Integration- Windows 10

 This Getting Started Guide will show you how to install the required programs and start programming with ScratchX and PocketLab.

 The PocketLab app can send data to the Scratch Visual Programming environment. The integration is currently in beta release and requires:

  • Compatible Windows 10 laptop or 2-in-1
  • PocketLab sensor
  • PocketLab app (free download from the Windows Store)
  • Chrome Browser
  • PocketLab-Scratch plug-in for Chrome Browser (free download from the Google Web Store)
  • ScratchX for PocketLab program (free download from the PocketLab website or Githubsite)


Windows 10 App Installation and Setup

To connect the PocketLab sensor to your Windows device you will have to go through an initial setup like you would setup a Bluetooth mouse or speaker. You only have to do this once perPocketLab sensor and Windows device. After the initial setup, the PocketLab sensor can connect directly through the PocketLab app.

  1. Make sure your Windows 10 version is up to date.
    1. On your device, go to Settings >> Update & security >> Windows Update
    2. The PocketLab app works best with the most recent Windows 10 version.
    3. If you need to update the software, follow the instructions to download the latest version of Windows 10.
  2. Download the free PocketLab app from the Windows Store.
  3. After installation is complete, Settings >> Devices >> Bluetooth and turn Bluetooth ON.
  4. Press the top button on the PocketLab sensor. The sensor will flash red and green and a new Bluetooth device should appear in the device list with the serial number: “MS-PL-HW10-FW10-0001” and the message “Ready to Pair”. Click on the Bluetooth device and press the Pair button.
  5. Enter the passcode “0000” and then press Next to pair to the PocketLab sensor


  1. Press the top button on the PocketLab sensor to disconnect from the Windows device.
  2. Go to your applications from the Start menu and click on the PocketLab icon to launch the app.
  3. Agree to the access privileges that the PocketLab app needs to function. The PocketLabapp needs access to the Bluetooth hardware to connect to the sensor. A pop up window should appear the first time you launch the PocketLab app.


Install the ScratchX for PocketLab Program

 You will need to install a helper program to connect the PocketLab app data to ScratchX. Go to the PocketLab and Scratch Windows 10 install files page ( or the Github page ( to download the helper program.

From Github

  1. Go to
  2. Press the Download ZIP button. Save the zip file to your computer.
  3. Open the zip folder “ScratchX-gh-pages”.
  4. Click on “ScratchX for PocketLab”.
  5. Follow the instructions in the Installation Wizard to install the program.


Install the PocketLab ScratchX Extension for Chrome

The PocketLab and ScratchX Extension is only available for the Chrome browser. If you do not have Chrome installed on your Windows computer, you can download the program from Google for free here:

  1.  In the Chrome browser go to the Chrome Web Store:
  2. Search for “PocketLab ScratchX
  3. To download the extension, press the + Add to Chrome button
  4. Press Add Extension in the pop-up box


Connect the PocketLab Sensor and App

  1. Launch the PocketLab app from the Windows Start menu.
  2. Press the top button on the PocketLab sensor. The LED indicator will flash alternating red and green.
    1. If the PocketLab sensor is in close range to the Windows device, the sensor will connect automatically. While the sensor is connecting to the app, the LED indicator will flash red.
    2. If the PocketLab sensor is too far away to automatically connect, a message at the bottom of the connection screen appears and says “Pair with 360243…..”. Tap the message to connect.
  3. Click on the Graph Select menu icon. Enable the check box by Scratch at the bottom of the Graph list.



Run the ScratchX Program

  1. In the Chrome browser go to
  2. The ScratchX window should look like this:Screenshot 
  3. To launch an example PocketLab ScratchX program download any of the examples from the PocketLab Github here: or from the PocketLab and Scratch Windows 10 install files page (
  4. In the ScratchX window go to File >> Load Project to load the example program.
  5. The ScratchX window should now look like the following screenshots:



Using PocketLab and ScratchX

  1. When all the PocketLab app, extension and ScratchX program are working correctly, the indicator light next to the “PocketLab Extension” menu will be green.
  2. Press the green Run Flag icon to run the ScratchX program. Data from the PocketLabsensor should be sent to the ScratchX coding environment.
  3. If the indicator light turns yellow, the first fix to try is disabling/enabling the PocketLabScratchX Chrome extension. Click on the Customize menu button (the three line icon on the right side of the Chrome browser) >> More tools >> Extensions. Navigate to thePocketLab ScratchX Extension and uncheck and then re-check the Enabled box.
  4. If the indicator light is still yellow and PocketLab data is not going through to ScratchX, close all the programs and restart the computer.
  5. For a video tutorial on using ScratchX with PocketLab watch the video below or go here: 


Product Support

For additional support, please contact The PocketLab Team at [email protected] and visit our website at