Kdenlive/Development: Difference between revisions

From KDE Community Wiki
m (→‎Selecting the branch: update to 18.08)
(Removed Telegram info and link)
 
(67 intermediate revisions by 9 users not shown)
Line 1: Line 1:
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_Mailing_List| Developper's mailing list]].
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_Mailing_List| Developer's mailing list]] or the [https://webchat.kde.org/#/room/#kdenlive-dev:kde.org Developers' Matrix room].


== Pre-requisites and Supported Platforms ==
== Building Instructions ==


Kdenlive is primarely developped on GNU/Linux. There is an effort to  [[Kdenlive/Development/WindowsBuild|build Kdenlive on Microsoft Windows]], but it's still a work in progress.
The building instructions have been moved to the [https://invent.kde.org/multimedia/kdenlive/-/blob/master/dev-docs/build.md dev-docs folder in the code tree].


Supported distributions are :
(the rest of this page should follow)  
 
* Ubuntu 18.04 LTS Bionic Beaver (and derivatives)
* Arch Linux
 
Current development code (2018) requires '''Qt >= 5.7''' , KF5, and '''MLT >= 6.6.0''', which are provided as package by the supported platforms. Any distribution that provides these dependencies should be a good start.
 
If your distro does not provide a recent MLT, you will need to compile it by yourself, see [[Kdenlive/Development/KF5|Kdenlive KF5 development page]].
It is recommended to uninstall the official kdenlive package since our version will replace it.
 
<pre>
sudo apt-get remove kdenlive kdenlive-data
</pre>
 
== Installing dependencies ==
 
=== Development tooling ===
 
You will need classical development tools (like git, gcc ...) but also cmake :
<pre>
sudo apt install build-essential git cmake extra-cmake-modules libsm-dev
</pre>
 
=== KDE Frameworks 5, based on Qt5 ===
 
On Ubuntu the following packages will pull all the necessary dependencies:
 
<pre>
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 \
libkf5iconthemes-dev kdoctools-dev libkf5crash-dev libkf5filemetadata-dev  kio \
kinit kde-runtime qtdeclarative5-dev libqt5svg5-dev qml-module-qtquick-controls
</pre>
 
<div style="background:#F5F5DC">Note: on slightly older Ubuntu (<= Xenial), the libkf5kio-dev package is called kio-dev</div>
 
=== Multimedia stack ===
 
You will also need MLT >= 6.6.0, ffmpeg and frei0r plug-ins
 
<pre>
sudo apt install libmlt++-dev libmlt-dev melt frei0r-plugins ffmpeg
</pre>
 
=== Dependencies for localisation  ===
 
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:
<pre>
sudo apt install ruby subversion gnupg2 gettext
</pre>
 
== Getting the source code ==
 
=== Cloning the git  repo ===
The easiest  way to get Kdenlive source code is to clone the git repo:
 
<pre>
git clone git://anongit.kde.org/kdenlive.git
</pre>
 
=== Selecting the  branch ===
 
It is important to understand that there is currently two main branches in Kdenlive code base:
 
* The  "refactoring_timeline" branch, which is where happens most of the development effort. The code base has undergone a massive cleanup and it should be much more fun to hack on. This is the one to choose by default.
* The stable branch, "Applications/18.08", which is mostly in maintenance mode: it should be of interest to you if you want to fix a small specific bug.
 
<pre>
cd kdenlive
git checkout refactoring_timeline
</pre>
 
or
 
<pre>
cd kdenlive
git checkout Applications/18.08
</pre>
 
==  Building Kdenlive ==
Create a directory for the build :
 
<pre>
mkdir build
cd build
</pre>
 
To avoid problems with plugins and libraries, it is easier to install Kdenlive in /usr:
 
<pre>
cmake .. -DKDE_INSTALL_USE_QT_SYS_PATHS=ON -DCMAKE_INSTALL_PREFIX=/usr
</pre>
 
To fetch the translations of the application :
<pre>
make fetch-translations
</pre>
 
This should create a po sub-directory in your build directory. You have then to create a symbolic link to this po sub directory :
 
<pre>
cd ..
ln -s build/po/ po
cd build/
</pre>
 
Then build and install:
<pre>
make -j5
sudo make install
</pre>
 
You can then start your compiled version by simple entering:
<pre>
kdenlive
</pre>


== Next Steps ==
== Next Steps ==
Once you've got a working dev environment, you should checkout the [https://invent.kde.org/multimedia/kdenlive/-/blob/master/dev-docs/contributing.md Contributing Guide] and [https://invent.kde.org/multimedia/kdenlive/-/blob/master/dev-docs/coding.md Coding Guide].


Now that you've got a working dev environment, you can head to [[https://phabricator.kde.org/project/profile/40/ Kdenlive's page on KDE's phabricator]]
Now you can [https://invent.kde.org/multimedia/kdenlive/-/issues/?sort=created_date&state=opened&label_name%5B%5D=Welcome%20tasks&first_page_size=20 find some nice first issues to solve]. Welcome on board!


You can also get some general info on the TechBase tutorial [https://techbase.kde.org/Development/Tutorials/Building_An_Existing_Application Building An Existing Application]. You may also be interested in the other [https://techbase.kde.org/Development/Tutorials tutorials on TechBase].
A instruction of the workflow with KDE's GitLab can be found [[Infrastructure/GitLab|here]]. You can also gain more general knowledge by [https://techbase.kde.org/Development/Tutorials exploring the tutorials on TechBase].
 
== IDE Setup ==
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.


== MLT documentation ==
== MLT documentation ==
Line 155: Line 25:
     strace build/src/kdenlive 2>&1 | grep kdenliveui.rc
     strace build/src/kdenlive 2>&1 | grep kdenliveui.rc


== Kdenlives File Format ==
A description on Kdenlives file format can be found [https://invent.kde.org/multimedia/kdenlive/-/blob/master/dev-docs/fileformat.md here].


== Developer Mailing List ==
== Contact ==
The kdenlive developer mailing list archives can be found [http://mail.kde.org/pipermail/kdenlive/ here]
 
A searchable archive of the kdenlive developer mailing list can be found [http://www.mail-archive.com/[email protected]/ here]


Information on how to subscribe can be found [https://mail.kde.org/mailman/listinfo/kdenlive here]
See [[Kdenlive#Contact|Contact]]

Latest revision as of 15:56, 22 August 2023

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 or the Developers' Matrix room.

Building Instructions

The building instructions have been moved to the dev-docs folder in the code tree.

(the rest of this page should follow)

Next Steps

Once you've got a working dev environment, you should checkout the Contributing Guide and Coding Guide.

Now you can find some nice first issues to solve. Welcome on board!

A instruction of the workflow with KDE's GitLab can be found here. You can also gain more general knowledge by exploring the tutorials on TechBase.

MLT documentation

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 mlt++/MltConsumer.cpp:position().

Environment variables

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 $KDEDIRS:/usr/local.

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

Kdenlives File Format

A description on Kdenlives file format can be found here.

Contact

See Contact