If your SD card has been corrupted you can frequently fix this by buying a new image on to the SD card. Below is the latest Boolean Girl disk Image and instructions for “burning” a new disk. NOTE: this will wipe out any data on the disk. If you are updating your disk, make sure you save your programs to a USB drive first.

Follow this link to download the image file to your PC or Mac.

Once the file has downloaded, follow these instructions.  You should format your SD card first.

Windows Instructions

1. Insert the micro SD card that you want to clone in your PC using a USB or built-in card reader.
2. Download and install Win32DiskImager, and run it.
3. Select the image file you downloaded, and the appropriate drive in the Device section. Now, click on the Write button. The image will be saved to the SD card, exactly how it was, at the time you copied it.

This process will take a while depending on the size of the SD card. Once the restore is complete, you can remove the card from your PC, and insert it back in the Raspberry Pi.

Linux or Mac Instructions

You can use an image writing tool similar to Win32DiskImager to install the image you have downloaded on your SD card. The recommended tool is balenaEtcher. This tool works on Mac OS, Linux and Windows. Steps:
1. Download balenaEtcher and install it.
2. Connect an SD card reader with the SD card inside.
3. Open balenaEtcher and select from your hard drive the Raspberry Pi .imgor .zip file you wish to write to the SD card.
4. Select the SD card you wish to write your image to.
5.Review your selections and click ‘Flash!’ to begin writing data to the SD card.

You can also do this from the command line on Mac or Linux

1. Open a terminal, then run:

diskutil list

2. Identify the disk (not the partition) of your SD card, e.g. disk4, not disk4s1.
Unmount your SD card by using the disk identifier, to prepare it for copying data:

diskutil unmountDisk /dev/disk<disk# from diskutil>

where disk# is your disk identifier e.g.

diskutil unmountDisk /dev/disk4

3. Change to the directory where you saved the image file: 2019-10BooleanGirl.img  (maybe downloads?)

cd Downloads

4. Copy the data to your SD card:

 sudo dd bs=1m if=imageFileName.img of=/dev/rdisk<disk# from diskutil> conv=sync

where disk# is your disk Identifier e.g.

sudo dd bs=1m if=2019-10BooleanGirl.img of=/dev/disk4 conv=sync

Typically you will be asked for the password.  This is your Mac login password.

Common issue

This may result in a dd: invalid number ‘1m’ error if you have GNU coreutils installed. In that case, you need to use a block size of 1M in the bs= section, as follows:

sudo dd bs=1M if=image.img of=/dev/disk<disk# from diskutil> conv=sync

This will take a few minutes, depending on the image file size. You can check the progress by sending a SIGINFO signal (press Ctrl+T).


If this command still fails, try using rdisk instead of disk, for example:

 sudo dd bs=1m if=2019-10BooleanGirl.img of=/dev/disk4 conv=sync


 sudo dd bs=1M if=2019-10BooleanGirl.img of=/dev/rdisk4 conv=sync

These instructions are based on the Raspberry Pi foundation instructions here.

Why update the disk image? If you purchased your Boolean Box before October of 2019 this image has updated version of Scratch, a new google chrome based web browser, a new Python development environment, several python libraries, and if you purchased prior to March 2018, a new block based Python programming tool.