If you’ve downloaded a pre-built binary for a specific vehicle, see the Flashing a Pre-compiled Binary section for instructions on how to flash your CAN translator. Most users do not need to set up the full development described in these docs.

Quick Start


  1. Install Git from your distribution’s package manager.


$ sudo apt-get install git

Arch Linux:

$ [sudo] pacman -S git
  1. Continue to the all platforms section.


  1. Install Cygwin and in the installer, select the following packages:
gcc4, patchutils, git, unzip, python, python-argparse, check, curl, libsasl2, ca-certificates, python-setuptools
  1. Start a Cygwin Terminal.
  2. Configure the terminal to ignore Windows-style line endings in scripts:
$ set -o igncr && export SHELLOPTS
  1. Install the FTDI driver (the bootstrap script tries to take care of this, but some developers are reporting that it doesn’t actaully get installed)
  2. Continue to the all platforms section.


  1. Open the Terminal app.
  2. Install Homebrew: ruby -e "$(curl -fsSkL"
  3. Install Git with Homebrew (brew install git).
  4. Continue to the all platforms section.

All Platforms

  1. If your network uses an Internet proxy (e.g. a corporate network) set the http_proxy and https_proxy environment variables:
$ export http_proxy=<your proxy>
$ export https_proxy=<your proxy>
  1. Clone the cantranslator repository:
$ git clone
  1. Run the script:
$ cd cantranslator
$ script/
  1. If there were no errors, you are ready to compile. If there are errors, follow the recommendations in the error messages. You may need to manually install the dependencies if your environment is not in a predictable state.

The script is tested in Cygwin, OS X Mountain Lion, Ubuntu 12.04 and Arch Linux - other operating systems may need to install the dependencies manually.

Table Of Contents

Previous topic

OpenXC CAN Translator

Next topic

Flashing a Pre-compiled Binary

This Page