Skip to content
This repository was archived by the owner on Apr 14, 2024. It is now read-only.

Building OSCam Emu

oscam-emu edited this page Apr 18, 2019 · 2 revisions

Building OSCam-Emu binaries is a 3 step process that consists of getting the source files, configuring, and building for the desired target architecture.


1. Get OSCam-Emu source code

You can get latest OSCam-Emu sources from GitHub by cloning the oscam-patched repository or by just downloading the source files archives. You can clone the OSCam-Emu source code like this:

git clone https://github.com/oscam-emu/oscam-patched.git
cd oscam-patched
git checkout master

2. Configure OSCam-Emu

OSCam-Emu has a variety of features. Some of them are disabled by default, but can be enabled before compilation using the provided config.sh script. Some useful commands are listed below:

./config.sh --help Display information on how to use this scrit

./config.sh --show-enabled Display a list of all enabled features

./config.sh --show-disabled Display a list of all disabled features

./config.sh -g Choose the features you want via a graphical user interface

./config.sh --enable FEATURE Enable feature FEATURE

./config.sh --disable FEATURE Disable feature FEATURE

./config.sh --oscam-revision Display OSCam-Emu revision / version

You can put a SoftCam.Key file into the oscam-patched directory to integrate keys into the binary. This feature is not available for Mac OSX and Android. SoftCam.Key cannot be integrated on these systems. This feature is controlled by the WITH_SOFTCAM option, which is enabled by default.


3. Build OSCam-Emu

OSCam-Emu building is done using either make or cmake. Examples below are made using make.

In addition to the configuration options above, there are several options that can be set during compilation time and control the build environment. These options can be displayed using the make help command. Some of the most commonly used are CROSS=prefix, USE_LIBUSB=1, USE_LIBCRYPTO=1, USE_UTF8=1. Similar options are available for cmake.

Native compilation examples

make USE_LIBCRYPTO=1 Build using libcrypto instead of OSCam-Emu's internal crypto functions

make -j 6 USE_LIBCRYPTO=1 USE_UTF8=1 Build using 6 cpu threads, libcrypto and with webif utf8 support.

Cross compilation examples

make CROSS=aarch64-linux-gnu- USE_LIBCRYPTO=1 USE_UTF8=1

NOTE: Since OSCam-Emu version 795, compiling with libcrypto is mandatory!

Clone this wiki locally