pcb2gcode is a command-line software for the isolation, routing and drilling of PCBs. It takes Gerber files as input and it outputs gcode files, suitable for the milling of PCBs. It also includes an Autoleveller, useful for the automatic dynamic calibration of the milling depth.
pcb2gcodeGUI, the official GUI for pcb2gcode, is available here.
If you find this project useful, consider donating money to charity.
This development version of pcb2gcode does not get into repositories of distros. If you want to test this version, you will have to go to the section below (installation from GIT).
- pcb2gcode stable ->
- pcb2gcode git ->
Download the latest tarball from https://github.com/pcb2gcode/pcb2gcode/releases
Open a terminal and cd to the extracted tarball
type the following:
su <the root password> yum groupinstall "Development Tools" yum install automake autoconf libtool boost-devel gtkmm24-devel gerbv-devel exit ./configure make su -c 'make install'
There are pcb2gcode packages in the official repositories. You can install the with
sudo apt-get install pcb2gcode
Unfortunately, these packages are seriously outdated. If you want to download the latest development version, go to "Installation from GIT".
Windows prebuilt binaries (with all the required DLLs) are available in the release page.
Mac OS X
pcb2gcode is available in Homebrew. To install it open the "Terminal" app and run the following commands; pcb2gcode and the required dependencies will be automatically downloaded and installed:
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" $ brew install pcb2gcode
Installation from GIT (latest development version):
If you want to install the latest version from git you'll need the autotools, Boost with the program_options library (dev, >= 1.56), gtkmm2.4 (dev) and libgerbv (dev).
Unfortunately pcb2gcode requires a rather new version of Boost (1.56), often not included in the oldest distros (like Ubuntu < 15.10 or Debian Stable). Moreover Boost 1.56 sometimes freezes pcb2gcode, while Boost 1.59, 1.60 and 1.61 are affected by a program options bug. You can download a working version of Boost (1.57 and 1.58 work well) and build it manually with:
$ ./bootstrap.sh --with-libraries=program_options --prefix=<somewhere> $ ./b2 variant=release link=static $ ./b2 install
--with-boost=<boost install directory> --enable-static-boost to the
To build with coverage outputs, add
./configure and then later run
make check-code-coverage to run unit tests to collect coverage. The last line of the output will include a URL to view the coverage.
Ubuntu 12.04 does not include gcc 4.8 (needed for the C++11 support); you can install it with:
$ sudo apt-get update $ sudo apt-get install software-properties-common python-software-properties $ sudo add-apt-repository "ppa:ubuntu-toolchain-r/test" $ sudo apt-get update $ sudo apt-get install g++-4.8 $ export CXX=g++-4.8
$ sudo apt-get update $ sudo apt-get install build-essential automake autoconf autoconf-archive libtool libboost-program-options-dev libgtkmm-2.4-dev gerbv git librsvg2-dev $ git clone https://github.com/pcb2gcode/pcb2gcode.git $ cd pcb2gcode
Then follow the common build steps
su <the root password> yum groupinstall "Development Tools" yum install automake autoconf libtool boost-devel gtkmm24-devel gerbv-devel git exit
Then follow the common build steps
$ autoreconf -fvi $ ./configure $ make $ sudo make install
You can easily build pcb2gcode for Windows with MSYS2 (http://sourceforge.net/projects/msys2/). Download MSYS2 and install it somewhere, then run "MinGW-w64 Win32 Shell" (if you want a i686 binary) or "MinGW-w64 Win64 Shell" (if you want a x86_64 binary). The following commands are for the i686 binary, if you want the x86_64 binary replace all the "/mingw32" with "/mingw64" and all the mingw-w64-i686-* packages with mingw-w64-x86_64-*
$ pacman -Sy $ pacman --needed -S bash pacman pacman-mirrors msys2-runtime
Close and reopen the shell
$ pacman -Su $ pacman --needed -S base-devel git mingw-w64-i686-gcc mingw-w64-i686-boost mingw-w64-i686-gtkmm
Now let's download, build and install gerbv (version 2.6.1 is broken, don't use it)
$ wget downloads.sourceforge.net/gerbv/gerbv-2.6.0.tar.gz $ tar -xzf gerbv-2.6.0.tar.gz $ cd gerbv-2.6.0/ $ ./configure --prefix=/mingw32 --disable-update-desktop-database $ make $ make install
Finally, download and build pcb2gcode
$ cd .. $ git clone https://github.com/pcb2gcode/pcb2gcode.git $ cd pcb2gcode/ $ autoreconf -fvi $ ./configure --prefix=/mingw32 $ make LDFLAGS='-s'
The dynamically linked binary is <msys2 installation folder>/home/<user>/pcb2gcode/.libs/pcb2gcode.exe. You can find all the DLLs in <msys2 installation folder>/mingw32/bin; copy them in the same folder of pcb2gcode. The required DLLs are:
- libgcc_s_dw2-1.dll (for the i686 binary)
- libgcc_s_seh-1.dll (for the x86_64 binary)
Mac OS X
You can build the latest pcb2gcode version with Homebrew. If Homebrew is not installed yet, install it with the following command:
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
You might need some build tools that typically are not present:
$ brew install autoconf automake libtool
Then you can download and build the git version with
$ brew install --HEAD pcb2gcode
or (if pcb2gcode is already installed)
$ brew upgrade --HEAD pcb2gcode
For further details, see INSTALL.