How to run OpenKore on Linux/Unix

You must have a C and C++ compiler installed. GCC is installed by default on many Linux distributions, but apparently some people install Linux without GCC.

To check whether you have a C++ compiler installed, open a terminal and type:

g++ -v

If you don't get an error, then you have a C++ compiler, and you can skip to the next paragraph. If not, read the table below.

su -c 'yum install gcc-c++'

sudo apt-get install build-essential g++

su -c 'apt-get install g++'

su -c 'yast -i gcc-c++'

You must have Perl 5.8.2 or newer installed. 5.8.1 or earlier are not supported! To check whether you have Perl installed (and whether it is the correct version), type:

perl -v | grep perl

If you see the Perl version number, then it is installed. If you get an error, then it is not installed, and you should read the following table.

su -c 'yum install perl'

sudo apt-get install perl

su -c 'apt-get install perl-base'

cd /usr/ports/lang/perl5.8
su -c 'make install'

You need the Time::HiRes Perl module. You can check whether you already have it by typing

perl -e 'use Time::HiRes;'

If nothing happens, then it is installed, and you can skip to the next paragraph. If you get an error, then it is not installed, and you should read the following table.

su -c 'yum install perl-Time-HiRes'

su -c 'apt-get install libtime-hires-perl'

cd /usr/ports/devel/p5-Time-HiRes
su -c 'make install'

You need the Compress::Zlib Perl module. You can check whether you already have it by typing

perl -e 'use Compress::Zlib;'

If nothing happens, then it is installed, and you can skip to the next paragraph. If you get an error, then it is not installed, and you should read the following table.

sudo apt-get install libcompress-zlib-perl

cd /usr/ports/archivers/p5-Compress-Zlib
su -c 'make install'

GNU readline and its associated development package must be installed. You need at least version 5.0. To check whether you have a recent enough version of GNU readline, follow the following instructions:

1. Copy and past the following text into a text editor:

   #include <stdio.h>
   #include <readline/readline.h>
   #if !defined(RL_READLINE_VERSION)
   	#error "You do not have the GNU readline development headers installed!"
   #elif RL_READLINE_VERSION < 0x0500
   	#error "Your version of GNU readline is too old. Please install version 5.0 or higher."
   #endif
   
   
   

   (note that the file must end with an empty line)
2. Save the file as readlinetest.c in your home folder.
3. Open a terminal and type:

   gcc -c ~/readlinetest.c

If you do not see any output, then that means you have GNU readline correctly installed, and you can skip to the next paragraph. If you do see an error message, then read the following table.

su -c 'yum install readline-devel'

sudo apt-get install libreadline5-dev

su -c 'apt-get install libreadline5-dev'

cd /usr/ports/devel/readline
su -c 'make install'

gmake (GNU make) must be installed. To check whether you have gmake installed, open a terminal and type:

gmake -v

If it displays the gmake version, then you have gmake installed, and you can proceed to the next paragraph. If you get a "command not found" error, then gmake is not installed, and you should follow the following table.

su -c 'yum install make'

sudo apt-get install build-essential
sudo ln -sf /usr/bin/make /usr/bin/gmake

su
apt-get install make
ln -sf /usr/bin/make /usr/bin/gmake

cd /usr/ports/devel/gmake
su -c 'make install'

su -c 'yast2 -i make'

Python must be installed. To check whether you have it, type:

echo 'print "Python is installed"' | python

If you get the message "Python is installed", then Python is installed, and you can skip to the next paragraph. If Python is not installed, then read the following table.

su -c 'yum install python'

sudo apt-get install python

su -c 'apt-get install python'

cd /usr/ports/lang/python
su -c 'make install'

The Curl development libraries are needed to compile OpenKore. To check whether you have it, type:

curl-config --version

If you get "command not found" as error message, you need to install libcurl:

su -c 'yum install curl-devel'

apt-cache search libcurl

sudo apt-get install libcurlx-dev

apt-cache search libcurl

su -c 'apt-get install libcurlx-dev'

cd /usr/ports/ftp/curl
su -c 'make install'

First, download the OpenKore source code. You may also want to download the default configuration/table files and the field pack if you haven't done so already.

Extract the archives as instructed on the download page.

Open a terminal. Go the OpenKore folder. Type:

perl ./openkore.pl

And you're done. OpenKore will automatically try to compile XSTools.so, an internally used library. If compilation fails, please check the Common problems. If you still cannot, report the error on our forum.

ld: cannot find -ltermcap

This problem can only occur in OpenKore 1.6, not 1.9 or later. Some distros don't support termcap anymore. Open up 'src/auto/XSTools/Makefile.in' with a text editor.

Change

LIBS=-lreadline -L/usr/lib/termcap -ltermcap -pthread `curl-config --libs`

to

LIBS=-lreadline -lncurses -pthread `curl-config --libs`

Missing headers

Another common reason why compilation fails is because of missing headers. Look in the compilation messages. Do you see a message somewhere that looks like this?

foo.h: No such file or directory

If so, then that means you didn't install all the libraries that OpenKore needs! Please go through Preparation again.