NoMachine Support

Your questions answered

Knowledge Base

Searching in: Articles & FAQs
Filter the search results
Applies to:
Last update:
Searching in: Articles & FAQs
ID: AR10K00695
Applies to: NoMachine Software
Added on: 2013-10-01
Last update: 2020-07-07
Building libx264 on the NoMachine server host

This article refers to version 4/5 of the NoMachine software. From version 6 the H.264 codecs are shipped in all products from the NoMachine range. If you have asked for software packages without the software codecs, please consult the instructions below.

In order to enable H.264 codec in NoMachine it's necessary that you have a H.264 encoder on the server and a H.264 decoder on the client. On the client, follow the instructions here:

On the server, you will need to build and install the libx264 libraries which contain our optimizations and necessary modifications. This version includes changes for retrieving information about the quantizer used to encode frames. Such changes take advantage of all the encoding functionalities at their best and improve perfomance.

Download the libraries here:


At present, the H.264 codec cannot be used for virtual desktop sessions in running in lightweight mode.


- Ensure that you have an assembler installed like Yasm.

- To keep the best performances, we suggest to avoid compiling x264 with --disable-asm options.

- If you are compiling on Windows, be sure that your Cygwin environment matches these requirements:

1. Use Cygwin 32-bit (suggested version, tested with the procedure provided by this article is 1.7.25).

2. Install under the Cygwin compilation environment: gcc, mingw32, make and pkg-config (you just need to select such packages  in the Cygwin Setup and install them).


Download the latest libx264 from the NoMachine Web site:


Extract the archive.


Move to the x264 directory, run './configure' with options  listed below and  'make':

     * --disable-cli
     * --enable-shared
     * --disable-avs
     * --disable-swscale
     * --disable-lavf
     * --disable-ffms
     * --disable-gpac
     * --cross-prefix=i686-pc-mingw32- (for Windows only)
     * --enable-win32thread            (for Windows only)

     * --libdir=NX_INSTALLATION_DIR/lib

     * --libdir=NX_INSTALLATION_DIR/bin

     * --libdir=NX_INSTALLATION_DIR/Contents/Frameworks/lib

The --libdir option specifies where the x264 library will be installed. NX_INSTALLATION_DIR is path to the NoMachine installation directory, e.g. on Linux it's by default /usr/NX.

For example, to compile on Linux:

    ~: ./configure --disable-cli --enable-shared --disable-avs --disable-swscale --disable-lavf --disable-ffms --disable-gpac --libdir=/usr/NX/lib

    ~: make


When build completed successfully, install the x264 libraries by running 'make install'. This requires administrator privileges.

For example:

    ~: sudo make install


Verify that the x264 shared library has been copied into the installation directory provided with the --libdir configure option. Verify also that the library name is the same as below.

You should have the following:

On  Linux


On Windows


On  Mac OS X


Finally, ensure that ownership and permissions of libx264 are the same as for the other libraries used by NoMachine.