Kdenlive is rather easy to build (at least on supported platforms), and this page should show you the simple steps to get there. If you encounter any problem during the process or spot any information that should be added/updated, please don't hesitate to reach out to the Developer's mailing list.
- 1 Pre-requisites and Supported Platforms
- 2 Installing dependencies
- 3 Getting the source code
- 4 Building Kdenlive
- 5 Next Steps
- 6 IDE Setup
- 7 MLT documentation
- 8 Environment variables
- 9 Contact
Pre-requisites and Supported Platforms
Kdenlive is primarily developed on GNU/Linux. There is an effort to build Kdenlive on Microsoft Windows, but it's still a work in progress.
/!\ The doc needs to be updated as the kdenlive/mlt has been removed. /!\
Supported distributions are :
- Ubuntu 18.10 Cosmic Cuttlefish and derivatives
- Arch Linux
Current development code (2018) requires Qt >= 5.7 , KF5 >= 5.50 -- which are provided as package by the supported platforms --. but also MLT >= 6.18.0, which is not available for Ubuntu 18.04 in default repositories: you'll have to get it from Kdenlive's ppa:
sudo add-apt-repository ppa:kdenlive/mlt sudo apt-get update
It is recommended to uninstall the official kdenlive package since our version will replace it.
sudo apt-get remove kdenlive kdenlive-data
You will need classical development tools (like git, gcc ...) but also cmake :
sudo apt install build-essential git cmake extra-cmake-modules libsm-dev
KDE Frameworks 5, based on Qt5
On Ubuntu the following packages will pull all the necessary dependencies:
sudo apt install libkf5archive-dev libkf5bookmarks-dev libkf5coreaddons-dev libkf5config-dev \ libkf5configwidgets-dev libkf5dbusaddons-dev libkf5kio-dev libkf5widgetsaddons-dev \ libkf5notifyconfig-dev libkf5newstuff-dev libkf5xmlgui-dev libkf5declarative-dev \ libkf5notifications-dev libkf5guiaddons-dev libkf5textwidgets-dev libkf5purpose-dev \ libkf5iconthemes-dev kdoctools-dev libkf5crash-dev libkf5filemetadata-dev kio \ kinit kde-runtime qtdeclarative5-dev libqt5svg5-dev qml-module-qtquick-controls \ qtmultimedia5-dev
If your distribution packages a recent enough version of MLT (>= 6.10.0), you can install it directly along with ffmpeg and frei0r plug-ins. Otherwise, you'll have to add our ppa or compile it yourself (see above)
sudo apt install libmlt++-dev libmlt-dev melt frei0r-plugins ffmpeg
Dependencies for localization
To have kdenlive localised in a different language than EN, you should install the additional dependencies that are required by the specific script to fetch the translations:
sudo apt install ruby subversion gnupg2 gettext
Getting the source code
Cloning the git repo
The easiest way to get Kdenlive source code is to clone the git repo:
git clone [email protected]:kde/kdenlive.git
Selecting the branch
/!\ More guidance about which branch to choose should be inserted here...
cd kdenlive git checkout master
cd kdenlive git checkout Applications/19.08
Create a directory for the build :
mkdir build cd build
To avoid problems with plugins and libraries, it is easier to install Kdenlive in /usr:
cmake .. -DKDE_INSTALL_USE_QT_SYS_PATHS=ON -DCMAKE_INSTALL_PREFIX=/usr -DRELEASE_BUILD=OFF
Alternately you can build it with debug flags (advanced users only ;-) and you need to have clang installed ) :
cmake .. -DKDE_INSTALL_USE_QT_SYS_PATHS=ON \ -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug \ -DCMAKE_CXX_COMPILER=/usr/bin/clang++ \ -DECM_ENABLE_SANITIZERS='address' \ -DBUILD_TESTING=ON -DBUILD_FUZZING=ON -DBUILD_COVERAGE=OFF \ -DRELEASE_BUILD=OFF
To fetch the translations of the application :
This should create a po sub-directory in your build directory. You have then to create a symbolic link to this po subdirectory :
cd .. ln -s build/po/ po cd build/
Then build and install:
make -j5 sudo make install
You can then start your compiled version by simply entering:
If you have compiled it in debug mode, you may encounter errors like
SUMMARY: AddressSanitizer: new-delete-type-mismatch (/usr/bin/kdenlive+0x643020) ==6982==HINT: if you don't care about these errors you may set ASAN_OPTIONS=new_delete_type_mismatch=0 ==6982==ABORTING
As the hint says, the you can solve this with
Now that you've got a working dev environment, you can head to [Kdenlive's page on KDE's phabricator]
Pick your favourite!
Setting up KDevelop
Open KDevelop and go to Project > Open/Import project Then select the CMakeLists.txt file in the kdenlive source folder. You can now start hacking on Kdenlive!
Setting up QtCreator
After checking out Kdenlive from git—when working on refactoring, you may want to clone two copies, one with the next branch and another one on the refactoring branch—, you can open the CMakeLists.txt in QtCreator, which will load the project if cmake succeeds. If you run/debug Kdenlive, make sure that kdenlive and not kdenlive_render is selected as an active project.
If you let QtCreator restore the previous session (File > Session manager), it will remember the open documents. Environment variables (see below) can be set in Projects > Build Environment.
Kdenlive uses MLT’s C++ API called mlt++. This API is not documented as it is simply a wrapper to C functions. For example, the documentation of
Mlt::Consumer::position() can be found in
framework/mlt_consumer.c:mlt_consumer_position(). The actual C function name is usually a combination of the class name and the function name, but can also be found by consulting
If kdenlive crashes on startup (e.g. in QtCreator) and shows a message like:
kdenlive(24309) KXMLGUIClient::setXMLFile: cannot find .rc file "kdenliveui.rc" for component "kdenlive"
then you have to ensure the .rc file is found. If CMake is configured to install Kdenlive to /usr/local, the .rc file is put there, but when kdenlive is then run from the build directory, the KXMLGUIClient will not search there. Solution: Set the environment variable KDEDIRS to
You can get more information about the paths that are checked by running kdenlive like this:
strace build/src/kdenlive 2>&1 | grep kdenliveui.rc
The kdenlive developer mailing list archives can be found here
A searchable archive of the kdenlive developer mailing list can be found here
Information on how to subscribe can be found here