Difference between revisions of "Kdenlive/Manual/Installation"

Jump to: navigation, search
(Marked this version for translation)
(Removed some older information & fixed some links (more to come))
Line 10: Line 10:
  
 
<!--T:27-->
 
<!--T:27-->
[http://www.kdenlive.org/downloading-and-installing-kdenlive This] page at the '''Kdenlive''' home has instructions on how to source these more recent versions, depending on which flavour of Linux you run.  Instructions for Debian, Fedora, Gentoo, OpenSUSE, Slackware and Ubuntu are available.
+
[http://www.kdenlive.org/download This] page at the '''Kdenlive''' home has instructions on how to source these more recent versions, depending on which flavour of Linux you run.  Instructions for Debian, Fedora, Gentoo, OpenSUSE, Slackware and Ubuntu are available.
  
  
Line 32: Line 32:
 
Version numbers of the KF5 flavour start at 15.04.0. <br />
 
Version numbers of the KF5 flavour start at 15.04.0. <br />
 
This author recommends using the  sunab ppa to install Kdenlive rather than the  Kubuntu-CI Team because the Kubuntu-CI Team PPA has many other packages in it which will attempt to uprade all sorts of things on your system&mdash;with the potential of breaking it.<br />
 
This author recommends using the  sunab ppa to install Kdenlive rather than the  Kubuntu-CI Team because the Kubuntu-CI Team PPA has many other packages in it which will attempt to uprade all sorts of things on your system&mdash;with the potential of breaking it.<br />
 
<!--T:53-->
 
The switch between 0.9.10 and 15.04.0 is quite major with respect to the development work required.  Testing of the new 15.04.0 version has been limited.  For critical work I would recommend '''not''' upgrading to 15.04.0 unless you have a good backout strategy. It seems that the standard 15.04 Ubuntu repositories have a version 0.9.10 of '''Kdenlive''' running against KDE Frameworks 4 so you might be able to back out from 15.04.x to  0.9.10 by purging the ppa version of '''Kdenlive''' and re-installing the one in the standard repos.
 
  
 
==== Debian ==== <!--T:4-->
 
==== Debian ==== <!--T:4-->
Line 42: Line 39:
  
 
<!--T:42-->
 
<!--T:42-->
Once your package management tool is pointed at an appropriate release, a simple <code>apt-get install kdenlive</code> should then work.
+
Once your package management tool is pointed at an appropriate release, a simple <code>apt install kdenlive</code> should then work.
  
 
<!--T:43-->
 
<!--T:43-->
Line 58: Line 55:
 
<!--T:69-->
 
<!--T:69-->
 
[https://launchpad.net/~kdenlive/+archive/ubuntu/kdenlive-stable ppa:kdenlive/kdenlive-stable] is the last robust official release
 
[https://launchpad.net/~kdenlive/+archive/ubuntu/kdenlive-stable ppa:kdenlive/kdenlive-stable] is the last robust official release
 
<!--T:36-->
 
Sunab offers a stable release of Kdenlive  (version 15.12.1 as at 2nd March 2016) from [https://launchpad.net/~sunab/+archive/kdenlive-release this] PPA.
 
 
<!--T:54-->
 
He maintains a ppa with the previous release  [https://launchpad.net/~sunab/+archive/ubuntu/kdenlive-release-old here]. As at June 2015 it has the ver 0.9.10 of '''Kdenlive''' , 1.4.0 of Frei0r and 0.9.3 of melt
 
 
 
  
 
<!--T:55-->
 
<!--T:55-->
Line 80: Line 69:
 
<!--T:57-->
 
<!--T:57-->
 
Non-Kubuntu users will need to install the kde-runtime package to fix missing buttons and icons.
 
Non-Kubuntu users will need to install the kde-runtime package to fix missing buttons and icons.
 
<!--T:45-->
 
Note that Sunab's PPA is built against the avconv multimedia libraries which Ubuntu/Lubuntu/Kubuntu et al. ship with. It is not built against the "alternative" ffmpeg multimedia libraries that other distros might have. So using this PPA for non-avconv-utilizing distributions might be problematic.  (Thanks  [http://blog.pkh.me/p/13-the-ffmpeg-libav-situation.html avconv/ffmpeg schism] !!!!).
 
  
 
==== Fedora, RedHat and derivatives ==== <!--T:8-->
 
==== Fedora, RedHat and derivatives ==== <!--T:8-->
Line 112: Line 98:
 
<!--T:23-->
 
<!--T:23-->
 
MacPorts is a source-based system &mdash; there is not a binary app bundle for '''Kdenlive'''. Therefore, '''Kdenlive''' and all of its numerous dependencies, including multimedia libraries, KDE, and Qt, must be compiled. This can take a long time and much disk space! Furthermore, it is not unusual for something not to build correctly; it is definitely not something for the novice, impatient, or "faint of heart".
 
MacPorts is a source-based system &mdash; there is not a binary app bundle for '''Kdenlive'''. Therefore, '''Kdenlive''' and all of its numerous dependencies, including multimedia libraries, KDE, and Qt, must be compiled. This can take a long time and much disk space! Furthermore, it is not unusual for something not to build correctly; it is definitely not something for the novice, impatient, or "faint of heart".
 
<!--T:24-->
 
For more details see [http://www.kdenlive.org/user-manual/downloading-and-installing-kdenlive/pre-compiled-packages/mac-os-x-packages-macports this].
 
  
 
<!--T:30-->
 
<!--T:30-->
Line 133: Line 116:
 
If you prefer you can build & install '''Kdenlive''' to a local area (preferably not <tt>/usr</tt>, but rather <tt>/usr/local</tt> or <tt>$HOME/my_local_builds/kdenlive-last-release</tt> or similar).
 
If you prefer you can build & install '''Kdenlive''' to a local area (preferably not <tt>/usr</tt>, but rather <tt>/usr/local</tt> or <tt>$HOME/my_local_builds/kdenlive-last-release</tt> or similar).
 
You could try using  [https://community.kde.org/Kdenlive/Development/KF5#A_build_script  this] build script to build the latest version from the sources. Or you could use the [http://www.mltframework.org/twiki/bin/view/MLT/BuildScripts#Kdenlive this] build script to build kdenlive ver 0.9.10 <ref>on distributions older than ''Debian 6'' or ''Ubuntu 10.04'' and derivatives, you need to set <code>ENABLE_SWFDEC=0</code> in the config variables of the script. Modify the INSTALL_DIR in the script to  something like <code>INSTALL_DIR="$HOME/my_local_builds/kdenlive-last-release"</code> to make it match where you want this local build to install. </ref> (Follow the instructions under "show kdenlive". These instructions will build '''Kdenlive''' and its dependancies [e.g. melt, ffmpeg] in a "sandbox").
 
You could try using  [https://community.kde.org/Kdenlive/Development/KF5#A_build_script  this] build script to build the latest version from the sources. Or you could use the [http://www.mltframework.org/twiki/bin/view/MLT/BuildScripts#Kdenlive this] build script to build kdenlive ver 0.9.10 <ref>on distributions older than ''Debian 6'' or ''Ubuntu 10.04'' and derivatives, you need to set <code>ENABLE_SWFDEC=0</code> in the config variables of the script. Modify the INSTALL_DIR in the script to  something like <code>INSTALL_DIR="$HOME/my_local_builds/kdenlive-last-release"</code> to make it match where you want this local build to install. </ref> (Follow the instructions under "show kdenlive". These instructions will build '''Kdenlive''' and its dependancies [e.g. melt, ffmpeg] in a "sandbox").
 
<!--T:58-->
 
<span id ="nstalling from Sunab's PPA"></span>
 
 
===Installing from Sunab's PPA === <!--T:28-->
 
Olivier Banus (AKA Sunab) provides a personal package archive (PPA) of the latest '''development''' trees of Frei0r-plugins, MLT and '''Kdenlive'''. For details on how to install '''Kdenlive''' using this bleeding edge source see [https://launchpad.net/~sunab/+archive/kdenlive-svn launchpad.net - kdenlive-git (unstable).Testing only! ]
 
 
<!--T:59-->
 
As of 2 Dec 2015 Sunab has included a build for Ubuntu 15.10&mdash;the wily werewolf.
 
 
<!--T:39-->
 
Note:  Sunab  also maintains a [https://launchpad.net/~sunab/+archive/kdenlive-release PPA] of the offical current release of '''Kdenlive'''  (as noted above) as well as the current release minus one at [https://launchpad.net/~sunab/+archive/ubuntu/kdenlive-release-old  ppa:sunab/kdenlive-release-old].
 
 
<!--T:40-->
 
If you need to back out a release to the previous release then:
 
* delete all packages (kdenlive, mlt, ...) from the kdenlive-release ppa (manually or with ppa-purge)
 
* disable ppa:sunab/kdenlive-release in the package manager/software sources
 
* enable the  [https://launchpad.net/~sunab/+archive/ubuntu/kdenlive-release-old  ppa:sunab/kdenlive-release-old]  in the package manager/software sources
 
* install '''Kdenlive''' from ppa:sunab/kdenlive-release-old
 
  
 
===Installing from pre-built binary packages === <!--T:31-->
 
===Installing from pre-built binary packages === <!--T:31-->
Line 171: Line 135:
 
<!--T:65-->
 
<!--T:65-->
 
Another downside is that these packages have been built with a version of ffmpeg that only has the free video codecs.  The type of files you can render your video to is limited.  Choosing the '''Theora''' profile in the '''Web Sites''' rendering destination does work.
 
Another downside is that these packages have been built with a version of ffmpeg that only has the free video codecs.  The type of files you can render your video to is limited.  Choosing the '''Theora''' profile in the '''Web Sites''' rendering destination does work.
 
===Installing from daily builds  - Old Versions=== <!--T:32-->
 
Dan Dennedy of the Melt project used to provide automatic daily builds that contained the latest git versions of '''Kdenlive''', MLT, Frei0r, FFmpeg and some other important libraries. However, the melt project's daily builds have not switched over to the 15.xx branch of Kdenlive so these instructions will not give you the bleeding edge code.
 
 
<!--T:56-->
 
You can test these packages without changing your system. Just download the package and extract it to a folder of your choice.
 
Inside that folder is a "start-kdenlive" executable that will start for you the latest '''Kdenlive'''.
 
 
<!--T:33-->
 
Execute this by typing <code>./start-kdenlive</code> in a terminal.
 
 
<!--T:34-->
 
Daily builds are currently provided for Ubuntu (should be compatible with OpenSUSE 12 and Debian 7) .
 
 
<!--T:35-->
 
See the [http://builds.meltytech.com/kdenlive/latest.rss daily builds rss feed] which provides links to the builds for the above mentioned distributions.
 
  
 
<!--T:37-->
 
<!--T:37-->

Revision as of 17:52, 1 April 2017

Other languages:
dansk • ‎Deutsch • ‎English • ‎español • ‎français • ‎русский • ‎українська • ‎中文(台灣)‎

Installation

Install binary packages

Most linux distributions provide recent binary packages of Kdenlive that can be installed from your Package Manager. However, in some cases you can find more recent versions in private repositories.

This page at the Kdenlive home has instructions on how to source these more recent versions, depending on which flavour of Linux you run. Instructions for Debian, Fedora, Gentoo, OpenSUSE, Slackware and Ubuntu are available.


As of May 2015, obtaining and installing the latest version of Kdenlive has gotten a little complicated. Development of Kdenlive up to this point has used a technology known as KDE Frameworks 4. And the last stable release using this technology is version 0.9.10, released 25th September 2014.
To use this you need to have recent versions of frei0r, Kdenlive , mlt and libvidstab, e.g.:

  • frei0r = 1.4.0+git20140826.72e51041
  • Kdenlive = 0.9.10
  • mlt = 0.9.3+git20141005.22abed67
  • libvidstab=2:0.98b


As of June 2015, this PPA has version 0.9.10 of Kdenlive , 1.4.0 of Frei0r and 0.9.3 of melt.

Development of Kdenlive has now switched to a new version of the KDE Frameworks called KF5 (KDE Frameworks 5). To install versions of Kdenlive using this underlying technology, you need to be on a Linux distribution which supports KF5. Ubuntu and its derivatives versioned 15.04 and higher support KF5. It is not possible to install KF5 on distributions earlier than 15.04 (except by chrooting your system). Versions using KF5 are distributed by the Kubuntu-CI Team. The sunab ppa (see below) now also distributes KF5 versions.
Version numbers of the KF5 flavour start at 15.04.0.
This author recommends using the sunab ppa to install Kdenlive rather than the Kubuntu-CI Team because the Kubuntu-CI Team PPA has many other packages in it which will attempt to uprade all sorts of things on your system—with the potential of breaking it.

Debian

Debian project has been shipping Kdenlive packages since the "squeeze" (6.0) release. However, to benefit from recent updates and bugfixes, you might consider upgrading to a "testing" release or even "sid".

Once your package management tool is pointed at an appropriate release, a simple apt install kdenlive should then work.

Sunab's PPA (see below) is not recommended for Debian because Debian uses a different lib layout for multiarch (reference: this post from vpinon).

Ubuntu and derivatives

Ubuntu also has offered Kdenlive since "gutsy" (7.10). However, to benefit from recent updates and bugfixes, you should consider upgrading to the latest release.

ppa:kdenlive/kdenlive-master is the development branch, with the very latest features additions.

ppa:kdenlive/kdenlive-testing is the feature-frozen branch, starting from the first beta, with bugfix updates as soon as solutions are found

ppa:kdenlive/kdenlive-stable is the last robust official release

Not all the packages in the ppa are necessary. Install or upgrade the following to get a 15.04 release (version numbers as at 13 July 2015)

  • kdenlive (15.04.2-0ubuntu0-~sunab~vivid4)
  • kdenlive-data (15.04.2-0ubuntu0-~sunab~vivid4)
  • libmlt++3 (0.9.6-0ubuntu0~sunab~vivid1)
  • libmlt-data (0.9.6-0ubuntu0~sunab~vivid1)
  • libmlt6 (0.9.6-0ubuntu0~sunab~vivid1)
  • libvidstab1.0 (2:0.98b-0ubuntu0~sunab~vivid1)
  • melt ( 0.9.6-0ubuntu0~sunab~vivid1)

Non-Kubuntu users will need to install the kde-runtime package to fix missing buttons and icons.

Fedora, RedHat and derivatives

RPM packages are not yet maintained in an official branch, so you must go through an unofficial repository such as RPM Fusion or packman (Has ver 15.12.0 29 Dec 2015). Follow the site's recommendations to make them available and end with yum install kdenlive.

Gentoo, Arch, BSD ports

Building scripts are ready for up-to-date systems, so run respectively emerge kdenlive or pacman -S kdenlive or pkg_add kdenlive, etc.

Windows

The first Windows version of Kdenlive (v16.12.1) is available for download here. Read the installation instructions for Windows.

Alternatively you could try and use some virtualized Linux distribution to run Kdenlive on Windows. Some advice can be found on this page.

There is also the kdenlive on win project on SourceForge which "consists of an Ubuntu VirtualBox image that is preconfigured to run Kdenlive". The project was last updated 2012-08-09.

MacOS

Kdenlive and MLT can compile and run under Mac OS X. Packages are available from the MacPorts project.

MacPorts is a source-based system — there is not a binary app bundle for Kdenlive. Therefore, Kdenlive and all of its numerous dependencies, including multimedia libraries, KDE, and Qt, must be compiled. This can take a long time and much disk space! Furthermore, it is not unusual for something not to build correctly; it is definitely not something for the novice, impatient, or "faint of heart".

You may have some success getting support for the MacPort of Kdenlive on the Mac Ports forum on MacOS Forge.

Installing from source

If you want to test latest committed code or your personal patches, you will have to build Kdenlive (and probably MLT) on your own.

Details on how to compile and install Kdenlive from source are available on the Community wiki.

You can use your distribution's package building procedure to use its software management system to install/upgrade/remove the binaries and data, and eventually share your builds (and even contribute to package maintenance - refer to the respective distribution manual).

If you prefer you can build & install Kdenlive to a local area (preferably not /usr, but rather /usr/local or $HOME/my_local_builds/kdenlive-last-release or similar). You could try using this build script to build the latest version from the sources. Or you could use the this build script to build kdenlive ver 0.9.10 [1] (Follow the instructions under "show kdenlive". These instructions will build Kdenlive and its dependancies [e.g. melt, ffmpeg] in a "sandbox").

Installing from pre-built binary packages

Kdenlive developer Vpinon is making available compressed pre-built binary files for installing from http://files.kde.org/kdenlive/.

You can test these packages without changing your system. Just download the package and extract it to a folder of your choice. Inside that folder is a "start-kdenlive" executable that will start for you a recent version of Kdenlive.

Execute this by typing ./start-kdenlive in a terminal.

Pre-built binary packages are often an easy solution if you are having troubles with your install and can be preferable to building your own because you don't need to install a build environment.

The potential downside is that the pre-built binary packages are built from the unstable development stream and may contain bugs. On the plus side, your pre-built binary packages version and your main version of Kdenlive can live simultaneously on your machine.

Another downside is that these packages have been built with a version of ffmpeg that only has the free video codecs. The type of files you can render your video to is limited. Choosing the Theora profile in the Web Sites rendering destination does work.

Be sure to choose the correct download for the bitness your system:

kdenlive-debian7-x86_64-YYYYMMDD.tar.bz2 is for 64-bit Debian or Ubuntu-based distros. (As at October 2015 this is still a 0.9.10 version of Kdenlive).
kdenlive-ubuntu14.04-x86-YYYYMMDD.tar.bz2 (no 64 in the name ) is for 32-bit Ubuntu—(release 14.04 or higher) or other Debian-based distros.

Daily builds are often an easy solution if you are having troubles with your install and can be preferable to building your own because you don't need to install a build environment (which can be problematic on old distros).

Daily builds are likely to work even if your distro doesn't match the reference ones, as these references are older (with ascendant compatibility libs) and the important libs are embedded—they normally work without a problem.

The potential downside is that the daily builds are built from the unstable development stream and may contain bugs. On the plus side, your daily build version and your main version of Kdenlive can live simultaneously on your machine.

See also Kdenlive homepage

  1. on distributions older than Debian 6 or Ubuntu 10.04 and derivatives, you need to set ENABLE_SWFDEC=0 in the config variables of the script. Modify the INSTALL_DIR in the script to something like INSTALL_DIR="$HOME/my_local_builds/kdenlive-last-release" to make it match where you want this local build to install.

Content is available under Creative Commons License SA 4.0 unless otherwise noted.