# Kdenlive/Getting and installing

Kdenlive should compile on most recent GNU/Linux and FreeBSD systems, including x86 and AMD64 architectures. Also, it is already compiled and ready to install in binary packages for a number of distros.
The current version (0.7) of Kdenlive is a KDE4 program. This means that you will need some KDE4 support on your system to compile or use Kdenlive. But, you do not need to actually run KDE4 for this. You can build/install and run under KDE3, GNOME, and other desktop environments. This is similar to running KDE3 apps from GNOME, or GNOME apps from KDE.

# Installing .75

General
Put video here.

## Installing from SVN

More information? Instructions? Video?

# Installing Kdenlive 0.7 (KDE4) from source

Please follow the instructions on http://www.kdenlive.org/compile

## Fedora 11

Long story short, it took quite a bit of energy and time and expertise to get Kdenlive installed.
* video I
* video II
* video III
* video IV

## Fedora 10 (Cambridge) x86_64

Please see Developer section ( or maybe I am supposed to put building stuff here?). /*Istalling Kdenlive 0.7 (KDE4)from source*/

# Installing Kdenlive 0.7 (KDE4) binary packages

Many distros already offer Kdenlive for easy installation. Check http://www.kdenlive.org/content/2008-09-26-download-kdenlive

## Gentoo

Gentoo offers ebuilds for kdenlive 0.7. You'll need a basic install of KDE 4, then
and you're done.
If you're running only KDE 3.5, you'll have to use kdenlive-0.5 or install from sources: svn revision 1825 is reported to work decently (see below).

# Compiling libraries

Warning : for Kdenlive for KDE4 version, please read : http://en.wikibooks.org/wiki/Kdenlive/KDE4_Porting

## Installing from SVN

Make sure you install all listed libraries before attempting to compile Kdenlive!!! Install libraries in the order listed on that page. Most libraries and header files should be packaged in your GNU/Linux distribution. Just install the requested packages:
* QT and KDE development files (KDE >= 3.4 required)
Provided with most distributions (usually named qt-devel and kdelibs-devel. For Debian users, see debian-desktop.org for a recent KDE environment).
* SDL
Provided with most distributions. Install the devel package: SDL-dev and SDL-image-dev.
* Audio / video and other libraries (you should be able to find binary packages for all of them in your distro):
** Gdk-Pixbuf (gdk-pixbuf, gdk-pixbuf-dev) (not needed anymore)
** libsamplerate (libsamplerate, libsamplerate-dev)
** OGG (libogg, libogg-dev)
** Vorbis (libvorbis, libvorbis-dev)
** libdv (libdv, libdv-dev)
** Ladspa (ladspa-sdk)
** libJack (libjack-dev)
** Ladspa plugins (swh-plugins)
** SOX (sox, sox-dev)
** libXML2 (libxml2, libxml2-dev)
** libmad (libmad-dev)
* Optional:
** Libquicktime (libquicktime, libquicktime-dev)
** Theora (libtheora, libtheora-dev)
* FFmpeg (libavformat development files, recent version + libswscale, libswscale-dev):
If you cannot find a recent package for libavformat-dev or libswcale-dev (hint: for Ubuntu try http://ubuntu.tonio.homelinux.org), download the development svn version:
FFmpeg recommended config option:
(update 4.4.2008 by espinosa_cz: in recent FFmpeg from SVN names of some parameters changed use --enable-postproc --enable-swscale instead of --enable-pp --enable-swscaler)
For (K)Ubuntu 7.10 (Gutsy) :
You can install all needed packages for the SVN building by installing (sudo apt-get install or from Synaptic) the following packages:
** NOTE this may install the KDE Desktop onto Ubuntu! That's a lot of sweet software!
** NOTE2 this list is growing; if you're aware of something that can be removed, please do!
** NOTE3 I've cleaned the list and, in case of doubt, I've mention it but keep the file just in case. If somebody can test and clean even more this will be appreciated (herrej01)
The following libs will be needed depending on the type of file you want to render
I think the following libs are not needed assuming you've already installed dvgrab
And finally, following libs are not needed if you are going to install FFmpeg, MLT and MLT++ from source
* MLT (version 0.2.4 or greater):
MLT 0.2.4 stable release is required for Kdenlive 0.5.
You can install MLT 0.2.4 or checkout MLT from SVN:
Recommended config option for MLT:
All other MLT configure options are enabled by default.
You might need --avformat-ldextra if your FFmpeg/libavcodec is built against some external libs like libmp3lame or libvorbis. My ld.so does not require this, but it seems some systems/environments require it.
NOTE 1:Make sure that the configure output gives no error for modules/avformat, since it means FFmpeg was not correctly installed. Make sure swh-plugins and ladspa-sdk packages are installed. These packages provide sound effects. MLT has many dependencies, but you will be warned at ./configure time
NOTE 2: When you are on (K)Ubuntu and the ./configure... step ends in errors like: ./configure: 37: function: not found ./configure: 93: function: not found ./configure: 174: build_config: not found ... ./configure: 191: build_pkgconfig: not found
Either edit the ./configure file and replace on the first line "#!/bin/sh" to "#!/bin/bash" and run again, or simply type: bash ./configure ..... This problem is caused due to the fact that (K)Ubuntu Edgy defaults to the dash shell instead of the bash shell. Dash is currently known for being less compatible with scripting.
* MLT++ (version 0.2.2 or greater)
Checkout MLT++ from SVN:

## Debian Unstable

Debian binary packages are provided by Christian Marillat. Packages include the latest FFmpeg developments are usually very well up-to-date. For example, MLT includes Kdenlive module and avformat-swscale.
Add the following line to your /etc/apt/sources.list file:
If you haven't done so yet, import Marillat's key:
Then, simply type sudo apt-get build-dep kdenlive
Although as of March 2010, on some Debian systems, even after running apt-get update, you will still be told "E: Unable to find a source package for kdenlive". It seems that the structure of these file sites have changed greatly since this document was written.
When compiling Kdenlive 0.5 svn from source, you will also need: sudo apt-get install mlt libmlt0.2.3 libmlt-dev libmlt++0.2.3 libmlt++-dev

## Debian Unstable & SVN Kdenlive 0.6

Make sure to have the above repositories available
sudo apt-get build-dep kdenlive mlt mlt++ ffmpeg
sudo apt-get install kde-devel qt4-dev-tools kdelibs4-dev libsdl1.2-dev libsdl-image1.2-dev libgdk-pixbuf-dev libsamplerate0 libsamplerate0-dev ladspa-sdk libjack-dev swh-plugins sox libsox-dev libxml2-dev libmad0-dev libcgicc5-dev checkinstall build-essential subversion python2.4 libx264-dev cmake libgsm1-dev autotools-dev g++ autoconf automake1.9 xdialog ccache debhelper html2text libsndfile1-dev intltool-debian po-debconf libsmpeg-dev libquicktime-dev libogg-dev libvorbis-dev libdv4-dev liblame-dev libfaad-dev libfaac-dev libxvidcore4-dev liba52-0.7.4 liba52-0.7.4-dev libavformat-dev
Then use the Easy Script Installer v3.1 available in the Forums

## Red Hat Enterprise

* *NOTE* This only lets me compile so far. Upon running, I get a crash. Hopefully, you will get further than I did. This may be a red herring but in the past I've seen issues with Red Hat and threaded libraries.
* Backtrace:
* Error:
* You can yum install all of the libraries listed above, but names may have changed slightly. I use dag's repository
* You'll have to download and compile MLT and MLT++
* MLT:
* MLT++: didn't have any problems with standard configure/make/make install
* unsermake
* once you've installed MLT, MLT++, and unsermake, you can "make" inside kdenlive directory

# Compiling Kdenlive

Checkout Kdenlive from SVN:
NOTE: Once you have downloaded the complete SVN package, you can update your local SVN source by only downloading the updated parts. Say you have downloaded the SVN into ~/kdenlive. Simply cd into ~/kdenlive and type: svn update.
Configure Kdenlive, compile and install (NOTE: This is for the SVN version only. If you have downloaded a release version, follow the instructions in kdenlive/INSTALL).:
Be aware of the dot (.) after cmake command. It's important!
You are now ready to use Kdenlive. Have fun!

# Compiling Kdenlive & FFmpeg & MLT together - the easy way

The best option for testers is to get updated SVN versions of FFmpeg and MLT libs when updating Kdenlive. Because it is not a simple task, I have created a simple Bash script to do the reparative and tricky business for you.
Download the updated version of the builder script from the forum:
* kdenlive_builder script version 3.1
Download it, save it in your root source directory (/home/espinosa/src in my case), name it kdenlive_builder.sh (preferably), in console change directory to you root source directory and use :
An XDialog box will appear.
Choose the first option (GET) to make clean previous installations and get new sources from SVN. Program will ask where do you want to place the sources.
Choose the second option (INSTALL) to compile and install your previously downloaded sources. You'll be prompted where do you want to install the programs. If you choose in /usr, a warning message will appear and you'll be requested during installation to give your root password. This will not happen if you choose another directory in your /home path. With this option, you can select also if you want support for some audio/video types. Be sure to have necessary libs installed if you choose any of these options.
Choose the third option (FULL) to do both steps (GET & INSTALL) together.
Choose the fourth option (INFO) to obtain information about currently downloaded SVN versions.
Then run Kdenlive from the chosen destination directory.
This script is especially useful for testers as it supports multiple versions installed in any directory (home, opt, or local) including multiple FFmpeg and MLT. Plus, this is the way to get the right set of up-to-date main libraries, to avoid problems with outdated or failing distribution versions of MLT and FFmpeg.
If you experience an issue with the script check the forum board for discussion first.
There is also an alternative version of this script Kdenlive builder classic script which is a branch of the original non-GUI, non-interactive version. Use this variant if the former does not work for you, if you prefer true batch processing, if you expect reparative calling etc.
NOTE: the script does not provide any check of libraries or header files required by Kdenlive & FFmpeg & MLT, like SDL, liblame, libx264 etc. Read carefully the requirements section to have everything installed (all -dev packages)

# Compiling Kdenlive & FFmpeg & MLT together - the even easier way

I (Mads Bondo Dydensborg) have created a GUI Wizard, that can build the KDE4 (or KDE3) version of Kdenlive from current development sources. It is available from and is suited both for one-shot builds, or automated nightly builds (the latter requires obtaining the sources, available from the page).