\item The \textit{git:} step has to download many files (approx 130\,MB) so allow time. When decompressed this will expand to about 530 MB.
\item Run the following commands (this takes awhile):
- \begin{lstlisting}[language=bash,numbers=none]
+ \begin{lstlisting}[numbers=none]
$ cd /<build_path>/ # this is where you need the 6.0GB of disk space
$ git clone --depth 1 "git://git.cinelerra-gg.org/goodguy/cinelerra.git" cinelerra5
$ cd cinelerra5/cinelerra-5.1 # toplevel directory
NOTE: if your system has never had Cinelerra-GG Infinity installed, you will have to make sure you have all of the compilers and libraries necessary.
So on the very first build you should run:
- \begin{lstlisting}[language=bash,numbers=none]
+ \begin{lstlisting}[numbers=none]
$ ./blds/bld_prepare.sh <os> # where <os> represents the Operating System of centos, fedora, suse, ubuntu, mint, debian.
$ ./autogen.sh
$ ./configure --prefix=/usr # optional parameters can be added here
\url{https://cinelerra-gg.org/download/README.gentoo}}
\item Check for obvious build errors:
- \begin{lstlisting}[language=bash,numbers=none]
+ \begin{lstlisting}[numbers=none]
$ grep "\*\*\*.*error" -ai log
\end{lstlisting}
If this reports errors and you need assistance or you think improvements can be made to the builds,
email the log which is listed below to: \href{mailto:cin@lists.cinelerra-gg.org}{cin@lists.cinelerra-gg.org}
- \begin{lstlisting}[language=bash,numbers=none]
+ \begin{lstlisting}[numbers=none]
$ /<build_path>/cinelerra5/cinelerra-5.1/log
\end{lstlisting}
\item If there are no build errors, finally just run:
- \begin{lstlisting}[language=bash,numbers=none]
- $ make install
+ \begin{lstlisting}[numbers=none]
+ $ make install
\end{lstlisting}
\item If it all worked, you are all setup. Just click on the Cinelerra desktop icon.
\end{enumerate}
\item Recommend you build and run as \textbf{root}, just to avoid permission issues initially.
\item The \textit{git} step has to download many files (approx 130\,MB) so allow time.
\item Run the following commands (this takes awhile):
- \begin{lstlisting}[language=bash,numbers=none]
+ \begin{lstlisting}[numbers=none]
$ cd /<build_path>/ # this is where you need the 6GB of disk space
$ git clone --depth 1 "git://git.cinelerra-gg.org/goodguy/cinelerra.git" cinelerra5
$ cd cinelerra5/cinelerra-5.1 # toplevel directory
NOTE: if your system has never had Cinelerra-GG Infinity installed, you will have to make sure all
the compilers and libraries necessary are installed. So on the very first build you should run as \textbf{root}:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ ./blds/bld_prepare.sh <os> # where <os> represents the Operating System of centos, fedora, suse, ubuntu, mint, debian.
$ ./autogen.sh
-$ ./configure --with-single-user # the “with-single-user” parameter makes it so
+$ ./configure --with-single-user # the "with-single-user" parameter makes it so
$ make 2>&1 | tee log # make and log build (check for errors before proceeding)
$ make install
\end{lstlisting}
using the appropriate directory to copy the files to, run as \textbf{root}, and edit to correct
the directory path. Below are generic directions of how to do this.
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ cd /cinelerra_directory_path
$ cp -a image/cin.{svg,xpm} /usr/share/pixmaps/.
$ cp -a image/cin.desktop /usr/share/applications/cin.desktop
To see the full list of features use:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ ./configure -help
\end{lstlisting}
The default build is a system build which uses:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ ./configure -without-single-user
\end{lstlisting}
However, you can rename files after the install is complete.
If your operating system has issues with the default install to \texttt{/usr/local}, you might have to change the location to \texttt{/usr} for a system build. Then you will have to use:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ ./configure --prefix=/usr
\end{lstlisting}
If you wish to change the default directory for a system build you will have to add the destination directory path on the \texttt{make install} line. For example:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ make install DESTDIR=<your selected target directory path>
\end{lstlisting}
The application name can be set during installation, but defaults to \texttt{cin} so that the GG/Infinity build can coexist with other Cinelerra builds if necessary. To override the default \texttt{cin} name, use:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ ./configure --with-exec-name=cinelerra
\end{lstlisting}
The home configuration directory can also be set, but default location is \texttt{\$HOME/.bcast5}.
For example:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ ./configure -with-config-dir=/myusername/.bcast5
\end{lstlisting}
It may be necessary on some distros which have missing or incomplete up-to-date libraries, to build Cinelerra without Ladspa.
To do so, use:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ ./configure --prefix=/usr --without-ladspa-build
\end{lstlisting}
Note for 32-bit 14.2 Slackware, Debian, Gentoo, Arch, FreeBSD, before running the configure, you will need to set up the following:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ export ac_cv_header_xmmintrin_h=no
$ export FFMPEG_EXTRA_CFG=" --disable-vdpau"
\end{lstlisting}
An example of a problem you might encounter with your customized installation is with \texttt{a52dec} which has probes line \texttt{(CHECK\_LIB/CHECK\_HEADERS)} in \texttt{configure.ac}, but \texttt{djbfft} does not.
In this case, \texttt{djbfft} is only built because \texttt{a52dec} is built, so if your system has \texttt{a52dec}, set \texttt{a52dec} to auto and see if that problem is solved by retrying the build with:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ ./confgure --with-single-user -enable-a52dec=auto .
\end{lstlisting}
If you have already installed the \texttt{libfdk\_aac} development package on your computer because you prefer this version over the default aac, you will have to do the following to get this alternative operational. The libfdk\_aac library is not a part of Cinelerra by default because it is not license free.
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ export FFMPEG_EXTRA_CFG=" --enable-libfdk-aac --enable-nonfree"
$ export EXTRA_LIBS=" -lfdk-aac"
$ for f in `grep -lw aac cinelerra-5.1/ffmpeg/audio/*`; do
\label{par:update_an_existing_repo}
The below shows how you can get updates.
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ cd /<repo home>/cin5
$ git pull
\end{lstlisting}
\label{par:useful_git_commands}
Some other commands that are useful.
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ git clone "git://git.cinelerra-gg.org/goodguy/cinelerra.git" cin5
$ git pull # pull remote changes to the local version
$ git status # shows changed files
\label{sub:how_to_build_from_a_previous_git_version}
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ cd /<path>/cin5_repo
$ git log
$ git checkout <version>
Then, to run as a developer in the debugger:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ CFLAGS="-O2 -ggdb" make -j8 rebuild_all
$ cd cinelerra
$ gdb ./ci
\section{Download Already Built Cinelerra-GG}%
\label{sec:download_already_built_cinelerra_gg}
+\begin{figure}[htpb]
+ \centering
+ \includegraphics[width=1.0\linewidth]{images/download-distros.png}
+ \caption{Screencast of the website Download page for installing Cinelerra for various O/S.}
+ \label{fig:download-distros}
+\end{figure}
+
If you prefer to not have to take the time to build Cinelerra-GG Infinity yourself, there are pre-built dynamic or static binaries for various versions of Ubuntu, Mint, Suse, Fedora, Debian, Centos, Arch, and Slackware linux as well as Gentoo and FreeBSD.
A Windows 10 version installation is described in \ref{sec:ms_windows10}.
There are also 32-bit i686 Ubuntu, Debian, and Slackware versions available.
have to install another library that is being called for.
To install the single user builds, download the designated tarball from the \texttt{./tars} subdirectory and unpack as indicated below:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ cd /path
$ mkdir cin
$ cd cin
\item Download the tar file at:\\
{\small \url{https://cinelerra-gg.org/download/testing/libxcb-bld.tar.bz2}}
\item Install libxbc from the tar file -- installs into \texttt{/usr/local} and requires approximately 21MB storage.
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ tar -C /usr/local -xJf /path/libxcb-bld.tar.bz2
\end{lstlisting}
The libxcb path repairs an error (XIOError), which stops Cinelerra.
\item Download the tar file at:\\
{\small \url{https://cinelerra-gg.org/download/testing/cygcin-bld.tar.bz2}}
\item Install cygcin from the tar file - this installs into home directory. Note this is cygcin NOT cygwin. You must change the \texttt{path} below to the name of the path where you downloaded the tar file.
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ cd
$ tar -xJf /path/cygcin-bld.tar.bz2
\end{lstlisting}
$ export DISPLAY=:0.0
\end{lstlisting}
\item Change directories to where Cinelerra is installed:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ cd /path/cygcin (NOT cygwin)
\end{lstlisting}
\item Finally keyin:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ ./cin
\end{lstlisting}
which starts up your 4 Cinelerra windows.
\item Download and install ffmpeg into /usr/local :
download ffmpeg (currently 4.2.2)
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ cd /tmp
$ tar -xJf /path/ffmpeg-4.2.2.tar.bz2
$ cd ffmpeg-4.2.2
$ make install
\end{lstlisting}
\item Download and install a patched libxcb:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ cd /tmp
$ rm -rf libxcb-1.13/
$ tar -xf /path/libxcb-1.13.tar.bz2
$ make install
\end{lstlisting}
\item Download cinelerra-gg:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ cd /build_path/
$ git clone "git://git.cinelerra-gg.org/goodguy/cinelerra.git"
$ cd cinelerra-gg/cinelerra-5.1
\end{lstlisting}
\item Apply cygwin patch:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ patch -p2 < blds/cygwin.patch
\end{lstlisting}
\item Run the build with:
-\begin{lstlisting}[language=bash,numbers=none]
+\begin{lstlisting}[numbers=none]
$ ./blds/cygwin.bld
\end{lstlisting}
\end{enumerate}