Skip to content

Quick Start

Get up and running with your first screen recording in just a few minutes.

Starting the Application

Launch Kartoza Screencaster from your terminal:

kvp

You'll see a splash screen followed by the main menu.

Your First Recording

Step 1: Select "New Recording"

From the main menu, use the arrow keys to navigate and press Enter to select New Recording.

Main Menu
→ New Recording Recording History Options Quit

Step 2: Configure Recording

Fill in the recording details:

  1. Title - Enter a descriptive title for your video
  2. Episode Number - Auto-incremented, or set manually
  3. Topic - Select from predefined topics
  4. Recording Options - Toggle audio, webcam, screen capture
  5. Monitor - Select which monitor to record
Recording Setup
━━━━━━━━━━━━━ Recording Setup ━━━━━━━━━━━━━ Title: My First Recording Episode: 1 Topic: QGIS sketches Recording Options [✓] Record Audio [○] Record Webcam [✓] Record Screen [○] Vertical Video [○] Add Logo Overlays Monitor Selection → DP-1 (2560x1440) HDMI-1 (1920x1080) [ Go Live ] [ Cancel ]

Step 3: Start Recording

Navigate to Go Live and press Enter. A countdown will appear:

Countdown
███████ █ █ ███████ █ █ ███████ Get ready... Recording starts soon! Press ESC to cancel

Step 4: Recording in Progress

Once recording starts, you'll see the recording screen:

Recording
● REC 00:05:23 [ Pause ] [ Stop ] p: pause • s: stop • space: toggle button

Step 5: Stop Recording

Press S or select Stop to end the recording.

The application will automatically process your video:

  1. Merge video and audio streams
  2. Apply logo overlays (if enabled)
  3. Generate metadata
  4. Create vertical version (if enabled)

Step 6: View Your Recording

Your recording is saved to ~/Videos/Screencasts/<topic>/<title>/

The folder contains:

  • final.mp4 - Your processed video
  • metadata.json - Recording information
  • Raw recording files

Keyboard Shortcuts Summary

Key Action
Up / K Navigate up
Down / J Navigate down
Enter / Space Select / Confirm
Tab Next field
Shift+Tab Previous field
P Pause recording
S Stop recording
Q / Esc Quit / Back

Next Steps