OS

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

---

Linux / BSD

1. Update your system (Optional) and install git, python (with tkinter support) and pip:

	#This is specific for Debian/Ubuntu, other distros have other package managers than apt-get
	sudo apt-get update
	sudo apt-get upgrade
	sudo apt-get install git python python-tk python-pip

2. Install bCNC using pip and launch it:

	sudo pip2 install --upgrade bCNC
	#sudo pip2 install --upgrade git+https://github.com/vlachoudis/bCNC #if you want git version
	python2 -m bCNC

Happy milling!

---

Windows

Using PIP

1.) Install python 2.7: https://www.python.org/downloads/

Do not forget to install Tcl/Tk and PIP modules while doing so. Also check that python will be added to path:

Open commandline and install bCNC using pip:

This installs bCNC to C:\Pyhton27\Lib\site-packages\bCNC\ and launches it

.exe build

There might be experimental .exe build available at https://github.com/vlachoudis/bCNC/releases Such build does not need anything. Only download, unpack zip and launch bCNC.exe

Following table is probably outdated

OS	Python	Notes
Windows XP SP3	2.7.5
Windows Vista SP2	2.7.9
Windows 7	2.7.*	Any 2.7 version should work
Windows 8.1	2.7.10 is known to work
Windows 10	2.7.*	Any 2.7 version should work

---

Mac OSX

FIXME: There is probably easier way to do this. Any mac user here to update this?

It is recommended to use Homebrew for installing dependencies.

1. Install git and Python

    brew install git
    brew install python --with-tcl-tk

2. Activate the brew python version. At the time of writing, the standard "brew link python" method no longer works. Put the brew path before the OS provided PATH in your profile files. See notes on homebrew github. For example, in your .bash_profile and/or .profile, add the following line (or adapt the PATH line that is in there already), and restart the terminal session.

    export PATH=$(brew --prefix)/opt/python/libexec/bin:${PATH}

3. Install a recent version of tcl-tk. At the time of writing, you may need the dev version, in order to avoid a SIGABRT. See notes on homebrew github.

    brew install --devel tcl-tk

4. Install zlib which is required by python-imaging. See notes on Stackoverflow.

    brew install homebrew/dupes/zlib
    brew link zlib --force 

5. Install and launch bCNC

    pip install --upgrade bCNC
    python -m bCNC