Download your project to your computer

Once you have finished making your program, it needs to be downloaded to your computer ready for transfering to CodeBug.

Click the Download button below the CodeBug emulator to download your project file to your computer.

A window pops up informing you that your program is being built and will be downloaded shortly. Continue to the next step of the instructions below.

Connect your CodeBug

You need to transfer the file you downloaded onto CodeBug. When you plug CodeBug into your computer it can appear as a USB drive (just like a USB memory stick). You will need to transfer the file you just downloaded onto it, as if you were saving it to a normal USB drive. To make your CodeBug appear as a USB drive, follow these steps:

Plug the small end of the Micro-USB cable into CodeBug.

While holding down button A on your CodeBug, plug the large end of the Micro-USB into your computer. You must press button A before plugging in, and keep it held.

The LED in the top left of CodeBug’s LED display will flash to show CodeBug is ready to receive your program. Now let go of button A.

Earlier, when you clicked Download, an instruction box will have appeared on the website. You can ignore this for now, as these instructions for plugging in CodeBug are detailed in the next section of this guide.

Transfer your project to CodeBug

Now that your project file is downloaded to your computer and your CodeBug is appearing as a USB drive, you need to transfer the program onto CodeBug. There are different steps to follow to transfer your project to CodeBug depending on your computer's operating system and web browser.

Choose the relevant instructions below, by clicking the bar that corresponds to your operating system. In the section that opens beneath it, click the tab for the web browser you are using.

After plugging in CodeBug, an AutoPlay window may pop-up, close it by clicking the cross in the corner.

Click the Open folder button in the bar that appears at the bottom of your browser.
A grey bar at the bottom of your Chrome window will appear with your project file name listed. Click the menu arrow to the right of your project file.

In this menu, select Show in folder.

An "Opening" window may appear, click the radio button next to Save File, then click OK.
Click the downloads menu (the button with the downwards arrow icon) in the top-right corner of your Firefox window.
In the downloads list that appears, click the folder icon next to your project file, to show the file in the file browser.

USB transfer

In the file browser window that appears, you will see your project file. Drag this onto the CodeBug drive.

After clicking the Download button on the CodeBug website, a Downloads window should appear, however if it does not, click Window > Downloads on your Safari menu bar.

Then in the downloads window, click the magnifying glass by your project file, to show the file in Finder.


In the Finder window that appears, drag the file to the CodeBug USB drive.

After plugging in CodeBug, a window will appear stating Removable medium is inserted, close this by clicking Cancel.

A grey bar at the bottom of your browser window will appear, with your project file name listed. Click the menu arrow to the right of your project file.

In this menu, select Show in folder.


In the file browser window that appears, open /media/pi/ then click back onto on the Downloads folder. Now drag your project file from the Downloads to the CodeBug folder.

When your program has finished loading, the LED in the top right of CodeBug’s display will turn on.

Reset your CodeBug

Now that CodeBug is programmed, you must reset CodeBug to start running your program by pressing button B. Your program will now be running.

Now that you've mastered transfering you program onto CodeBug, check out the activities for inspiring, fun projects to make and do.
Microsoft, and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Safari and Mac are trademarks of Apple Inc., registered in the U.S. and other countries. All other trademarks acknowledged.
Back to top