# The Kdenlive Quick Start Guide

This documentation was converted from the KDE UserBase Kdenlive/Manual/QuickStart page.
&FDLNotice;
2019-05-07
Applications 19.04

KDE multimedia video

## Quick Start

### Creating a new project

Kdenlive directory structure

Kdenlive directory structure

The first step is creating a new (empty) folder for our new project. I will call it `quickstart-tutorial/` in this tutorial. Then get some sample video clips, or download them from here:kdenlive-tutorial-videos-2011-avi.tar.bz2 (7 MB)

If you prefer Theora (which you probably don’t since Ogg Video usually causes problems), you can alternatively download kdenlive-tutorial-videos-2011-ogv.tar.bz2.

, and extract them to ⪚ a `quickstart-tutorial/Videos/` subfolder inside the project folder.

The image on the left shows the suggested directory structure: Each project has its own directory, with video files in the `Videos` subdirectory, audio files in the `Audio` directory, &etc; (read more)

(The tutorial from now on assumes that you use the sample videos provided, but it works with any.)

New Project dialog

New Project dialog

Open &kdenlive; and create a new project (File New).

Choose the previously created project folder (`quickstart-tutorial/`) and select an appropriate project profile. The video files provided above are 720p, 23.98 fps.

720 is the video height, p stands for progressive scan in contrast to interlaced video, and the fps number denotes the number of full frames per second.

If you are using your own files and don’t know which one to use, &kdenlive; will suggest an appropriate one when the first clip is added

Provided Configure Kdenlive Settings under Misc is set to Check if first added clip matches project profile

, so you can leave the field on whatever it is.

### Adding clips

Project Bin: Adding video clips

Project Bin: Adding video clips

Now that the project is ready, let’s start adding some clips (&ie; the ones you downloaded). This works via the Project Bin widget; a click on the Add Clip icon directly opens the file dialog, a click on the small arrow shows a list of additional clip types that can be added as well. Video clips, audio clips, images, and other &kdenlive; projects can be added via the default Add Clip dialog.

Kdenlive window with the tutorial files

Kdenlive window with the tutorial files

After loading the clips, &kdenlive; will look similar to this. On the top left there is the already known project tree. Right of it are the monitors that show video; The clip monitor displays video from the original clips, the project monitor shows how the output video will look, with all effects, transitions, &etc; applied. The third, also very important, item is the timeline (below the monitors): This is the place where the video clips will be edited. There are two different types of tracks, Video and Audio. Video tracks can contain any kind of clip, audio tracks as well – but when dropping a video file to the audio track, only the audio will be used.

Saving a Kdenlive project

Saving a Kdenlive project

Let’s save the work via File Save. This saves our project, &ie; where we placed the clips on the timeline, which effects we applied, and so on. It can not be played.

To be correct, it can be played using `melt yourproject.kdenlive`, but this is not the way you would want to present your final video since it is (most likely) too slow. Additionally, it only works if melt is installed.

The process of creating the final video is called Rendering.

### Timeline

See also Timeline section of the manual

Now comes the actual editing. Project clips are combined to the final result on the timeline. They get there by drag and drop: Drag some Napoli (assuming you are using the files provided above, as in the rest of this quick start tutorial; If not, please make sure your screen is waterproof, and perhaps tomatoproof) from the project tree, and drop it onto the first track in the timeline.

First clips in the timeline

First clips in the timeline

Since some cutlery is needed as well, grab the spoon clip and drop it on the first track as well. Then drag the Napoli to the beginning of the timeline (otherwise the rendered video would start with some seconds of plain black), and the Spoon right after the Napoli, such that it looks like in the image on the left. (Where I have zoomed in with &Ctrl;Wheel.)

Timeline cursor

Timeline cursor

The result can already be previewed by pressing Space (or the Play button in the project monitor). You will see the Napoli directly followed by a Spoon. If the timeline cursor is not at the beginning, the project monitor will start playing somewhere in the middle; you can move it by dragging it either on the timeline ruler or in the project monitor. If you prefer keyboard shortcuts, &Ctrl;Home does the same for the monitor that is activated. (Select the Project Monitor if it is not selected yet before using the shortcut.)

Resize marker

Resize marker

Since after eating comes playing, there is a Billiards clip. Add it to the timeline as well. For the first 1.5 seconds nothing happens in the clip, so it should perhaps be cut to avoid the video becoming boring. An easy way

Writing it this way suggests that there are several ways of cutting a clip. This is in fact true.

for this is to move the timeline cursor to the desired position (&ie; the position where you want to cut the video), then drag the left border of the clip when the resize marker appears. It will snap in at the timeline cursor when you move close enough.

Overlapping clips

Overlapping clips

To add a transition between eating (the Spoon) and playing billiards, the two clips need to overlap. To be precise: the second clip should be above or below the first one and end some frames after the second one begins. Zooming in until the ticks for single frames appear helps here; it also makes it easy to always have the same transition duration, five frames in this case.

You can zoom in by either using the zoom slider at the bottom of the &kdenlive; window, or with &Ctrl;Mousewheel. &kdenlive; will zoom to the timeline cursor, so first set it to the position which you want to see enlarged, then zoom in.

Transition marker

Transition marker

Now that the clips overlap, the transition can be added. This is done either by right-clicking on the upper clip and choosing Add Transition or, easier, by hovering the mouse over the lower right corner of the Spoon clip until the pointing-finger pointer is shown and the message Click to add transition appears. The latter, by default, adds a dissolve transition, which is in this case the best idea anyway since the Spoon is not required for playing.

The dissolve transitions fades the first clip into the second one. See also Transition section of the manual.

Let’s now add the last clip, the Piano, and again apply a dissolve transition. When adding it on the first track of the timeline, you need to click on the new clip’s lower left edge to add the transition to the previous clip.

#### Effects

Effect List

Effect List

The Piano can be colourized by adding an effect to it. Select the piano clip, then double-click the RGB Adjustment effect in the Effect List. If it is not visible, you can get it via View Effect List.

Once the effect has been added, its name will be added to the timeline clip. It will also be shown in the Properties widget.

Effect Stack with RGB adjustment

Effect Stack with RGB adjustment

To get a warm yellow-orange tone on the image, fitting the comfortable evening, blue needs to be reduced and red and green improved.

The values in the Properties widget can be changed by using the slider (middle mouse button resets it to the default value), or by entering a value directly by double-clicking the number to the right of the slider.

The Properties widget always refers to the timeline clip that is currently selected. Each effect can be temporarily disabled by clicking the eye icon, or all effects for that clip can be disabled using the check box at the top of the Properties widget (the settings are saved though), this is ⪚ useful for effects that require a lot of computing power, so they can be disabled when editing and enabled again for rendering.

For some effects, like the one used there, it is possible to add keyframes. The framed watch icon indicates this. Keyframes are used for changing effect parameters over time. In our clip this allows us to fade the piano’s colour from a warm evening colour to a cold night colour.

Keyframes for effects

Keyframes for effects

After clicking the keyframe icon (the clock icon framed in the previous image), the Properties widget will re-arrange. By default there will be two keyframes, one at the beginning of the timeline clip and one at the end. Move the timeline cursor to the end of the timeline clip, such that the project monitor actually shows the new colours when changing the parameters of the keyframe at the end.

Make sure the last keyframe is selected in the Properties list. Then you are ready to flood the piano with a deep blue.

Moving the timeline cursor to the beginning of the project and playing it (with Space, or the Play button in the Project Monitor), the piano should now change the colour as desired.

Keyframing was the hardest part of this tutorial. If you managed to do it, you will master &kdenlive; easily!

See also Effects section of the manual.

#### Music

Audio fadeout

Audio fadeout

Since the clips do not provide any audio, let’s search for some nice piece of music, from your local collection or on web pages like Jamendo. The audio clip should, after adding it, be dragged to an audio track on the timeline.

The audio clip can be resized on the timeline the same way as video clips are. The cursor will snap in at the end of the project automatically. To add a fade out effect at the end of the audio clip (except if you found a file with exactly the right length) you can hover the top right (or left) edge of the timeline clip and drag the red shaded triangle to the position where fading out should start.

This shaded triangle is a shorthand for adding the effect Fade Fade out. Both ways lead to the same result.

### Rendering

Rendering dialog

Rendering dialog

A few minutes left, and the project is finished! Click the Render button (or go to Project Render, or press &Ctrl;&Enter;) to get the dialog shown on the left. Select the desired output file for our new video with all effects and transitions, choose MP4 (works nearly everywhere), select the output file location and press the Render to File button.

Rendering progress

Rendering progress

After some seconds rendering will be finished, and your first &kdenlive; project completed. Congratulations!

### Complete manual

Further documentation for the current version of &kdenlive; can be found in the full manual.

## Credits and License

Documentation Copyright see the UserBase Kdenlive/Manual/QuickStart page history

&underFDL;
&documentation.index;