User manual

This represents Kdenlive user manual as of December 2008. Since that time the focus of the Kdenlive user manual has switched to the KDE UserBase Wiki. http://userbase.kde.org/Kdenlive/Manual/Introduction
The KDE UserBase is the active version of the manual (Dec 2012)

Kdenlive user manual is a collaborative book written in English.
After review, it will be translated to several languages using our translation server.

Copyright © 2003 Jason Wood.
2nd edition organized by Fabricio Rocha, March 2007
Migration to kdenlive web site by Jean-Michel Pouré, collaborative work, December 2008

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".

History
Pre December 2008 - the community used a wiki at en.wikibooks.org
December 2008-May 2011‎ Migrated the text from the en.wikibooks.org wiki to Drupal and this web site.
May 2011- to Date. Manual developed at http://userbase.kde.org/Kdenlive/

Introduction

To be written.

Downloading and installing kdenlive

Pre-compiled packages

When downloading packages, make sure to install Kdenlive 0.7.7.1 and MLT video engine 0.5.6. To benefit from a full translation into your language, you will also need kde-i18n packages for your language.

Special message for package maintainers: Kdenlive 0.7.7 and previous versions are deprecated. Please upgrade to Kdenlive 0.7.7.1, which relies on MLT 0.5.6 and therefore is much more precise. We will not answer bug reports for Kdenlive 0.7.5 and previous versions.

Please report any problem in our forum:
http://kdenlive.org/forum/users-forums/installation-binary-packages

Whenever you install packages, make sure to uninstall any previous installation using the Builder wizard.

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.

 

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/ unstable main contrib non-free
deb http://ftp.fr.debian.org/debian/ 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 sid main
deb http://www.debian-multimedia.org 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

Gentoo packages

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

A basic install of KDE4 is needed, check the Gentoo KDE 4 Guide 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.

 

Any feedback would be appreciated:

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

Slackware packages

slacklogo

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/
  • 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 (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 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 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 and Kdenlive.

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 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):

# 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 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

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

Feedback

Please make your feedback here:
https://forum.kde.org/viewtopic.php?f=269&t=113710

Installing from source

Kdenlive is at the crossroads of several free software libraries providing multimedia services. Therefore, the compilation process is rather long. It makes sense to at least get the development version of MLT and ffmpeg as well since these projects (especially MLT) are closely connected. If you need some new effects from frei0r, SoX, or another resource, you may want to compile it as well.

Make sure to install the components in the right order (as listed here), and to complete each step before starting with the next one.

Please report any compilation problem on our Forum: Installing from source.

Build Script

As an alternative to this manual procedure, there is a build script 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.

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 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 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 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 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.

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...

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. (release before 0.9 are still available on our SourceForge page).

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 | Quickgit).

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.

Live demonstration on DVD or USB-storage

Running Windows and willing to test Kdenlive?

Update 14th of september 2010:
The live DVD and USB versions are outdated and should not be used anymore.

We provide a live demonstration which boots on DVD or USB mass-storage, and offers your a selection of the best multimedia softwares ... without the need to install to hard disc. After booting, you will have access to your Windows hard drive to read, import and export media. So you can only use the USB key/DVD to boot into Linux, run Kdenlive and exit.

Should I choose live DVD or live USB?

Both USB key and DVD allow to read and write to a Windows 95/XP/Vista/7 hard drive.

If you have the choice, we recommend you to choose to build an USB key. The USB Key will be able to memorize your configuration (keyboard, langage, etc...) and will allow you to install addition software, to the limit of available space on the USB key. The USB Key acts a a small hard disc and therefore is superior to a DVD.

The minimal size of the USB Key is 2Gb. A 4Gb key is recommended. Do not buy an expensive and large key as you will be able to read and write videos to your Windows hard disc. If you buy a larger key than 4Gb, you may be able to store your media. Your choice depends on your budget.

Download

The live demonstration is provided on DVD and USB mass-storage.

Choose an image and click to download:

Detailed information

Unless you choose to resize your hard disc or decide to install GNU/Linux, it will not modify your operating system and will execute in memory only. After shuting down your computer, your old operating system is back. See boot screenshots.

If you choose the USB mass-storage flavour, it will execute as fast as an installed GNU/Linux system and allow complex video editing. The live demonstration is intended for Windows and Intel MacOsX users, who may be looking for a free software solution.

The live demonstration provides a usable Gnome desktop with several audio and video applications:

  • Kdenlive 0.7.4 video editor with MLT 0.4.2
    with all existing audio and video filters.
  • Linux 2.6.30 kernel.
  • FFmpeg video codecs, including MPEG-2, MPEG-4 and H.264 codecs. Support for a wide range of containers: AVI, MP4, OGG, Quicktime, etc...
  • Blender 3D modeler
  • Audacity audio editor
  • Ardour audio station
  • All Xorg graphical drivers, including latest ATI and Nvidia accelerated cards.
  • Nvidia VDPAU hardware decoding extensions. mplayer and mencoder provided. Kdenlive cannot yet use VDPAU. To play with VDPAU, download footage from our camcorder database and mplayer -vo vdpau -vc ffh264vdpau path/to/file.
  • Compatible with Virtual box, Qemu and VMware virtualizers (guest modules and graphical drivers included).
  • Gparted partition resizer with support for FAT16, FAT32, NTFS, HFS+, UFS and many other files systems.
  • And much more ...

The live demonstration will be upgraded to Kdenlive 0.7.6 as soon as Debian fixes some packaging issues. Stay tuned.

This live demo also includes a Debian installer. Read our guide and make sure you understand what you are doing. Before resizing partitions or installing GNU/Linux, you should make a complete backup of your system.

Preparing the media

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

Burning the Live DVD

This section describes how to burn a live DVD.

GNU/Linux

You can use GnomeBaker to burn the DVD:

  1. Select the 'Tools' menu, then "Burn DVD image'.
  2. Select the DVD image and Click 'OK'.
  3. In the dialog, click 'OK' to burn.

Windows

Download and install Infrarecorder, a free and open source image burning program:

  1. Insert a blank DVD in the drive and select Do nothing or Cancel if an autorun dialog pops up.
  2. Open Infra Recorder, and select the 'Actions' menu, then 'Burn image'.
  3. Select the live DVD image file you want to use, then click 'Open'.
  4. In the dialog, click 'OK'. 

MacOsX

Use Apple's Disk Utility (Disk Copy in older versions)

 

Preparing the Live USB mass-storage

This section describes how to transfer the Live image to a USB mass-storage.

Warning: do not use u3 compliant USB keys

Some new USB keys have a bootable hidden partition, called "u3", which cannot be deleted. Most Sandisk USB keys are u3 compliant. These keys will need to be erased using proprietary software to gain full access. Avoid these keys or your computer will not be able to boot the USB key. To remove use http://u3uninstall.s3.amazonaws.com/U3Uninstall.exe (Windows) or http://communities.sandisk.com/sandisk/board/message?board.id=u3&thread.... (Mac).

Warning: low quality USB keys

If you are running Windows, some USB keys may be bootable after using "HP USB disk storage format tool" to reformat the key :
http://h18000.www1.hp.com/support/files/serveroptions/us/download/23839....

Requirements

The USB mass-storage can be a USB key, a USB disc or a USB stick. Your bios should be recent enough to boot on USB media. The USB mass-storage size should be equal or larger than 2Gb.

WARNING: DURING OPERATION, YOU WILL LOOSE THE WHOLE  CONTENTS!

GNU/Linux

Plug-in your USB mass storage. Try to identify the device node. If you are not used to command lines, run gParted:

  1. In the menu 'Gparted', select 'Devices'.
  2. Select the USB mass-storage and note the device path: /dev/sdX where X is a letter.
  3. Right click on the USB mass-storage and click unmount.
  4. Quit Gparted.

Now use the dd command line utility to write the mass-storage. Make sure that you overwrite the whole device, not just the first partition of it that you normally mount, i.e. /dev/sdX instead of the more familiar /dev/sdX1. As root, enter:

dd if=$DOWNLOAD.img of=$USBDRV

where $DOWNLOAD is the image that you downloaded and $USBDRV is the device node of your USB key, in the above example /dev/sdX and not /dev/sdX1.

Windows

Download and install WinRaWrite, a free software to copy the Live image onto a Usb mass-storage.

  1. In floppy drive, select your USB mass-storage
  2. Click on Image File and select the downloaded image.
  3. Click on 'Write'. Click 'Exit' when finished.

Please note that after this step your USB mass-storage will be unreadable by Windows.

Warning: do not unplug your USB key until Windows finished data transfer. Right clic on the USB key to unmount the key. Windows should inform you that the key may be safely removed. Or your USB key may be unreadable.

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

Support

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

How to build a Debian Live demonstration

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

Source code

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

Virtualbox images

For testing purpose, we provide Virtualbox images.

The image includes:

  • 100 Gb virtual hard disc
  • A GNU/Linux Debian system
  • Virtual guest addition
  • Recent Kdenlive packages
  • A set of multimedia software

The images are provided in two flavours:

Kdenlive 64 bits guest

Use this guest if your system is installed with a 64bits host.
Download:

Do not install a 64bits guest in a 32 bits host. It will not work.

Kdenlive 32 bits guest

This version is in preparation. Stay tuned.

Installation

Visit http://www.virtualbox.org and install Virtualbox from the download page:
http://www.virtualbox.org/wiki/Downloads

If you are using GNU/Linux, Virtualbox is already part of most distributions.

Then run Virtualbox and select "Import virtual environment" from the file menu. Follow the wizard.

If you share a directory called "kdenlive" on the host, it will be visible on the guest.

After booting-up, go to System->Preferences->Keyboard and select a Keyboard compatible with your country.

Passwords

Daily user: kdenlive(username)/kdenlive(password)
Administrative user: root(username)/kdenlive(password)

Limitations

Virtualbox is not able to virtualize firewire ports. Therefore you will not be able to capture from your camcorder. You will be able to play DV and HDV files, not AVCHD. Be aware that this is only a demo package for demonstration of Kdenlive AND GNU/Linux. We do not think that running Kdenlive in a virtualbox is a suitable solution for daily work.

Quickstart guide

This section explains how to run Kdenlive for the first time and describes how to edit a simple movie.

Kdenlive first project

*** WIP. This page is not yet finished and based on an earlier version. Feel free to update ***

 

Kdenlive layout

 

When you first start Kdenlive, you will have a window looking something like this :

The Kdenlive main window

 

In the default layout, there are five docks in the main window. Whilst all docks in Kdenlive are fully configurable, it is assumed for this tutorial that you are using the default layout.

The Project Panel

The panel to the top left holds various informational and editing tabs about the current project:

The first one is the Project Tree tab. The Project Tree shows the video clips, images, slideshows, colour clips and title clips that belong to your project.

Second tab is the Effect Stack tab. If you have different effects applied to your clips, in this tab you will be able to define the order in which they are applied and also parametrise them.

Third tab is the Transition tab. On this tab, you can change different parameters for a transition.

 

Effect List Panel

The Effect List panel list your available audio, video and custom effects. From here, you can select any of them and apply to your project.

 

The Monitor Panel

The third panel from the left, holds the different monitors available in Kdenlive.

The Clip monitor is used to preview clips and to select a section of a clip to add to the timeline.

The Project monitor displays the final video - what your final edit will look like.

The Capture monitor allows you to directly capture video from a number of sources: A camcorder connected to your computer Firewire port, a Video4Linux source (as a webcam or tvcard), or a screen capture (you'll need recordmydesktop utility)

 

The Undo Panel

The top right panel is the Undo History, which shows your editing history and allows you to undo/redo any editing action.

 

The Timeline

The bottom panel in the window holds the timeline. The timeline gives you a visual representation of your project, and shows when clips start, when they end, and in the case of overlapping clips, which one is actually being used. The timeline can contain multiple audio and video tracks, where you can add sound and video clips respectively and other fancy stuffs (transitions, titles, ...)

A status bar is located at the bottom of the timeline. This bar provides information about your project and also holds some useful icons.

Image:Kdenlive_070_statusbar.png

You can use it to select the update or razor tool, zoom the timeline, toggle on/off the thumbnails for video and audio, and decide to show or not markers and snappoints. It also displays the timeline time of your cursor.

 

Now, to the video!

 

Now that you are familiar with the screen sections and buttons, it's time to create the basic configuration for a new project, add pieces of sound and video to it, move these pieces around, apply effects and transitions and so on ...

 

Project Settings & Preferences

The first time you use Kdenlive, you'll be asked for the basic settings for your projects. Afterwards, you'll be able to change these settings using menu option "Settings -> Run Config Wizard".

You'll need to setup your preferred video profile (DV, HDV, ...) and your working directory. Also, you can decide to use or not thumbnails for audio and video and if you want to activate the crash recovery option (recommended). Finally, this option will check your system to find the critical components needed to run kdenlive: FFMPEG, Dvgrab, Recordmydesktop & Inigo (part of MLT).

 

Using clips in your project

It goes without saying that to get any further, you will need to have some clips on your computer that you can use. To get some clips, you could go to 'YouTube', or capture them directly using either your video camera or TV-capture-device. For this section we assume that you already have some files available that are supported by Kdenlive (see supported formats in the features page).

Now that you have some clips, you can add them to your project. Select the Project List tab on the project pane, and then click on the "Add clip" icon (Image:Add_clip_icon.jpg) in the top right to bring up the context menu. From here, select "Add Clips" to bring up a standard KDE open dialog. Find your clips, select as many as you want to add (select more than one by holding the Ctrl key), and they will be added!

Your added clips will now appear in the project list, along with their duration and a few other pieces of information (like a thumbnail).

For the purpose of this Quickstart guide, and in order to show you the basic Kdenlive functionalities, we'll work with two of your clips, adding a title at the beginning, a video transition between them and a video effect to a part of one clip. Finally, we'll render the project to obtain a nice DVD ready to be burned and played on our TV.

[edit] Creating a title

Firstly, we are going to create a title clip for your project. Kdenlive is able to create simple titles. We can also work with external image editors (like GIMP) to create more sophisticated titles and then add them to the project list as explained above.

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

Kdenlive creating a title clip

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:

Image:Add_text_icon.jpg To enter the text

Image:Add_box_icon.jpg To draw a box

Image:Up_down_icons.jpg 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!

[edit] 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 (Image:Seek_marker.jpg) to where you want your clip to start and click the "inpoint" button (Image:Inpoint.jpg). Move the cursor to where you want the clip to end, and click the "outpoint" button (Image:Outpoint.jpg). 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.

[edit] 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: Image:Snap_to_icons.jpg

[edit] 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!

[edit] 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" Image:Next_frame.jpg and "Previous frame" Image:Previous_frame.jpg 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.

[edit] 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, 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 Image:Timeline_scale.jpg. 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:

Kdenlive: transition example

To have a real time view of how your transition works, you can click the seek marker Image:Seek_marker.jpg 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.

[edit] 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 to know how to load them).

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

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:

Image:Effect_up.jpg to move the effect up in the list (that means it will be applied first to the clip)

Image:Effect_down.jpg to move the effect down in the list

Image:Reset_parm.jpg to reset all effect parameters to the default values

Image:Remove_effect.jpg 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

[edit] 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 custom 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). 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:

Image:Create_DVD_1.png

- 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.

- 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.

Image:Create_DVD_2.png

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. Click on "Generate DVD" to do so.

Image:Create_DVD_4.png

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), preview it (using Xine) or edit again the structure (using QDvdAuthor).

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

First Project

This section is just a carved up version of the old quickstart document. It is not yet updated for Kdenlive 0.7.4+

Now that you are familiar with the screen sections and buttons, it's time to create the basic configuration for a new project, add pieces of sound and video to it, move these pieces around, apply effects and transitions and so on ...

In this tutorial, we'll work with two clips, adding a title at the beginning, a video transition between them and a video effect to a part of one clip. Finally, we'll render the project to DVD, ready for TV playback.

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 (Image:Add_clip_icon.jpg) and, in the context menu, select "Create Text Clip". A new window like this will be presented:Kdenlive creating a title clip

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:

  • Image:Add_text_icon.jpg To enter the text
  • Image:Add_box_icon.jpg To draw a box
  • Image:Up_down_icons.jpg 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 (Image:Seek_marker.jpg) to where you want your clip to start and click the "inpoint" button (Image:Inpoint.jpg). Move the cursor to where you want the clip to end, and click the "outpoint" button (Image:Outpoint.jpg). 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: Image:Snap_to_icons.jpg

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" Image:Next_frame.jpg and "Previous frame" Image:Previous_frame.jpg 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, 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 Image:Timeline_scale.jpg. 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:

Kdenlive: transition example

To have a real time view of how your transition works, you can click the seek marker Image:Seek_marker.jpg 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 to know how to load them).

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

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:

  • Image:Effect_up.jpg to move the effect up in the list (that means it will be applied first to the clip)
  • Image:Effect_down.jpg to move the effect down in the list
  • Image:Reset_parm.jpg to reset all effect parameters to the default values
  • Image:Remove_effect.jpg 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

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). 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:

Image:Create_DVD_1.png

- 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.

- 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.

Image:Create_DVD_2.png

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. Click on "Generate DVD" to do so.

Image:Create_DVD_4.png

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), preview it (using Xine) or edit again the structure (using QDvdAuthor).

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

Reference guide

This documents explains kdenlive features in detail.
To be written.

Kdenlive 0.7.4

This guide covers Kdenlive 0.7.4+ (SVN revision 3495). It starts with the initial run of the program and describes the various features available in the user interface.

Config Wizard

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

The wizard first inspects the version of MLT 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.

MLT in turn relies on FFmpeg 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.

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

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.

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.

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.

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.

Menu Bar

Kdenlive's menu bar doesn't really respect established user interface guidelines. Instead of documenting the current layout, this section will soon link to some change proposals.

File Menu

File handling.

Edit Menu

Copy, Paste etc.

Project Menu

Tool Menu

Clip Menu

Timeline Menu

Monitor Menu

View Menu

Settings Menu

Help Menu

Tool Bars

Kdenlive provides two toolbars, named Main and Extra. The bars may be docked, but not floated.

These toolbars are configurable, and a decent selection of actions are available, although there doesn't seem to be a way to create new custom toolbars.

Docking Panels

A total of 8 different docking panels provide access to many of the editing tools in Kdenlive. They may be docked, tabbed, floated, or hidden in any conceivable configuration.

Project Tree

The Project Tree shows the video clips, images, slideshows, colour clips and title clips that belong to your project.

Effect Stack

Effect Stack shows the different effects applied to a particular clip. In this tab you will be able to define the order in which they are applied and also parameterise them.

Transition

Transition allows editing the transitions between two clips on the timeline. Several types are available.

Affine Composite

Affine Composite provides keyframable animated affine transformations with dissolve functionality.

Composite

Composite provides dissolve functionality.

Luma

Luma provides wipe functionality.

Wipe

Wipe provides push wipe functionality.

Effect List

Effect List enumerates your available audio, video and custom effects. These can be applied to clips on the timeline.

Video Effects

Custom Effects

Custom effects are described below.

Clip Monitor

Clip monitor is used to preview clips in the project tree and to select a section of a clip to add to the timeline.

Project Monitor

Project monitor displays the final video - what your final edit will look like, including all clips, effects, and transitions on the timeline.

Record Monitor

Capture monitor allows you to directly capture video from a number of sources:

Firewire

A camcorder connected to your computer Firewire port

Video4Linux

a Video4Linux source (as a webcam or tvcard)

Screen Grab

a screen capture (you'll need recordmydesktop utility)

Undo History

Undo History shows your editing history and allows you to undo/redo any editing action.

Timeline Area

The bottom panel in the window holds the timeline. The timeline gives you a visual representation of your project, and shows when clips start, when they end, and in the case of overlapping clips, which one is actually being used. The timeline can contain multiple audio and video tracks, where you can add sound and video clips respectively and other fancy stuffs (transitions, titles, ...)

Status Bar

A status bar is located at the bottom of the timeline. This bar provides information about your project and also holds some useful icons.

You can use it to select the update or razor tool, zoom the timeline, toggle on/off the thumbnails for video and audio, and decide to show or not markers and snappoints. It also displays the timeline time of your cursor.

(This older image is missing the spacer tool, but there is a rendering glitch on my Kdenlive build which clips the status bar, so I went with this image)

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)

Troubleshooting and common problems

Here is a list of the most common problems users are reporting, with a solution.

Additional codecs are not available, only raw and avi DV

Kdenlive relies on the MLT video engine.
By default, MLT only handles DV.
To have access to a wide variety of formats, you will need to install codecs.

Installed the audio and video packages listes on the following page:
http://kdenlive.org/user-manual/downloading-and-installing-kdenlive/inst...

On some systems, you may need to install the package names 'ffmpeg-unstripped' instead of 'ffmpeg'.

Clip and project monitor only display still images, audio is present

Problem:

The clip and project monitor shows the correct frames when scrolling through a clip or project.

However, when a clip or a project is played the clip- and project monitor stay black, although the audio is played.

Solution:

The graphic card may not support hardware acceleration.

Disable use of hardware acceleration in Kdenlive settings. Look for the video driver used by SDL and try changing to x11 or to xvideo and see if it works. You need to restart Kdenlive after that change.

More information:

http://www.kdenlive.org/mantis/view.php?id=541

I cannot render to a specific format (xvid, mpeg 4, flash,...), it is unavailable

Problem

You cannot render to some format, the option is greyed out in the rendering dialog:

Solution

A greyed out profile means the video or audio codec is not installed on your computer. Kdenlive uses FFmpeg for all video rendering, so you must enable these codecs in FFmpeg.
Step 1

  • If you are using distribution packages, install the full versions of FFmpeg libraries. on Debian style distros, you may need to do something like:
    sudo apt-get install libavcodec-unstripped-52 libavdevice-unstripped-52 libavfilter-unstripped-0 libavformat-unstripped-52 libavutil-unstripped-49 libpostproc-unstripped-51 libswscale-unstripped-0
  • If compiling from source, please check the configure flags to enable the missing codec.

Step 2
After installing those missing libraries, you must run the "Config Wizard" [1] that can be started from Kdenlive's Settings menu. Then restart Kdenlive and the rendering profile should be available now [2].

[1]

[2]

Kdenlive is not fully translated

Part of Kdenlive translation is fetched from KDE standard interface.
This is the case for strings like "Open file ...", etc.

Install kde-l10n-YOURLANGUAGE package to benefit from a full translation into your language.

Sound is bad and delayed

This problem was reported on Ubuntu stations, which use PulseAudio.
We recommend using the PulseAudio backend to SDL or removing PulseAudio and using only Alsa drivers.

Install the PulseAudio backend for SDL

Kdenlive uses SDL for audio and video output. However, there appears to be a problem somewhere between SDL, ALSA, and PulseAudio. One possible remedy is to install the PulseAudio backend for SDL, if it is available on your distribution. For Debian and Ubunutu based distributions, try this:
sudo apt-get install libsdl1.2debian-pulseaudio

If that does not help, make sure you have set the Audio Driver to Auto in Kdenlive settings. Also, try restarting Kdenlive and possibly reboot your computer to reset everything. If that does not work, then consider removing PulseAudio per the directions below.

Remove PulseAudio

Remove the added lines to /etc/asound.conf.
If /etc/asound.conf did not exist when you installed PulseAudio, you may remove /etc/asound.conf entirely.

After this, you may remove all of the installed PulseAudio packages:
sudo apt-get install esound
will remove PulseAudio packages.

To disable pulseaudio you may need to select alsa for for all options in /system/preferences/sound

Log-out and start a new session.
Then test Alsa drivers using this command:
speaker-test -Dplug:surround51 -c6 -l1 -twav to test if

Enable Alsa in Kdenlive

Select Alsa as an audio driver.

Troubleshooting firewire capture

If you experience Firewire problems, please follow these steps:

Which firewire stack is installed ?

GNU/Linux recent kernels may be compiled with an old or a new firewire stack. To understand which firewire stack is installed, query the list of loaded modules

lsmod | egrep 'firewire|1394'

This is the old firewire stack:

ohci1394   37040  0
ieee1394   306104  2 sbp2,ohci1394

This is the new firewire stack:

firewire_sbp2          15152  0
scsi_mod              163832  5 firewire_sbp2,sg,sr_mod,sd_mod,libata
firewire_ohci          23140  0
firewire_core          39492  2 firewire_sbp2,firewire_ohci
crc_itu_t               2288  1 firewire_core
 

Old firewire stack

Make sure to load modules at boot time:

sudo gedit /etc/modules
raw1394
video1394
dv1394

Fix udev permissions

# ieee1394 devices
KERNEL=="dv1394*",      NAME="dv1394/%n"
KERNEL=="video1394*", NAME="video1394/%n"

If you still cannot capture from firewire, there may be a bug in udev permission.

Locate the udev configuration file responsible of firewire access.

KERNEL=="dv1394*",    MODE=”0666″,      NAME="dv1394/%n"
KERNEL=="video1394*", MODE=”0666″, NAME="video1394/%n"

 

New firewire stack

Write a custom udev script and store it in /etc/udev/rules.d/z95_firewire.rules:

# /etc/udev/rules.d/z95_firewire.rules

# Set GROUP="video" for some IEEE 1394 device types, driven by the new firewire stack.
# We cannot use the GROUP directive because the significant device type attributes
# live in child devices. So change the group after the fact with chgrp.

# IIDC devices: industrial cameras and some webcams
KERNEL=="dv1394*|video1394*|raw1394*|fw[0-9]*",    GROUP="video"

# libraw1394 older than v2.0.1 and some special-purpose applications also need
# access to the local node(s).  Alas there is no simple way to tell local nodes apart
# from remote ones; here is a simple hack.

SUBSYSTEM=="firewire", ATTR{vendor_name}=="Linux Firewire", GROUP="video"
# Or if your application needs access to all nodes, simply use:

SUBSYSTEM=="firewire", GROUP="video"

 

Debug and test using dvgrab

Your username should be part of the video group:

sudo adduser username-foo video

Reboot your system for rules to apply. After reboot, run dvgrab in interactive mode:

dvgrab -i

Type h for help. 

You should be able to rewind and play your camcorder.

If this is the case, enter "q" for quit dvgrab. Kdenlive should now be able to acquire video.

Using AVI clips from xfire (a Windows program)

When importing AVI clips from xfire you may getan error messaging saying that it isn't a support format. This is because xfire use a special codec inside avi files. You may have to transcode the clips in xfire(?) before you can load them into Kdenlive.

Why is the monitor transparent during playback, but works when dragging the timeline?

Try disabling compiz, if it is enabled. Try choosing a different background color in Settings -> Playback. If nothing helps, try starting kdenlive like this:

env XLIB_SKIP_ARGB_VISUALS=1 kdenlive

(or kdenlive_start, if using the build wizard).

Frequently asked questions

Here is a list of common questions:

Can I test Kdenlive on my Windows computer?

No: Not now but maybe someone will port it. Meanwhile you can run Kdenlive on any of the many free Linux distributions. Give it a try, you may like it so much that the question of running it on Windows becomes moot.
Yes: download a CD-boot only GNU/Linux distribution including Kdenlive 0.7.

How do I adjust the volume of a clip?

Apply the "volume" audio effect.

A line will show up in the waveform of the clip.

If you double click any point on that line, a new keyframe will be added in which you can adjust the level.

If you then double-click on the keyframe (it appears as a square on the line) you can then manually type in the desired level or shift the keyframe to an exact time.

How do I make a video crossfade/dissolve between two clips?

Kdenlive 0.7 does not have a video crossfade/dissolve transition by default.

You can either use a "composite" transition or a "luma" transition to achieve a crossfade.

For a luma transition, just use one that "looks right". With composite, you can get a real crossfade/dissolve by applying a composite transition, then add a keyframe to the end of the transition and set its opacity to 0.

For some more discussion of the composite transition, please see mantis issue 261.

How to add a transparent image to a project?

Add the image to the project, then double click on the image in the project tree.

This will show a dialog with an option saying "Transparent background". Just check that box, and then when the image is inserted in the timeline, an alpha transparency transition will be added automatically.

How to make a feature request for Kdenlive?

Create a bug report and set the Severity to "Feature." Also, there is a forum for discussing ideas.

How to participate in kdenlive project?

Kdenlive is constantly looking for contributors:

Is Kdenlive really free?

Kdenlive is free software in all meanings of the expression.

Is my camcorder supported by Kdenlive?

You can find a camcorder database at: http://kdenlive.org/video-editor
If your camcorder is not listed and you have tried it with Kdenlive, please enter it in the database so that other users know if it works correctly.

What is the quality of audio and video codecs?

Excellent: FFMPEG project is the most advanced project providing video and audio codecs.

What is the release cycle of Kdenlive?

We plan to release a stable version of Kdenlive every three months.

What is the size of Kdenlive community?

There is probably more than 1000 registered users on our forum. As it is Free software, we don't know exactly the size of the community. Recently, we registered on Google Analytics and will publish detailed statistics.

What's the best format to use for YouTube?

YouTube has introduced HD.

Use Kdenlive 0.7.1 as H.264 export is better. Refer to this document:
http://www.google.com/support/youtube/bin/answer.py?hl=en&answer=132460

These export profiles has been added to Kdenlive recently:

YouTube 1290x720 2000k
YouTube 640x480 800k

Please note:

It is recommended to create a project with the same resolution as the target export resolution.