##
Notable Options and Caveats

These procedures and the CINELERRA-GG Infinity software have all been run as root on various home laptops and desktops. This provides the best chance to ensure all works correctly and also allows for handling errors, other problems and potential crashes with the most success. Included in this section are some of the build variations easily available for normal builds.

You can, during compilation, use a patch that changes the main non-standard shortcuts of CINELERRA-GG to standard ones (Ctrl+S and J, K, L, etc.). A table showing the changes from CINELERRA-GG mode to standard mode can be found here: Alternative Shortcuts. The instructions for the build with the patch are as follows. After downloading the sources from the git repository in the usual way, you apply the patch:

    	cd cinelerra-5.1
    	patch -p1 -i alt_shortcuts.patch
    	./bld.sh

To see the full list of features use:

    ./configure --help

The default build is a system build which uses:

    ./configure --without-single-user

In the single-user build , the target directory is always cin. Because this is also the developer build, constant names are used throughout. However, you can rename files after the install is complete.

If your operating system has issues with the default install to /usr/local, you might have to change the location to /usr for a system build. Then you will have to use:

    ./configure --prefix=/usr

If you wish to change the default directory for a system build you will have to add the destination directory path on the make install line. For example:

    make install DESTDIR=<your selected target directory path>

The application name can be set during installation, but defaults to cin so that the GG/Infinity build can coexist with other CINELERRA-GG builds if necessary. To override the default cin name, use:

    ./configure --with-exec-name=cinelerra

The home configuration directory can also be set, but default location is traditionally $HOME/.bcast5. For example:

    ./configure -with-config-dir=/myusername/.bcast5

NOTE: when you specify parameters to the configure program, it will create a make file as a consequence. Since in a make file, the $ is a special character, it must be escaped so in order to represent a $ as part of an input parameter, it has to be stuttered. That is, you will need $$ (2 dollar signs) to represent a single dollar sign.

It may be necessary on some distros which have missing or incomplete up-to-date libraries, to build CINELERRA-GG without Ladspa. To do so, use:

    ./configure --prefix=/usr --without-ladspa-build

Note that the with-ladspa-dir is the ladspa search path, and exists even if the ladspa build is not selected. This gives you the ability to specify an alternate ladspa system path by utilizing the LADSPA_PATH environment variable (that is, the default ladspa build is deselected).

Note for 32-bit 14.2 Slackware, Debian, Gentoo, Arch, FreeBSD, before running the configure, you will need to set up the following:

    export ac_cv_header_xmmintrin_h=no
    export FFMPEG_EXTRA_CFG=" --disable-vdpau"

Note for building 32-bit packages on hybrid 32/64 x86 systems, you may need to add the following:

    setarch i686  (befire configure and package build)

NOTE: as of May 31, 2021 when Context Help was added, to include this Context Help you will need to download the corresponding tgz file containing the HTML manual sections referenced for the Help pages. The file to download is: `https://cinelerra-gg.org/download/images/HTML_Manual-20220131.tgz`substituting for "20220131" the "yyyymmdd" representing latest release date. Then unpack to your Cinelerra/bin/doc directory so it is included in your built system. The reason for not including the HTML manual in the source code so that it would already be there, is because it is very large and has its own GIT base.