Kdenlive/Manual/Installation: Difference between revisions

From KDE UserBase Wiki
m (Punctuation)
No edit summary
 
(66 intermediate revisions by 10 users not shown)
Line 1: Line 1:
<languages />
<languages />
<translate>
<translate>
{{Warning Kdenlive migrated}}


== Installation == <!--T:18-->
== Installation == <!--T:18-->


=== Install binary packages === <!--T:1-->
<!--T:82-->
 
Visit the [https://kdenlive.org/download/ download] page of the Kdenlive Web site for up to date information on installing '''Kdenlive'''.  (Aug 2017)
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.
 
<!--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.
 
 
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  [http://kdenlive.org/discover/0.9.10 0.9.10], released 25th September 2014.<br />
To use this you need to have recent versions of frei0r, '''Kdenlive''' , mlt and  libvidstab,
e.g.: <br />
* frei0r = 1.4.0+git20140826.72e51041  <br />
* '''Kdenlive''' = 0.9.10  <br />
* mlt = 0.9.3+git20141005.22abed67 <br />
* libvidstab=2:0.98b
<br />
 
As of June 2015, [https://launchpad.net/~sunab/+archive/ubuntu/kdenlive-release-old this] PPA has version 0.9.10 of Kdenlive , 1.4.0 of Frei0r and 0.9.3 of melt.
 
<!--T:49-->
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 ''chroot''ing your system).
Versions using KF5 are distributed by the [https://launchpad.net/~kubuntu-ci Kubuntu-CI Team]. The sunab ppa (see below) now also distributes KF5 versions. <br>
Version numbers of the KF5 flavour start at 15.04.0. <br>
 
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 Kbuntu comes out of the box with 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.
==== Debian ==== <!--T:4-->
 
<!--T:5-->
''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".
 
<!--T:42-->
Once your package management tool is pointed at an appropriate release, a simple <code>apt-get install kdenlive</code> should then work.
 
<!--T:43-->
Sunab's PPA (see below) is not recommended for Debian because ''Debian uses a different lib layout for multiarch'' (reference: this [https://forum.kde.org/viewtopic.php?f=269&t=123425#p322708 post] from vpinon).
 
==== Ubuntu and derivatives ==== <!--T:6-->
''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.
 
<!--T:36-->
Sunab offers a stable release of Kdenlive (KF 5 version 15.04.x) from [https://launchpad.net/~sunab/+archive/kdenlive-release this] PPA.
 
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:44-->
Once your package management tool is pointed at an appropriate release, a simple <code>apt-get install kdenlive</code> should then work.
 
<!--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-->
 
<!--T:9-->
RPM packages are not yet maintained in an official branch, so you must go through an unofficial repository such as  [http://rpmfusion.org/ RPM Fusion] or [http://packman.links2linux.de/package/kdenlive packman]. Follow the site's recommendations to make them available and end with <code>yum install kdenlive</code>.
 
==== Gentoo, Arch, BSD ports ==== <!--T:10-->
 
<!--T:11-->
Building scripts are ready for up-to-date systems, so run respectively <code>emerge kdenlive</code> or <code>pacman -S kdenlive</code> or <code>pkg_add kdenlive</code>, etc.
 
==== Windows ==== <!--T:19-->
 
<!--T:20-->
There is no native Windows version of '''Kdenlive''' yet. However, you can use some virtualized [[Special:myLanguage/What_is_a_distribution|Linux distribution]] to run '''Kdenlive''' on '''Windows'''. Some advice can be found on [http://www.kdenlive.org/forum/kdenlive-windows this page].
 
<!--T:41-->
There is also the [http://sourceforge.net/projects/kdenlive-on-win/ 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 ==== <!--T:21-->
 
<!--T:22-->
'''Kdenlive''' and '''MLT''' can compile and run under Mac OS X. Packages are available from the [http://www.macports.org/ MacPorts] project.
 
<!--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".
 
<!--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-->
You may have some success getting support for the MacPort of '''Kdenlive''' on the Mac Ports forum on [http://mac-os-forge.2317878.n4.nabble.com/MacPorts-f3.html MacOS Forge].
 
=== Installing from source === <!--T:12-->
 
<!--T:13-->
If you want to test latest committed code or your personal patches, you will have to build '''Kdenlive''' (and probably '''MLT''') on your own.
 
<!--T:14-->
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).
 
<!--T:15-->
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).
It is then recommended to use the [http://www.mltframework.org/twiki/bin/view/MLT/BuildScripts#Kdenlive build script] <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").
 
</translate><span id ="nstalling from Sunab's PPA"></span><translate>
 
===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:39-->
<!--T:96-->
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].
Follow this link for [[Special:myLanguage/Historical Install Information|Historical Install Information]]


<!--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 daily builds  === <!--T:31-->
=== Configuration Information === <!--T:97-->


<!--T:32-->
<!--T:98-->
Dan Dennedy provides automatic daily builds that contain the latest git versions of '''Kdenlive''', MLT, Frei0r, FFmpeg and some other important libraries. Note: It looks like the daily builds have not switched over to the ver 15.04 branch. So this will not give you the bleeding edge code.
Kdenlive's application-wide persistent settings are stored in the following locations, depending on your platform.  


You can test this 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-->
==== GNU/Linux ==== <!--T:99-->
Execute this by typing <code>./start-kdenlive</code> in a terminal.


<!--T:34-->
<!--T:100-->
Daily builds are currently provided for Ubuntu (should be compatible with OpenSuse 12 and Debian 7) and Fedora.
* '''~/.config/kdenliverc''' : contains the general settings of the application. Delete this and restart kdenlive to reset the application to "factory" settings


<!--T:35-->
<!--T:101-->
See the [http://builds.meltytech.com/kdenlive/latest.rss daily builds rss feed] which provides links to the builds for the above mentioned distributions.
*'''~/.config/session/kdenlive_104534dcfdb61d887154xxxxxxxxxxx_154yyyyyy_98zzzz''' : temporary session info


<!--T:37-->
<!--T:102-->
Be sure to choose the correct download for your system.
*~/.cache/kdenlive : cache location storing audio thumbnails, video thumbnails, and proxy clips


<!--T:38-->
<!--T:103-->
kdenlive-fedora17-x86_64-YYYYMMDD.tar.bz2  is for 64bit Fedora<br />
* ~/.local/share/kdenlive/HD : lumas folder inside here contains the files used for   [[Special:MyLanguage/Kdenlive/Manual/Transitions/Wipe|Wipes]]
kdenlive-ubuntu12.04-x86_'''64'''-YYYYMMDD.tar.bz2  is for 64bit Ubuntu - (release 12.04 or higher) or other Debian based distros<br />
kdenlive-ubuntu14.04-x86-YYYYMMDD.tar.bz2  (no 64 in the name ) is for 32bit Ubuntu  - (release 14.04 or higher) or other Debian based distros<br />


<!--T:104-->
* ~/.local/share/stalefiles/kdenlive


<!--T:46-->
==== Windows ==== <!--T:106-->
Daily builds are often an easy solution if you are having troubles with your instal and can be preferable to builing your own because you don't need to install a build environment (which can be problematic on old distro).


<!--T:47-->
<!--T:107-->
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 - it normally works without problem.
* %LOCALAPPDATA%\kdenlive\cache : cache location storing audio thumbnails, video thumbnails, and proxy clips


<!--T:48-->
<!--T:108-->
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.
* %APPDATA%\kdenlive : contains user library clips, speech models, profiles and titles


<!--T:25-->
<!--T:109-->
See also [http://kdenlive.org/downloading-and-installing-kdenlive Kdenlive homepage]
* %PROGRAMFILES%\kdenlive\bin\data\kdenlive\lumas : lumas folder inside here contains the files used for [[Special:MyLanguage/Kdenlive/Manual/Transitions/Wipe|Wipes]]


<!--T:16-->
<!--T:105-->
<references/>
<references/>
{{Prevnext2
{{Prevnext2
Line 158: Line 53:
|prevtext=Introduction
|prevtext=Introduction
|nextpage=Special:MyLanguage/Kdenlive/Manual/QuickStart
|nextpage=Special:MyLanguage/Kdenlive/Manual/QuickStart
|nexttext=QuickStart
|nexttext=Quick Start
|index=Special:MyLanguage/Kdenlive/Manual
|index=Special:MyLanguage/Kdenlive/Manual
|indextext=Back to menu
|indextext=Back to menu

Latest revision as of 13:31, 15 August 2023

Permanently Moved

The Kdenlive Manual has been moved here:
https://docs.kdenlive.org


To edit the pages, please continue here:

https://invent.kde.org/documentation/docs-kdenlive-org (11/2021)


Installation

Visit the download page of the Kdenlive Web site for up to date information on installing Kdenlive. (Aug 2017)

Follow this link for Historical Install Information


Configuration Information

Kdenlive's application-wide persistent settings are stored in the following locations, depending on your platform.


GNU/Linux

  • ~/.config/kdenliverc : contains the general settings of the application. Delete this and restart kdenlive to reset the application to "factory" settings
  • ~/.config/session/kdenlive_104534dcfdb61d887154xxxxxxxxxxx_154yyyyyy_98zzzz : temporary session info
  • ~/.cache/kdenlive : cache location storing audio thumbnails, video thumbnails, and proxy clips
  • ~/.local/share/kdenlive/HD : lumas folder inside here contains the files used for Wipes
  • ~/.local/share/stalefiles/kdenlive

Windows

  • %LOCALAPPDATA%\kdenlive\cache : cache location storing audio thumbnails, video thumbnails, and proxy clips
  • %APPDATA%\kdenlive : contains user library clips, speech models, profiles and titles
  • %PROGRAMFILES%\kdenlive\bin\data\kdenlive\lumas : lumas folder inside here contains the files used for Wipes