OS

Here a list of working configurations and special requirements for operating.

Linux

Ubuntu 14.04.2 LTS x64

Update your system:

 	sudo apt-get update
 	sudo apt-get upgrade

To update pyserial install pip and upgrade pyserial:

 	sudo apt-get install python-pip
	sudo pip install pyserial --upgrade

Install tkinter:

	sudo apt-get install python python-tk idle python-pmw python-imaging

Download or clone the repository to your system.
If downloaded as zip file, extract it to a preferred location, open the folder and run:

	./bCNC

Happy milling!

Raspberry Pi

Setup a fresh Raspberry Pi image on an SD card and get it connected to the internet

Download the most recent Raspbian image from raspberrypi.org. Make sure to use their recommended methods to upload Raspbian to an SD card.
Connect to power, a monitor/TV, keyboard, and mouse. Do the standard setup of an RPi image, expanding the file system and setting it boot to the GUI.
Optional: Connect the RPi to the internet via Ethernet or using a Wifi dongle and GUI Wifi setup tool. If not, bCNC runs great as a stand-alone Grbl GUI!

Load bCNC onto your Raspberry Pi!

If connected to the internet, open the RPi web browser and download bCNC from github. Unzip the downloaded file.
If not connected to the internet, you'll need to download bCNC onto a USB stick and copy it onto your RPi.

Run bCNC!

Simply run bCNC by clicking on the bCNC icon. When asked, it's recommended that you select Execute from terminal the first you run it to know if there are any problems. Or, you run it from terminal directly. That's it!

All of the dependent libraries should already be part of the standard RPi image (confirmed on RPi 2). If bCNC doesn't load and gives a serial error, you may need to update pyserial manually. To fix, install pip via sudo apt-get install pip, followed by sudo pip install pyserial --upgrade. (You may want to run sudo apt-get update and sudo apt-get upgrade beforehand.)

There is also a a RPI image with bCNC, XRDP, CuteCom at http://wiki.protoneer.co.nz/Raspberry_Pi_CNC#bCNC_.5BPython.5D.5BRecommended.5D

###BananaPi Reported as working

Olimex Olinuxino

[Olimex Olinuxino](Olimex Olinuxino)

Windows

Usually python is missing from Windows, so you need to install it. Python 2 is more tested at present time, but efforts are made to allow bCNC run also on Python 3.
Install also pyserial, use the correct installer for the same version of your python installation.
Download or clone the repository to your system.
If downloaded as zip file, extract it to a preferred location, open the folder and run bCNC.bat