Skip to main content

Installation and First Run

Get Kdenlive installed and configure it correctly for screencast tutorial production before you edit a single frame.

Core Idea

Installation takes 2 minutes. Configuration takes 5. The configuration step — especially setting the right project profile — saves hours of frustration later. Do not skip it.

Install Kdenlive​

Ubuntu / Debian​

# Recommended: Flatpak (always latest stable version)
sudo apt install -y flatpak
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install -y flathub org.kde.kdenlive

# Or via apt (may be older version)
sudo apt install -y kdenlive

Fedora / RHEL​

# Flatpak (recommended)
flatpak install -y flathub org.kde.kdenlive

# Or via dnf
sudo dnf install -y kdenlive

AppImage (any Linux distro)​

# Download from kdenlive.org, then:
chmod +x kdenlive-*.AppImage
./kdenlive-*.AppImage
tip

Use Flatpak for the most current stable release. Distro packages often lag 6–12 months behind.

Verify Installation​

# If installed via apt/dnf:
kdenlive --version

# If Flatpak:
flatpak run org.kde.kdenlive --version

Expected output:

kdenlive 24.x.x

First Launch: What You See​

When Kdenlive opens for the first time:

┌─────────────────────────────────────────────┐
│  Welcome / Splash Screen                    │
│                                             │
│  [ Open Recent ]  [ New Project ]           │
│  [ Open Project ] [ Sample Projects ]       │
│                                             │
│  What's New in This Version                 │
└─────────────────────────────────────────────┘

Action: Click New Project or press Ctrl+N.

Creating Your First Project​

warning

Always create a dedicated project folder before creating a Kdenlive project. Kdenlive stores the project file (.kdenlive) and uses relative paths to your media. Organizing from the start prevents broken links later.

Recommended folder structure for screencasts:
~/Videos/
  my-tutorial-01/
    my-tutorial-01.kdenlive    ← project file
    recordings/                ← raw screen captures
    music/                     ← background audio
    exports/                   ← rendered output

New Project Dialog​

Menu → File → New    (Ctrl+N)

Fields to configure:

FieldRecommended setting for screencasts
Project folderYour dedicated tutorial folder
Project nametutorial-topic-name
ProfileHD 1080p 30fps (matches most screen recordings)
Color profileBT.709 (standard for web/YouTube)
Profile Matching

Your project profile must match your screen recording resolution and FPS. If you recorded at 1920×1080 @ 30fps, select HD 1080p 30fps. Mismatched profiles cause blurry or slow-motion output.

Configure Kdenlive for Screencast Work​

Open settings: Ctrl+Shift+, (or Menu → Settings → Configure Kdenlive…)

Environment tab:

Default project folder → ~/Videos/

Timeline tab:

✅ Enable pause on seek
✅ Show audio thumbnails
✅ Show video thumbnails (In Frame)
Zoom speed: Medium

Misc tab:

✅ Check if first added clip matches project profile
Auto-save interval: 5 minutes

Proxy Clips tab (important for screencasts):

✅ Enable proxy clips
Proxy format: MPEG2 (fast decode)
Proxy size: 960×540 (half resolution)
Proxy Clips

Enable proxy clips when editing 1080p screencasts. Kdenlive creates lower-res preview copies so the timeline is smooth — the full resolution is used when rendering. This alone makes editing dramatically faster.

Set Up Your Keyboard Shortcuts​

Open: Ctrl+Alt+,

For screencast editing, ensure these shortcuts are active:

Space           → Play/Pause (default)
J / K / L       → Rewind / Pause / Forward (default)
X               → Razor Tool (default)
S               → Selection Tool (default)
G               → Add/Remove Guide (default)
I               → Set Zone In (default)
O               → Set Zone Out (default)
Ctrl+Enter      → Render (default)
Ctrl+Z          → Undo (default)
Ctrl+Shift+Z    → Redo (default)
tip

You can search for any action in Ctrl+Alt+, — type the action name in the search box to find and set its shortcut quickly.

When recording your own Kdenlive screencasts, a dark theme reduces glare and looks professional:

Menu → Settings → Color Theme → Breeze Dark

Or via keyboard search: Ctrl+Alt+I → type "color theme" → select Breeze Dark

Hands-On Practice​

1. Install Kdenlive via Flatpak:
   flatpak install flathub org.kde.kdenlive

2. Create project folder:
   mkdir -p ~/Videos/test-project/recordings

3. Open Kdenlive → Ctrl+N (New Project)
   - Set folder to ~/Videos/test-project/
   - Set profile to HD 1080p 30fps

4. Open Settings (Ctrl+Shift+,) and enable:
   - Auto-save: 5 min
   - Proxy clips: enabled

5. Open shortcuts (Ctrl+Alt+,) and verify:
   - Space → Play/Pause
   - X → Razor Tool
   - S → Selection Tool

6. Save the project: Ctrl+S
   Check that a .kdenlive file appears in ~/Videos/test-project/

What's Next​