Install and compile Heimdall
$ 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
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 https://launchpad.net/~modycz/+archive/heimdall
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.
Use your favourite package manager to install (the development version if your distro has seperate "-dev" packages)of the following pre-requisites:
Downloading and Installing
$ git clone git://github.com/Benjamin-Dobell/Heimdall.git $ cd Heimdall/libpit $ ./autogen.sh $ ./configure $ make $ cd ../heimdall $ ./autogen.sh $ ./configure $ make $ su -c 'make install' $ cd ../heimdall-frontend/ $ qmake-qt4 heimdall-frontend.pro $ 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
- 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:
- The simplest option is to use Homebrew.
$ brew install libusb
- Alternatively you may download and compile from: http://www.libusb.org/
- Enter the following commands to compile libpit.
$ cd libpit $ ./configure $ make $ cd ..
- NOTE: There is no need to run "sudo make install".
- 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: Nothing to be done for `install-data-hook'
- If you haven't installed the driver before, enter the following:
$ cd OSX $ sudo ./install-kext.sh
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: http://qt.nokia.com/downloads/
- 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 heimdall-frontend.pro
- 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
- Ensure that you have both a version of Visual Studio 2010 with C++ support and Qt Developer Framework 4.7 (or newer) installed on your system.
- A free version (Visual C++ 2010 Express) can be downloaded from Microsoft's website:
- Qt can also be downloaded freely from Nokia's website:
- Open Heimdall/msvc2010.sln
- From the Solutions Configuration drop-down change from "Debug" to "Release".
- In the Solution Explorer right-click on the heimdall-frontend project and chose "Build".
- 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.
- Heimdall Frontend can then be run from Win32/Release or command line can be used to run Heimdall (command line) from the same directory.