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

_sudo apt-get install pip_

Then upgrade pyserial

_sudo pip install pyserial --upgrade_

*Install tkinter

_sudo apt-get install python python-tk idle python-pmw python-imaging_

*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.)

###BananaPi Reported as working

Olimex Olinuxino

[Olimex Olinuxino](Olimex Olinuxino)

Windows

Usually python is missing from Windows, so you need to install it, choose between version 2 or 3, bCNC should works on both.
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