Mastodon

The Library is Kdenlive’s way to copy and paste sets of clips and transitions between different projects. As its name already hints at: it is not just a clipboard, but instead it is a library for all the things you in more than a single project. The Library came to life around Kdenlive 15.04 or so. Let’s right dive into how to use the library in your daily Kdenlive workflow!

Step 1: Copy Stuff to Your Library

Library pane

The Library is Kdenlive’s central place for copying and pasting between projects.

If you don’t see yet the library pane, make sure to display using View > Library.

The library should look slightly familiar, as it looks similar to the project bin. However, while the project bin changes with each project, the library is independent of your projects. It’s always the same library, there’s only one of it.

A quite useful Kdenlive window layout is to group the library together with the project bin, and optionally the project notes. This way, you don’t need extra screen space for the library, yet it is no further away than just a single click.

Select clips and transitions in timeline

Next, select some timeline clips (together with their effects), as well as transitions, in the timeline. You can load an existing project and select some timeline clips and transitions at any time in order to copy it into your library. There is no separate import. Simply load a project or create a new one.

Bookmark: copy timeline selection to your library

Switch to the library pane, if you haven’t yet done so. Then press the bookmark button (Add Timeline Selection to Library), which is located at the bottom of the library pane. It’s the third button from the left.

Name your library clip

Kdenlive now asks you to name your new library item. Give it some name, and click OK to copy the selected timeline clips (with effects) and transitions into your library.

Please note: at this time, the names of library item need to be valid filenames.

Organize your library using folders

Of course, you can even neatly organize your library items into folders, and subfolders. This is similar to what you may have come to known from Kdenlive’s (project) bin, where you also can use folders to organize your project (source) clips.

Use the Add Folder button at the bottom of the library to create a new folder. You can rearrange library items and folders at any time by simple dragging them into their new place.

Step 2: Paste Library Item into (New) Project

Add library clip to your project

Now switch to another Kdenlive project by loading it, or alternatively start with a fresh project from scratch. Next, go to the library pane and select the library item you want to paste into your project. Then, press the Add Clip to Project button (up to Kdenlive 16.08.1 this is instead the “+” button, located in the same place).

Library clip added to project bin

Your project bin now contains the new library item you’ve just added.

You can rename library items at any time: right click > Rename Library Clip.

Step 3: Drag Library Item into Timeline

Drag your library clip into the timeline

The selected library item has now been added to your (project) bin. You’ll see this by switching to the (project) bin pane. You still have only a single (library) clip at this stage. You can now drag it into the timeline, whereever you want.

Please note: you cannot directly drag a library item from the library into your timeline. You always need to add it to your project bin first.

Step 4: Expand Library Clip

Expand clip in timeline to edit it further

Often, you next want to edit the contents of a library clip after you’ve placed it on the timeline. Expanding means that you want to break up a library clip into its contents for further editing. So, simply select the library clip in the timeline. Then choose Timeline > Current Clip > Expand Clip.

Expanded library clip, ready for editing

Done! You can now edit the expanded contents as you would edit any other timeline content.

You may now remove th library clip from the project bin

Kdenlive has expanded all the clips inside the library item into its own bin folder. This bin folder has the same name as the library clip, but without the .mlt extension.

After successful expansion, you may now remove the original library clip from your bin. It’s not needed anymore (as you can also tell from the missing reference count).

Clip Expansion Details

Kdenlive up to 16.08.2: expand up

Before Kdenlive 16.12.0, library clips will be expanded from the bottom up; which may be counter-intuitive (depending on your point of view). Here, bottom up means that in case a library clip contains multiple tracks, then you need to place the library on a lower track so there is room above for the clip to expand.

Kdenlive 16.12 and later: expand down

From Kdenlive 16.12.0 on, the contents of the library clip will be expanded down from the track where it has been placed on and below. That is, place your library on an upper track with suitable room below.

Anyway, if there aren’t enough tracks below the library clip, yet there are enough tracks in the timeline, then Kdenlive will attempt to shuffle the library clip up a number of tracks, before then expanding it.

In any case, to expand a library clip into its contents, you’ll always need necessary free space in the timeline. This means that there cannot be any clips or transitions within the start and end of the library clip on as many  adjacent tracks as to be needed when expanding a multi-track library item. Simply put: just make sure that the library item has room to expand, otherwise there can be other clips and transitions above and below the library clip, they just need to be out of the area of expansion.

Expand clip immediately below a transition

Please note: starting with Kdenlive 16.12.0, you can also expand a library immediatedly below a transition; that is, the library clip is on the next lower track in the timeline. This is useful for such cases where you, for instance, have a clip running the full length of your project on the topmost track and showing your company logo, channel logo, or something similar. If you then use an explicit transition added to this clip over compositing, you can still correctly expand the library clip on the second-topmost track.

Configuring Your Library Storage Location

Configure the filesystem location of your library

All items in your Kdenlive library are stored in a user-configurable place inside your file system. The default location, unless configured otherwise, is where your other semi-temporary caching data is stored. Typically, this is $HOME/.cache/kdenlive/library. You library clips are then stored inside this directory, as well as in subdirectories in case you also use library folders.

To change the location of your library, go to Settings > Configure Kdenlive. Next, select the section Environment. Switch to the Default folders tab. Locate the part titled Library folder, and deselect the option Use default folder. Select or enter another location for your Kdenlive library.

Please note: Kdenlive won’t move existing library files to the new location you’ve set. You’ll need to do this manually using a file browser or from the command line.

Technical Background

Kdenlive’s library items are kind of simplified project files. More specific, they are so-called MLT playlists. These are XML files, so you can easily look at them to find out more about them. Playlists, as opposed to full-blown Kdenlive projects, lack certain project information, such as clip markers and timeline guides. Also, Kdenlive does not support exporting track effects into playlists.

So, Kdenlive’s library is a neat user interface around exporting timeline clips with their effects, as well as transitions into MLT playlist files, and later for importing them into another project. You may have already wondered what Timeline > Save Selection is good for? It’s the export mechanism underlying the library. The library just makes it easier to use as you don’t need to worry about where to store all your library clips.