Ubuntu packages

The recommended version of Kdenlive is 0.9.2 and MLT 0.8.2

All the following packages have been built with the official ffmpeg version of each Ubuntu release. If you are using some backported version of ffmpeg you can't use those packages.

Support: only for the recommended version

Please report any problem in our forum [15].

Ubuntu Precise (12.04), Ubuntu Oneiric (11.10), Ubuntu Natty (11.04),Ubuntu Lucid (10.04)

Versions of Kdenlive in official repositories are deprecated. It is strongly recommended to install Kdenlive 0.9 packages using Sunab's alternative repository:

1. go to System Menu > System Menu > Administration > Software Sources > Other Software (10.04); or
   type 'Software Sources' in Unity Dash > Other Software (12.04, 11.10, 11.04);
   
2. click add and paste this line in:
   ppa:sunab/kdenlive-release
3. close software source and click reload.

Install Kdenlive with the Software center (11.04, 11.10, 12.04) or your favourite package manager.

Alternatively you can do all the process typing the following command line in a terminal :
sudo add-apt-repository ppa:sunab/kdenlive-release && sudo apt-get update && sudo apt-get install kdenlive

Debian packages

Debian packages are available in the official repositories. Kdenlive 0.7.8-1 is in stable,
the last stable version (currently 0.8.2) is available in testing, and current development version is in unstable. You can check the Kdenlive packages versions here: http://packages.qa.debian.org/k/kdenlive.html.
Debian packages are available for the following architectures: [alpha] [amd64] [arm] [armel] [hppa] [hurd-i386] [i386] [ia64] [kfreebsd-i386] [kfreebsd-amd64] [m68k] [mips] [mipsel] [powerpc] [s390] [sparc]:

To install Kdenlive packages from Debian repositories.

As root, type:

apt-get install kdenlive frei0r-plugins dvgrab recordmydesktop dvdauthor mkisofs

Upgrade to Debian Unstable

The last released version of Kdenlive is usually available within 10 days in Debian testing, but if you really want to get Kdenlive's current development version, you might want to upgrade to Debian unstable. Be aware that this is for experienced users only and might break parts of your system that are currently working. In Debian terminology, the word unstable indicates that packages are not yet in a stable release. You may experience problems with some recent packages. Make sure you understand what you are doing.

Under root account, add the following lines to /etc/apt/sources.list:

deb-src http://ftp.fr.debian.org/debian/ [17] unstable main contrib non-free
deb http://ftp.fr.debian.org/debian/ [17] unstable main contrib non-free

You may select mirrors in your country for faster download. 

To upgrade to Debian unstable, as root type:

apt-get update;
apt-get dist-upgrade

Install Debian multimedia packages

This is not recommended unless you are using stable (Squeeze).

Some packages are only available from Marillat multimedia repository:

• mp3lame for mp3 sound export (usefull to export to Mpeg2/Mpeg4/DivX with mp3 sound).
• x264 for H264 video export.
• Quicktime container.

Under root account, add the following lines to /etc/apt/sources.list:

deb http://www.debian-multimedia.org [18] sid main
deb http://www.debian-multimedia.org [18] testing main

Install Debian-multimedia GPG key:
apt-get update ; apt-get install debian-multimedia-keyring

Then upgrade ffmpeg packages typing:
apt-get update ; apt-get ugrade; apt-get install ffmpeg x264 libmp3lame0 libquicktime1

Fedora packages

Kdenlive and MLT are available for Fedora 11 in the RPM Fusion repository:
http://rpmfusion.org [19]

Gentoo packages

Gentoo offers ebuilds for kdenlive at http://packages.gentoo.org/package/media-video/kdenlive [20].

A basic install of KDE4 is needed, check the Gentoo KDE 4 Guide [21] if necessary.

Mandriva packages

Kdenlive official repository

Kdenlive 0.7 is reported to be published in the official Mandriva 2009 distribution.

Kdenlive unofficial repository

Kdenlive 0.7.7.1 packages for Mandriva GNU/Linux distribution are available from zarb RPM repository [22].

Any feedback would be appreciated:

http://www.kdenlive.org/forum/feedback-about-mandriva-packages [23]

Slackware packages

The recommended version of Slackware is 13.37
-current support has been dropped
-There are now 64-bit packages as well as 32-bit; choose your preference

Update: New packages available! as per 31-05-2012: Kdenlive 0.9.2 and MLT 0.7.8

Recommended versions:

• MLT 0.7.8
• Kdenlive 0.9.2
• Optionally: frei0r 20120516

To install:

• download the packages from here: http://www.mlange.dds.nl/ [24]

Major changes have been made: all the packages for the patent-free software are provided as well as scripts to build the patented software.
Everything has been built as shared library, which is notable in the amount of packages to support ffmpeg (which was built statically at first)

New per May 31st 2012:
- kdenlive 0.9.2
- MLT 0.7.8
- ffmpeg and dependencies updated

Built for Slackware 13.37, which is the supported platform (although I think it should provide no issues on Slackware 13.1)
Please leave comments in the forums, so everyone can see the status.

openSUSE packages

Kdenlive is available as a packaged rpm prepared by the Packman packagers. It can be installed via One-click install [25] (once there click on the "1 click install" link on the right) or via YaST, if one first adds packman to one's repositories. For guidance on how to setup one's repositories, go here http://opensuse-community.org/Repositories [26] and per the instructions for one's openSUSE version, add OSS, NON-OSS, Main Update, and Packman.

Once the repository is setup then install kdenlive either via yast, or install kdenlive via a command line with root permissions, by typing:

zypper install kdenlive

FreeBSD ports and packages

FreeBSD [27] offers Kdenlive through the ports collection. Unfortunately, FireWire and Webcam capture aren't supported yet; we hope to get them soon! You can track the status of the ports: MLT [28] and Kdenlive [29].

How to install

Kdenlive depends on FFmpeg to manage your multimedia files. FreeBSD ships with two flavours of this software: stable and development snapshot. Kdenlive dependency defaults to the first one (multimedia/ffmpeg), but you're invited to install multimedia/ffmpeg-devel in place of it. If (and only if) you're using portupgrade, you need to specify the alternate dependency in /usr/local/etc/pkgtools.conf (ALT_PKGDEP), or you will get a conflict; this is one of the reasons which made me choose not to depend on the development port (every other port is depending on multimedia/ffmpeg at the moment), but things could change in the future.
Often, users complain about missing codecs while importing or exporting video and audio files: this depends on FFmpeg being installed without support for them. On FreeBSD it's rather easy to overcome this problem: just build FFmpeg from the ports, and remember that the more options you enable in the port configuration, the more codecs you'll be able to work with.
Consider yourself advised against using a package: with the default options you won't even get MP3 support.

Now you simply have to launch Kdenlive installation. You can choose between ports and packages.

Install from ports

This is the recommended way, since you can always get the latest version in the tree:

1. upgrade your ports tree (click here [30] for instructions);
2. check /usr/ports/UPDATING for eventual instructions related to MLT or Kdenlive;
3. # cd /usr/ports/multimedia/kdenlive && make install clean or # portupgrade -N kdenlive or # portmaster multimedia/kdenlive or # portmanager multimedia/kdenlive.

Install from packages

If you want to avoid building Kdenlive and all its dependencies, you can use packages. You won't always get the latest version (here's a list of the available packages [31]):

# pkg_add -r kdenlive or # portupgrade -NPP kdenlive or # portmaster -PP multimedia/kdenlive.

Mix ports and packages

With portupgrade or portmaster you can use both ports and packages to install the latest version of the applications:

1. # cd /usr/ports/ports-mgmt/portupgrade or # cd /usr/ports/ports-mgmt/portmaster;
2. # make install clean;
3. # portupgrade -NP kdenlive or # portmaster -P multimedia/kdenlive.

Portupgrade, or portmaster, respectively, will install packages if they are up to date, otherwise it will build from the ports.

Mac OS X packages from MacPorts

Kdenlive and MLT can compile and run under Mac OS X. Packages are available from the MacPorts [32] 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."

System: Leopard or Snow Leopard

Kdenlive and MLT were tested on Mac OS X 10.5 and 10.6, Intel platform.
We welcome your feedback on Mac OS C 10.5 PowerPC platform, not test was done.

Kdenlive could not be compiled on Mac OS X 10.4.

Install MacPorts

Follow these guidelines: http://guide.macports.org/index.html#installing [33]

If MacPorts is already installed on your computer, upgrade installed ports:
% sudo port -d selfupdate
% sudo port -u upgrade outdated

Install Kdenlive

Run the following command:
% sudo port install kdenlive

Post-install

Run the following commands:
% sudo chown -R $USER ~/Library/Preferences/KDE
% sudo launchctl load -w /Library/LaunchDaemons/org.freedesktop.dbus-system.plist
% sudo chown $USER /Library/LaunchAgents/org.freedesktop.dbus-session.plist
% launchctl load -w /Library/LaunchAgents/org.freedesktop.dbus-session.plist
% open -a kdeinit4

If you want to reclaim disk space:
% sudo port clean --all installed

Add a Login Item:

1. From the Apple menu, choose System Preferences...
2. Click Accounts
3. Click Login Items
4. Click +
5. In the file dialog, go to /Applications/MacPorts/KDE4
6. Select kdeinit4
7. Click Add
8. Close the System Preferences window

Running Kdenlive

There are a few ways:

• In a terminal:
  % open -a kdenlive
• From Finder or the Dock
  1. Switch to the Finder
  2. Navigate to /Applications/MacPorts/KDE4
  3. Double-click kdenlive
  4. Drag kdenlive to the Dock if you want

  Note: you will not get a pretty icon in the Dock when it is not running.

• In Spotlight (after it has re-indexed), enter "kdenlive" and choose it from the Applications section of the results.

Not Launching?

If after performing the above, Kdenlive still does not launch, then check your process listing to see if dbus (one with --system and one with --session), kdeinit4, and klauncher are running.

% ps ax | grep [d]bus
% ps ax | grep [k]de

These must be running for Kdenlive to run, but the Kdenlive port is not responsible for making them work. You should review the above instructions.

Removing Kdenlive

To remove just Kdenlive:
% sudo port uninstall --follow-dependents kdenlive

To remove Kdenlive and all of MacPorts:
http://guide.macports.org/#installing.macports.uninstalling [34]

Feedback

Please make your feedback here:
http://www.kdenlive.org/forum/feedback-about-kdenlive-mac-os-x [35]

Installing the required libraries

First step is to install the required libraries. These libraries are rather stable and part of every GNU/Linux distribution. They will be needed in the compilation process of FFmpeg, MLT and Kdenlive.

Build Script

As an alternative to this manual procedure, there is a build script [37] that gets the latest version of Kdenlive and many of its multimedia dependencies including x264, libvpx, FFmpeg, frei0r, MLT. Then, it builds them into an isolated folder in your home directory and does not require installation. Rather, when you run it with the provided launch script, it uses the more recent libraries and plugins instead of those from packages.

Packages and Version Numbers

Version numbers of the libraries may change. If you cannot find the exact name of a library, e.g. libpango1.0-dev, try searching for a different package starting with libpango and ending with -dev. Also sometimes a version number is necessary although it is not written here (e.g. the list below says libpango-dev, but the package is called libpango1.0-dev) — or also the other way round.

When installing packages in the terminal, e.g. with
apt-get install package1 package2 …
, the Tabulator key will be a great help: Type libpango and press Tab twice to see all possible packages.

One-liner

For easier installing, this is the list of the required libraries. They are explained below.

subversion git cmake build-essential yasm libqt4-dev kdelibs5-dev libsdl1.2-dev libsdl-image1.2-dev libxml2-dev libx264-dev libtheora-dev libxvidcore-dev libogg-dev libvorbis-dev libschroedinger-dev libmp3lame-dev libfaac-dev libfaad-dev libgsm1-dev libopencore-amrnb-dev libopencore-amrwb-dev libsamplerate0-dev libjack-dev libsox-dev ladspa-sdk swh-plugins libmad0-dev libpango1.0-dev

General tools

To download the source code you will need to install Subversion and git.

• subversion
• git
• cmake

Additionally required for compiling stuff:

• build-essential
• yasm [38] modular assembler (for H.264 decoding)

General libraries

• Qt 4 and KDE 4 development files (libqt4-dev and kdelibs5-dev)
• SDL (libsdl1.2-dev, libsdl-image1.2-dev)
• libXML2 (libxml2, libxml2-dev)

Screen capture

• recordmydesktop

Firewire and DV capture

• dvgrab
• libdv (libdv4-dev)
• libdc1394 (libdc1394-22-dev)

Audio and video codecs

• x264 codecs (x264, libx264-dev)
• Theora codecs (libtheora-dev)
• Xvid codecs (libxvidcore-dev)
• OGG (libogg-dev)
• Vorbis (libvorbis-dev)
• Dirac lossless codec (libschroedinger-dev)
• Lame audio codec (libmp3lame-dev)
• Libquicktime (libquicktime-dev)
• faac codecs (libfaac-dev)
• faad codecs (libfaad-dev)
• GSM (libgsm, libgsm1-dev)
• speech codecs (libopencore-amrnb-dev libopencore-amrwb-dev)

Sound processing and effects

• libsamplerate (libsamplerate0-dev)
• libJack (libjack-dev)
• SOX (sox, libsox-dev)
• ladspa (ladspa-sdk)
• ladspa plugins (swh-plugins)
• libmad (libmad0-dev)

Video effects and image processing

• frei0r effects (frei0r-plugins, frei0r-plugins-dev) only if you do not intend to compile frei0r yourself!

• gdk-pixbuf-dev
• libpango1.0-dev

Warning

MLT relies on FFmpeg compilation parameters. If your distribution ships with an outdated FFmpeg version, it may not be able to use the audio and video codecs like H.264 or AVCHD. In this case, recompile FFmpeg with all needed options or ask FFmpeg packager to upgrade.

Please inform us [39] of additional dependencies that we may have forgotten.

Installing FFmpeg

Installing FFmpeg packages

Most distributions provide packages for FFmpeg. The required packages for MLT compilation are:

• ffmpeg
• libavformat, libavformat-dev
• libavutil, libavutil-dev,
• libswscale, libswscale-dev,
• libavcodec, libavcodec-dev,
• libavdevice, libavdevice-dev

After installation, type ffmpeg to view ffmpeg compilation parameter, which must match our parameters (read below).

Compiling FFmpeg from sources

If your distribution does not provide a recent version of FFmpeg, it is recommended to compile FFmpeg from git. However you must be very careful to remove your distribution packages before installing the compiled ones, or you may be in trouble. Also remove any file from the Kdenlive installation wizard if you used it.

Install the needed libraries and make sure yasm assemby code compiler is installed.

Note on Ubuntu 10.10: ffmpeg requires libx264 of at least version 1.0 which is not in the repositories yet as of Jan 2011. Please follow this guide [40] instead to install ffmpeg with H.264 support.

1. Get the source

Check out the ffmpeg source code from git into a new directory (called ffmpeg):

cd
git clone git://git.videolan.org/ffmpeg
cd ffmpeg



(If you get an error message that git cannot be found, you need to install the package git.)

Alternatively, you can use the new Libav:

cd
git clone git://git.libav.org/libav.git
cd libav



2. Configure ffmpeg

To configure ffmpeg with the recommended compilation flags (determine which formats can be encoded etc.):

./configure --prefix=/usr --enable-shared --enable-libmp3lame --enable-gpl --enable-libfaac --enable-libvorbis --enable-pthreads --enable-libfaac --enable-libxvid --enable-x11grab --enable-libgsm --enable-libx264 --enable-libtheora --enable-libdc1394 --enable-nonfree --disable-stripping --enable-avfilter --enable-libschroedinger --enable-libopencore-amrnb --enable-libopencore-amrwb --enable-version3

It is possible that you get some error messages here, like ERROR: libopencore_amrwb not found. In this case check whether the according library is really installed. If you cannot install it, delete the flag (in this case it would be --enable-libopencore-amrwb) from the above command and execute it again.

3. Compile and install ffmpeg

To compile and install ffmpeg, execute the following commands (still from the same directory):

make -j3
sudo make install


Compiling will take some time (possibly several minutes). After ffmpeg is installed you are ready to continue with MLT or, if desired, frei0r.

4. Optional: Updating ffmpeg

After some days/weeks you want to update your self-compiled copy of ffmpeg. To do so, first update the source code by running:

cd
cd ffmpeg
git pull



Then run

make clean

to get rid of previously compiled files and continue with steps 2 and 3.

Installing frei0r

To compile the development version of frei0r, if you want to use an effect that is not available in a package. Make sure to first uninstall frei0r (frei0r-plugins, frei0r-plugins-dev, frei0r-plugins-doc for example) before installing the compiled version.

Libraries

Some additional libraries are required for frei0r.

• libcv-dev
• libgavl-dev
• libhighgui-dev
• libcvaux-dev

in a line libcv-dev libgavl-dev libhighgui-dev libcvaux-dev

Compiling and installing fei0r

In the terminal, check out the frei0r source code from the git repository:

cd
git clone git://git.dyne.org/frei0r.git


Then change to the frei0r directory and compile/install it:

cd frei0r
mkdir build
cd build && cmake .. -DCMAKE_INSTALL_PREFIX=/usr && make -j3
sudo make install

Updating frei0r

To update frei0r to the current version, type:

cd
cd frei0r
git pull
rm -rf build && mkdir build
cd build && cmake .. -DCMAKE_INSTALL_PREFIX=/usr && make -j3
sudo make install


Installing MLT rendering engine

You can download the latests official release of MLT from http://mltframework.org [41].

But it is recommended to use the latest development version which contains bug fixes. This page explain how to compile and install this version from the source code. If you just want to use the latest MLT component but keep an official Kdenlive released, please read this: http://kevin.deldycke.com/2010/11/latest-stable-kdenlive-development-ver... [42]

Remove MLT previous installation

You should uninstall previous versions of MLT very carefully. Warning: to remove MLT, you will need to connect under root account. There is a risk to destroy your operating system if you remove the wrong files.

• Use your package installer to remove any mlt* and libmlt* packages.
• Inspect /usr/local/lib and /usr/lib directories and look for mlt* and libmlt*. Remove files and directories if any.
• Remove pkgconfig files (mlt-framework.pc, mlt-miracle.pc and mlt-valerie.pc). Remove the following files: /usr/lib/pkgconfig/libmlt*, /usr/local/lib/pkgconfig/libmlt*.

Install dependencies

Make sure you have the following packages installed:

• libxml2-dev
• libsdl-dev
• libsdl-image-dev
• libavdevice-dev
• libswscale-dev
• libvorbis-dev
• libsamplerate-dev
• frei0r-plugins-dev (must notbe installed you compiled frei0r from source)
• libdv-dev
• libavformat-dev
• libquicktime-dev

We also recommand that you install:

• libsox-dev
• libjack-dev
• ladspa-sdk

Get latest MLT source code

Git is used to track MLT code. You can checkout the latest version with the following command:

cd
git clone git://github.com/mltframework/mlt.git
cd mlt

To update your MLT copy later, you need to go into your mlt folder and run the following code to fetch the newest source code:

cd
cd mlt
git pull

Configure MLT

Before compiling, MLT needs to be configured (searches for libraries etc.):

./configure --prefix=/usr --enable-gpl

Or, if qimage module fails to configure, try:

./configure --prefix=/usr --enable-gpl --qimage-libdir=/usr/lib/ --qimage-includedir=/usr/include/qt4

Read configuration output and make sure all shared libraries are found.

Compile and install MLT

The last step. Compiling will take a long time.

make clean
make -j3
sudo make install

If you are not on Ubuntu, then use su -c 'make install' instead of sudo make install.

Get a specific MLT version

This is only necessary when you experience problems with the most recent MLT version. To list the available tags and select one (e.g. v0.4.6) do:
git tag -l
git checkout tag

To switch back to the most up-to-date version use master as tag. After checking out the tag you need to do a git pull again.

Installing Kdenlive

Stable release

Kdenlive latest stable release can be downloaded from the KDE servers [43]. (release before 0.9 are still available on our SourceForge page [44]).

Getting the latest source code

Alternatively, you can checkout the development of Kdenlive from the git server:

git clone git://anongit.kde.org/kdenlive

You can also browse source code online (Projects.kde.org [45] | Quickgit [46]).

If you want to build the current stable branch (0.9):

git checkout v0.9

Or to build the current development code:

git checkout master

Compiling and installing Kdenlive

Then, in the kdenlive directory, where the files have been downloaded to, type:

mkdir build; cd build; cmake .. -DCMAKE_INSTALL_PREFIX=/usr; make
sudo make install

Updating your sources to the latest version

To later update to latest version of the source code:

git pull

Then make and make install and previously described.

Preparing the media

This section describes how to transfert the downloaded files to DVD or USB disc.

Preparing your computer

Most computers have a defaut setup to boot on a DVD or USB mass-storage:

• Intel/AMD PCs:
  • Just after reboot, the BIOS dispays information.
  • You may then hit ESC or F2 key (or whatever key is displayed) to enter BIOS. 
  • Change your BIOS to allow booting on DVD or USB Mass-storage.
  • The boot order may be DVD/USB and then disc.
• Intel MacOsX:
  • In the finder settings, select boot icon. Choose "Boot using another operating system" and select the live DVD or the Live USB mass-storage. 
  • Reboot.

Tips : if a USB memory stick is inserted before booting, pressing F8 to interrupt the usual boot process will bring up a dialog giving the option to boot from the USB stick after all :)

Starting a live session, without installing

Insert the disc or the USB mass-storage in your computer and reboot. A Bios dialog is displayed:

Hit return or enter "live" to start a live session:

Your computer is being discovered, a lot of messages are being displayed:

The demo system is up and ready:

If you are not using an English/American QWERTY keyboard, select System menu, Preferences menu, Keyboards to setup your keyboard:

Click on Add to choose a Keyboard. When done, press Close.

 To start Kdenlive, choose Applications menu, Sound&Video menu, Kdenlive icon:

A wizard displays:

Choose your default camcorder standard:

Important: Disable audio and video thumbnails. Thumbnails are stored on disc and you don't have access to your computer disc. This will save memory.

Et voilà! You can now test kdenlive:

Full persistence and home automounting (USB key only)

In this section, we will boot the newly created USB Key and add full persistence and home automounting. It will make your USB Key act as a real hard disc, allowing you to install additional software and remember your personal settings.

Please note that this does not apply to live DVD.

Free space on USB Key

After booting the USB key, launch Gparted in System -> Administration -> Gparted

In our example, we are using a minimal 2Gb USB Key. 1Gb free space is available:

We propose a simple rule, where 50% of free space should be for full persistence and 50% for home automounting.

You may experience problems to type on non-US keyboard. If this is the case, choose another keyboard in System->Preferences->Keyboard.

Full persistence

With "full persistence" it is meant that instead of using a tmpfs for storing modifications to the read-only media (with the copy-on-write, COW, system) a writable partition is used. In order to use this feature a partition with a clean writable supported filesystem on it labeled "live-rw" must be attached on the system at bootime.

This is very useful to be able to install additional software, keep your personal settings, such as keyboard, language, etc ...

In GParted, click on unallocated free space. In Partition menu, select New:

Steps:

• Click and move the borders to size your partition.
• Select ext3 file system as it is very common under GNU/Linux and well supported.
• Label the partition "live-rw".
• Click "Add" when finished.

Home automounting

If during the boot a partition (filesystem) image file or a partition labeled home-rw will be discovered, this filesystem will be directly mounted as /home, thus permitting persistence of files that belong to the e.g. default user. It can be combined with full persistence.

This partition can be used to store data on the USB Key and exchange data after rebooting under Windows.
if you plan to read and write data directly on your Windows hard disc, you don't really need this partition.

In GParted, click on unallocated free space. In Partition menu, select New:

Steps:

• Click and move the borders to size your partition.
• If you are using Windows XP, Vista or 7, select ntfs file system.
• If you are using Windows 95 or any derived version from DOS, select fat-32 file system.
• Label the partition "home-rw".
• Click "Add" when finished.

Apply changes and reboot

To apply your changes, click on apply. Applying modifications will take a few seconds. Then you should see your three partitions:

Close GParted and reboot your system:

• Select System -> Shutdown.
• Click on the Reboot button.

After reboot, your system should be persistent.

Using the live demonstration to resize a Windows partition

Windows users may need to resize a partition in order to install a dual-boot system and free space for a GNU/Linux partition.

Disclaimers

• Make sure your computer is connected to a reliable power source and will not shutdown during partion resizing.

• Make a complete backup of your data. When your backup is finised, disconnect the backup for the computer.

• You should be aware that resizing partitions is not a normal daily maintenance task. This is an exceptional tool, which can fail and make your desktop system unusable. Preferably, you can also by a new hard disc and avoid partition resizing.

• You should free at lease 20Mb for the system and 25Mb to store movies, which is a minimum.

Supported file systems

• DOS, FAT16, FAT32 and NTFS partitions. 
• Most Unix partitions can be resized. 
• There is no support for resizing MacOsX partitions.

Required steps

Start a normal live session.

Unmount the disc that would like to resize. Right click on the disc and select "Unmount". You cannot resize a disc which is mounted.

Run gParted: in System menu, Administration menu, select Partition editor.

In gParted windows, select the partition that you wish to resize.

In Partion menu, select Move/Resize:

Move partition borders to resize the partition:

When done, click on Resize/Move:

When done, click on Apply changes.

Wait until your changes are fully applied. Depending on the size of the partition, this may take a long time.

Starting the GNU/Linux Debian installer

Warnings

• This page describes how to install a fresh GNU/Linux system on your computer. Do not read this page if you only intend to use the Live DVD in demonstration mode.
• Before installing a new operating system, you should backup all your files on DVDs or fixed backup. Do not connect your backup to the computer during installation to avoid any accidental erase.
• A free partition with at least 20Gb should be available.
• Our installer is a Debian GNU/Linux installer. It is provided without liability or in countries which do not accept limited liabilities a maximum liability of 1€ as a total.
• If you are not aware of GNU/Linux, please ask for help to friends or people with a good knowledge in GNU/Linux. A good way to learn GNU/Linux is to use the Live DVD in demo mode until you have sufficient knowledge. Do not install GNU/Linux directly without any support for "real" people.

Main installation steps

Make sure to connect to Internet using an ethernet cable. Do not use this installer using Wired networks, as your wifi card may not be recognized during installation. Without any wired connection to the Internet, do not performe an installation.

Insert live DVD and reboot. By default this is a QWERTY keyboard. Enter "installgui" to start the installation.

Choose your language:

Choose a language variant:

Choose your keyboard:

Your computer is being discovered:

To be written in more details...

Live DVD support and changelog

Feedback and suggestions

Use this forum thread: http://www.kdenlive.org/forum/live-dvdusb-key-feedback [60]

Support

Register Kdenlive web site and visit our forum:
http://www.kdenlive.org/forum/contribution-forums/kdenlive-live-dvd [61]

How to build a Debian Live demonstration

Read: http://www.kdenlive.org/contribution-manual/how-build-debian-live-cd-kde... [62]

Source code

Source packages [63] for Live DVD (required by Free Software rules, no need to download).

Adding video clips

Step one is to get some clips into Kdenlive. This could be footage downloaded from YouTube, or material captured from a video camera or TV-capture-device. Let's assume that you already have some files available that are supported by Kdenlive.

To add a clip, select the Project Tree panel, drag the "Add Clip" dropdown button, and select "Add Clip". This brings up a KDE open dialog. Select one or more clips, and they will be added to the project tree. They are now displayed in the Project Tree panel with some metadata.

Creating a title clip

Kdenlive is able to create simple titles as described here. We can also work with external image editors (like GIMP) to create more sophisticated titles and then add them to the project list as video clips.

To create a title clip, select "Add clip" icon () and, in the context menu, select "Create Text Clip". A new window like this will be presented:

In this window, you can give a name to your clip, define the duration, the letter type, size and colour. You'll also have the following icons:

• To enter the text
• To draw a box
• To bring to front / send back the text or the box

You can now select the "Enter text" icon, write the title and click "OK". The text will appear in the window and you can drag and drop it wherever you want on the screen. To improve your title, click the "Draw box" icon and, with the left mouse button pressed, draw a box on the screen. Before doing so, you need to change the box colour in the same way as you did for the text. If the box and the text have the same colour, they may interfere!

Don't worry if you can't see your text now! Select the box and try with the "Bring to front/send back" icons. Better now, huh?

By dragging and dropping the box and the text and by playing with the movement icons, you can obtain quite nice titles!

Dragging clips to the timeline

Now that you have some clips in your project, it is time to start editing them together into your dream video. There are two basic ways to add a clip to the timeline.

You can drag a clip directly from the project list. Select one of the clips that you have added to the project list, and drag it to the timeline. As soon as the mouse reaches a track, the clip will appear on the track. With this kind of drag, the entire duration of the clip is placed on the timeline. You can then edit the clip from the timeline.

The other way is to select a segment of a clip and then add this segment to the timeline. When you click on a clip in the project list, the Clip Monitor will automatically load the clip. You can then press Play on the Clip Monitor and get an idea of which bits of the clip you actually want on the timeline. Then, position the seek marker () to where you want your clip to start and click the "inpoint" button (). Move the cursor to where you want the clip to end, and click the "outpoint" button (). Finally, you can move this cut-down clip to the timeline by clicking the video screen on the Clip Monitor and, holding down the left mouse button, placing it in the desired point of the timeline. The selected zone between the in and out point will then appear there as a clip (to be more precise, a subclip as we've selected only a part of the original clip).

Choose your way and, to continue with the quickstart guide, be sure to move two clips (or subclips) to the timeline. One to Track #1 and the other to Track #2.

Moving and resizing clips on the timeline

Moving the selected clips around on the timeline is as simple as clicking on them with the left mouse button and dragging them around. You can resize clips directly from the timeline. Simply move the mouse cursor to the beginning or end of the clip you want to resize. Now, click and drag with the left mouse button to resize the clip.

Resizing a clip changes its in and out points. If you reselect the clip and look in the clip monitor, you will see that the in and out points on the monitor show the new positions. It is not possible to resize an audio or video clip past their length - if a clip is 30 seconds in length, then you will not be able to resize the clip so that it finishes playing 35 seconds into the clip! -. On the other hand, you can resize text, image or color clips to increase or reduce their length as you want.

When you are resizing and moving clips, there is a handy "snap to" feature, which will snap the edges of clips to other clips and the current seek position. This is useful for quickly lining clips up with each other, but in some cases may not be what you want. You can turn this behaviour on and off using the "Snap to" icons:

Removing clips from the timeline

There are some ways to remove a clip from the timeline. Maybe the easier one is to select the clip or clips that you want to delete, and press the "Delete" button in your keyboard.

Another way is to select the clips that you want to delete, press the right mouse button and in the context menu select option Delete Clip.

By this, you'll remove the clip from the timeline but it still appears in the "Project Tree" list. If you select the clip here and proceed as above, you'll remove it also from the project. But do not worry, it still remains physically in your disk!

Splitting clips in the timeline

Sometimes you may need to delete (maybe because you let your video-camera or TV-capture-device run too long) or maybe to apply a video effect to only a part of a clip. Kdenlive allows you to do so by splitting the original clip.

To split a clip, the normal way is to place the timeline cursor at the splitting point (you can adjust the exact position by playing with the "Next frame" and "Previous frame" buttons in the "Timeline Monitor"). Then press the right mouse button and in the context menu select option Razor Clip. (The razor cuts before the current frame, so the right strip will contain the frame you're standing on.) With this option only the clip in the current track will be split.

You can split all clips at that position selecting the option Razor All Clips in the edit menu.

Adding a transition

We are going now to add a transition between two clips. Transitions are normally used to smoothly change from one clip to another (or from one scene to another). Some transitions can be used also as video effects (Picture in Picture, for example). These powerful features are explained in detail in this page [92], but for the purpose of this quickstart guide, we'll focus on an easy one, the crossfade transition (but see the warning at the top of this page!)

Before start, be sure that you have your two videoclips in tracks #1 and #2. Also, move (as explained before) the title clip that we've created previously to the start of track #0.

If we want to apply a transition, we need to overlap the required clips in different tracks. So first thing to do is to move the clip in track #1 to overlap with the title in track #0, let say by 2 seconds.

To better control this overlap you can change the timeline zoom using the viewer tool . Click on the magnifying glass and select a small scale or click on the ruler and drag left.

Once done, click on the title clip and press the right mouse button. In the context menu select Add transition -> Crossfade. A yellow bar will appear between the clips in tracks #0 and #1 indicating your transition has been added to the project.

At this point your screen should look like this one:

To have a real time view of how your transition works, you can click the seek marker and drag it over the transition area. If everything is OK, you should see in the "Timeline Monitor" how the title clip dissapears at the same time the video clip is displayed.

To edit a transition and change parameters, you can double click on it (the yellow bar). In this way, it will become red and the focus in the "Project Panel" will change to the "Transition tab". In this tab you'll be able to change the transition parameters if needed.

As the Crossfade is an easy transition, the only parameters you can change are the transition direction and the track where it applies.

If the Invert direction parameter is selected, the upper track clip is shown first and the transition is applied until the view changes to the lower track clip. If the parameter is not selected, then the direction is the other way round.

The track to apply the transition is normally the next track after the one where we created the transition. But you can change this behaviour by selecting others in the Track Selection List. This is a powerful feature for advanced transitions, but for the moment we'll not use, so be sure your selection is Automatic – Use next video track.

You can play now creating a new transition between clips in tracks #1 and #2 in the same way as explained above.

Adding effects

Now you know how to create a transition between clips, is time to experiment with another feature in Kdenlive: The effects.

Effects are ways to change your original clip. Kdenlive comes with different effects that can be applied to the audio and others that can be applied to the video. The small number of standard audio effects can be easily increased if you use the Ladspa plug-ins (see this page [96] to know how to load them).

To know in detail all effects and how they works, you can have a look at this page [97].

In this guide we'll know how to apply a "Greyscale" effect to a clip. This effect, as the name indicates, will take out colors from the video and display it in black & white (well, really using black, white and different grey tones! ).

Normally, except some of them, the effects apply to a full clip so, if you want to limit the effect to just a part, you need to create "subclips" as explained before in this page.

So let's go to clip in track #2. Select it and click the right mouse button. In the context menu select Add Video Effect -> Greyscale. You'll see immediatly how the colours in your clip dissapear and are replaced by grey tones!

In the same way as transitions, you can also edit the effect parameters. To do so, select the "Effect Stack" tab in the Project Panel. Unfortunately, the Greyscale effect is so easy that has no parameters!

But in this tab, you can also find some useful icons to organize the effects:

• to move the effect up in the list (that means it will be applied first to the clip)
• to move the effect down in the list
• to reset all effect parameters to the default values
• to remove the effect from the clip

You can see also that behind the effect name there's a checkbox. If you uncheck it, the effect will not be applied but still remains in the effect list with the selected parameters (if any!). This is useful if you want to use it later on.

And behind the "Parameters" tab, you'll notice another one titled "Keyframes". For some effects, you can select as many keyframes as you need in the clip and for each keyframe you can define different parameters. This is useful if you want, for example, mute a part of a clip. You can do so in two ways:
- Creating a subclip and applying the "Mute" audio effect to this subclip
- Or using the "Volume" effect. This can be applied to the full clip and, by defining different keyframes you can adjust the volume, for example, to start muted, then increase progressively, then continue at normal level, then decrease progressively and become muted, continue muted for a time and start again progressively ...

To know more about keyframes and how to work with them see this page [102]

Rendering your work

At this point we are ready to render our project and see how it looks on our TV, PC, ... If you've followed the steps until now, your screen should look like this one:

You have a title clip in track #0 with a crossfade transition between it and the other clip in track #1. Another transition (this one made by you!) between this clip and the one in track #2 and a greyscale effect applied to this clip.

Now follow some steps to create a DVD with this project. With Kdenlive you'll be able to easily create a DVD video structure and burn it (if you have installed the program k3b [105]). You will also add a simple menu with chapters and even with an intro movie if you like.

To create a DVD video, you can follow these steps:

- Select the menu option Render -> Export to DVD. - You'll be presented with a window to enter export details:

- In this screen you should enter the folder name where the DVD structure should be created and the DVD format (PAL/NTSC). Be sure that the option "Render file now" is selected.

As you can see, in this screen it's also possible to define the DVD chapters and also to create the DVD from an existing video file (.VOB), but for the moment we are not going to use these options. For further details see this page [107].

- Press the "Next" button. In the following dialog you can select to create a DVD menu or not. If you want to, check the "Create Menu" option and the rest of the data will be accessible.

You can choose to use a plain colored screen for your menu (click on the color box to select it), an image file or even a movie file (enter the path and name if selected). Also, you can define a pause between chapters if you have created such.

In the "Buttons" tab you can define the title text, font and size and the different colors for the button depending on status (not selected, selected, pressed).

In the "Intro" tab you can indicate a video file to be presented before the menu appears in the screen (like an introduction video).

- When you've entered data, press again the "Next" button. Kdenlive is now ready to generate the DVD using the program DvdAuthor [109]. Click on "Generate DVD" to do so.

A message will appear telling you to continue working while the video is generated. You can see progress in the "Status Bar".

When the process is finished, you may choose to work with the generated DVD externally (you'll find the Audio & Video directories in the specified path) or return again to this screen by selecting menu option Render -> Export to DVD. If you decided to go on with Kdenlive, you'll have options to directly burn your video (using k3b [105]), preview it (using Xine [111]) or edit again the structure (using QDvdAuthor [112]).

Congratulations! You've created your first video with Kdenlive. Enjoy it and continue reading to know more about this program and its advanced features.

Config Wizard

On the first run, a config wizard appears to guide the initial configuration process.
[113]

The wizard first inspects the version of MLT [41] installed on the system. MLT is the engine which performs the heavy lifting in Kdenlive, so it is critical that the correct version of MLT is installed and working correctly.
[114]

MLT in turn relies on FFmpeg [115] to handle various types of audiovisual material. The wizard displays the capabilities of the local FFmpeg installation, because this essentially determines the type of video material Kdenlive can handle.
[116]

Next, the default video profile is selected. The wizard suggests 1080p HDV high definition.
[117]

If your camera or computer are a little older, regular standard definition might be more suitable. Click the DV radio button to hide the high definition options and select an appropriate SD profile.
[118]

The additional settings panel presets some of the most important user interface options. Any of these can later be changed in the application preferences window.
[119]

Finally, checks are performed for several key third party tools. These may not be critical for your application, depending on the exact feature set you require from Kdenlive.
[120]

Once the wizard is complete, the main window appears.

Main Window

This is the default main window layout which appears when starting Kdenlive. The layout is fully configurable, but this tutorial assumes the default is being used.

[121]

Other Features

This section is an unordered collection of pages. Each one describes a feature in Kdenlive, but I've not yet decided how to organize them into the manual.

• Menu Items
  • File->DVD Wizard
  • File->Transcode Clip
  • Edit->Paste (Effects)
  • Edit->Find
  • Project->Transcode
  • Project->Clip Properties
  • Project->Settings
  • Clip->Markers
  • Clip->Split Audio
  • Clip Speeds
  • Guides
  • Grouping
  • Monitor Zone
  • Snapping Behavior
  • Project Profiles
  • missing clip handling
• Desktop integration
  • nepomuk search
  • GHNS (lumas, profiles)
  • Notifications
• Effect types
  • video
  • color
  • slideshows
  • titler
  • Generators
• Data Blobs
  • Lumas
  • XML effect files
  • XML export profiles
  • mime types
• Tools
  • Select
  • Razor
  • Spacer
• Timeline view
  • timecode
  • keyframes for effects
  • thumbnails
  • manipulate tracks (add, delete, types, mute a/v, lock, set height)
  • nudge trims
  • add transitions
  • audio fades
• Render
  • Profiles
  • Destinations
  • ffmpeg options
  • scripts
  • job queues
• Config
  • KConfig option list
  • rc files
  • devices (sdl, v4l, firewire, jogshuttle)
  • tools (mlt, ffmpeg, sox, frei0r, dvdtools)