Install and compile Heimdall

From CyanogenMod
Jump to: navigation, search



$ su -c 'yum groupinstall "Development Tools"'
$ su -c 'yum install libusb1-devel qt-devel libtool'

After this step follow instructions for generic linux given below

Debian based

These instructions are for Debian based distributions including Ubuntu and LinuxMint.

$ sudo apt-get install build-essential pkg-config zlib1g-dev libusb-dev libqt4-dev qt4-qmake autoconf libtool libusb-1.0-0-dev

After this step follow instructions for compiling for generic linux below. Alternatively users with Ubuntu (and Ubuntu based) systems can follow the instructions at

Arch Linux

Heimdall is available in the AUR (AUR/heimdall). If you have yaourt or pacaur you can compile and install simply using

$ yaourt -S heimdall


$ pacaur -S heimdall

Generic Linux Instructions

These are distro-independent instructions.

Installing prerequisites

Use your favourite package manager to install (the development version if your distro has seperate "-dev" packages)of the following pre-requisites:

  1. gcc/g++
  2. make(automake)
  3. libc(glibc)
  4. libusb
  5. qt

Downloading and Installing

$ git clone git://
$ cd Heimdall/libpit
$ ./
$ ./configure
$ make
$ cd ../heimdall
$ ./
$ ./configure
$ make
$ su -c 'make install'
$ cd ../heimdall-frontend/
$ qmake-qt4
$ make
$ su -c 'make install'

If you get a message like “RCC: Warning: No resources in ‘mainwindow.qrc’” during qmake-qt4, you can ignore it. It is not an actual error and Heimdall will work just fine.

You can now run Heimdall from the command line by running either

$ heimdall


$ heimdall-frontend


Installing prerequisites

  • First make sure you have installed XCode and pkgconfig.
    • There are several different ways you can install pkgconfig, the simplest option is to use Homebrew.
$ brew install pkgconfig
  • Open a terminal and navigate to the directory you downloaded, or extracted, Heimdall to.
  • Install libusb >= 1.0:
$ brew install libusb
  • Enter the following commands to compile libpit.
$ cd libpit
$ ./configure
$ make
$ cd ..
    • NOTE: There is no need to run "sudo make install".

Installing heimdall

  • Enter the following commands to compile and install Heimdall:
$ cd heimdall
$ export CC=/usr/bin/clang CXX=/usr/bin/clang++
$ ./configure
$ make
$ sudo make install
$ cd ..
    • NOTE: The export line is needed to overcome a compile error with 1.4RC and will hopefully be unnecessary soon.
    • NOTE: Do not be alarmed if the sudo make install ends with: make[2]: Nothing to be done for `install-data-hook'
  • If you haven't installed the driver before, enter the following:
$ cd OSX
$ sudo ./

Installing the Frontend

  • First make sure you have installed XCode from your OS X install DVD.
  • You'll also need Qt 4.7 or later, available from:
  • Open a terminal and navigate to the directory you extracted Heimdall to.
  • Enter the following commands to compile and install Heimdall Frontend:
$ cd heimdall-frontend
$ qmake
  • Open Finder and navigate to the heimdall-frontend sub-directory. Open the newly created XCode project.
  • From the menu bar select Build -> Build. This outputs heimdall-frontend to /Applications


Installing prerequisites

Installing Heimdall

  1. Open Heimdall/msvc2010.sln
  2. From the Solutions Configuration drop-down change from "Debug" to "Release".
  3. In the Solution Explorer right-click on the heimdall-frontend project and chose "Build".
  4. Depending on how you've installed Qt on your system you may need to copy "QtCore4.dll, "QtGui4.dll" and "QtXml4.dll" from your Qt bin/ sub-directory to Heimdall's Win32/Release sub-directory.
  5. Heimdall Frontend can then be run from Win32/Release or command line can be used to run Heimdall (command line) from the same directory.