View source for Kdenlive/Manual/Timeline/Editing/en

<languages/>

<!-- Please use level 3 top heading, i.e. "===" -->
===Editing===

Editing is done in the [[Special:myLanguage/Kdenlive/Manual/Timeline|Timeline]]. Add a clip by dragging it from the [[Special:myLanguage/Kdenlive/Manual/Projects_and_Files/Project_Tree|Project Tree]] or the [[Special:myLanguage/Kdenlive/Manual/Monitors|Clip Monitor]]. Once a clip is dropped on a track, it can be moved (drag and drop it) to another place on the same track or onto another track.

[[File:Kdenlive-addcliptotimeline.gif|center]]

With 19.08.0 editing with keyboard shortcuts was introduced. This will speed up the edit work and you can do editing steps which are not possible or not as quick and easy with the mouse. Working with keyboard shortcuts in 19.08 is different as in the former Kdenlive versions. Mouse operations have not changed and working as before. See [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#3 point editing|3 point editing]].

==== Seeking through your project ====

The timeline cursor shows your current position in the project. The positions of the cursors on the timeline ruler and Project Monitor are always in sync. Position can be moved in the following ways:

* Keyboard shortcut: right / left arrows for one frame, Shift+ right / left for 1 second

* Clicking/dragging in the [[Special:myLanguage/Kdenlive/Manual/Timeline|Timeline ruler]] or in an empty area of the timeline. 

* Clicking/dragging in the [[Special:myLanguage/Kdenlive/Manual/Monitors#Project Monitor|Project Monitor]] ruler. 

* Rotating the mouse wheel while the pointer is over the [[Special:myLanguage/Kdenlive/Manual/Timeline|timeline ruler]] or over the [[Special:myLanguage/Kdenlive/Manual/Monitors#Project Monitor|Project Monitor]] 

* Editing the timecode in the [[Special:myLanguage/Kdenlive/Manual/Monitors#Project Monitor|Project Monitor]]  timecode widget

* Clicking the up or down arrows on the [[Special:myLanguage/Kdenlive/Manual/Monitors#Project Monitor|Project Monitor]] timecode widget

==== Cutting a clip ====

To cut a clip, the easiest way is to place the timeline cursor where you want to cut the clip, then select the clip (left click in it) and use the menu <menuchoice>Timeline -> Current Clip -> Cut Clip</menuchoice> (default shortcut: <keycap>Shift + R</keycap>).

Or  <menuchoice>Right Click -> Cut Clip</menuchoice>

Alternatively - use the [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Razor_Tool|Razor Tool]].

==== Resizing a clip ====

A clip can be resized from its start or end by dragging its left or right edge. If you want a more precise resize, you can place the timeline cursor wherever you want the resize to end and use the menu <menuchoice>Timeline->Resize Item Start</menuchoice> (default shortcut: <keycap>1</keycap>) or <menuchoice>Timeline->Resize Item End</menuchoice> (default shortcut: <keycap>2</keycap>)

To even more precisely control the length of a clip, double click it in the timeline and adjust its duration using the '''Clip duration''' dialog. You can have frame-level accuracy with this method.

[[File:kdenlive_timeline_current_clip_duration02.png]]

You can also resize a clip by cutting it with the  [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Razor_Tool|Razor Tool]] and then deleting the bit you do not want.

==== Removing Space Between Clips ====

Right click in the space between the clips and choose <menuchoice>Remove Space</menuchoice>. Be aware however that if you have clips on multiple tracks in the timeline and they are not grouped, then removing space may disturb the alignment of the clips between the different tracks &mdash; the space is only removed from the timeline where you clicked.  Under this situation it may be safer to use the [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Spacer_Tool|Spacer Tool]].

[[File:Kdenlive-removespace.gif|center]]

==== Middle Tool Bar ====

There is a toolbar between monitors and the timeline that controls various aspects of the editor. 
[[File:Kdenlive-middle-toolbar.png|center|frame|Middle Toolbar ver  21.04]]

1.  '''Track Compositing''' drop down. 

1a. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Track_Compositing_-_None|None]] 

1b. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Track_Compositing_-_Preview|Preview]]

1c. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Track_Compositing_-_HighQuality|High Quality]]

1d. '''Mixed Audio tracks''' changes the order in which tracks are displayed to mixed audio and video tracks.  For example, from the bottom of the timeline to the top of the timeline: A1, V1, A2, V2, A3, V3

1e. '''Split Audio tracks''' changes the order in which tracks are displayed to seperated audio and video tracks.  For example, from the bottom of the timeline to the top of the timeline: A1, A2, A1, V1, V2, V3

1f. '''Split Audio tracks (reverse)''' changes the order in which tracks are displayed to seperated audio and video tracks with the audio tracks in reverse order.  For example, from the bottom of the timeline to the top of the timeline: A1, A2, A3, V1, V2, V3

2. '''Timeline Edit Mode'''   Drop Down

2a. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Timeline Edit Mode - Normal_Mode|Normal Mode]]

2b. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Timeline Edit Mode - Overwrite_Mode|Overwrite Mode]]

2c. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Timeline Edit Mode - Insert_Mode|Insert Mode]]

These same settings can be found under the <menuchoice>Tool</menuchoice> menu.

3. Use timeline zone [[File:Kdenlive Use timeline zone for insert.png]] / Do not use timeline zone [[File:Kdenlive Dont Use timeline zone for insert.png]] for insert (toggles). See [https://kdenlive.org/project/insert-overwrite-advanced-timeline-editing/ Insert & Overwrite Advanced Timeline Editing] on Kdenlive Home page. 

'''Tool Group''' (one of these 3 can be active)

Active buttons are grey.

4. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Selection_Tool|Selection Tool]] - Also selected with the 'S' hotkey.  Allows the selection and manupliation of clips on the timeline

5. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Razor_Tool|Razor Tool]] - Also selected with the 'X' hotkey, or to cut at the point of the play head use "Shift-R".   This alows a clip to be cut into two clips.

6. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Spacer_Tool|Spacer Tool]] - Also selected with the 'M' hotkey.  This tool will select all clips at one point in the timeline and allow them to be shifted at once.  

7. Position indicator - displays the time point or frame number of the location of the hovering mouse on the left side, and the total length of the project on the right side.

7a. '''hh:mm:ss:ff;''' Sets the position indicator to display time units

7b. '''Frames''' Sets the position indicator to display frames

8. '''Mix Clips''' - allows same-track transitions to be applied between two clips. See [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Same_track_transitions|Same Track Transitions]] for a detailed explination.

9. Insert Clip Zone in Timeline. See [https://kdenlive.org/project/insert-overwrite-advanced-timeline-editing/ Insert & Overwrite Advanced Timeline Editing] on Kdenlive Home page. 

10. Overwrite Clip Zone in Timeline. See [https://kdenlive.org/project/insert-overwrite-advanced-timeline-editing/ Insert & Overwrite Advanced Timeline Editing] on Kdenlive Home page. 

11. Extract Timeline Zone

12. Lift Timeline Zone

13. Favourite Effects

14. Start Preview Render

14a. Stop Preview Render

14b. Add Preview Zone

14c. Remove Preview Zone

14d. Remove All Preview Zones

14e. Automatic Preview

14f. Disable Timeline Preview

14g. Manage Cached Data

Items 14, 14a-14g are covered in detail by [https://kdenlive.org/project/timeline-preview-rendering/ Timeline preview rendering] article on the Kdenlive Home Page

15. Show/Hide the '''Audio Mixer''' tool.  The audio mixer tool allows audio to be managed in the project.

16. Show/Hide the '''Subtitle Tool'''.  This will show or hide the subitle track where subtitles can be created or edited in the project.

==== Bottom Tool Bar ====

[[File:Kdenlive Bottom toolbar17 04b.png|left|frame|Bottom toolbar ver 17.04]]
<br clear=all>

24. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Split_Audio_and_Video_Automatically|Split Audio and Video Automatically]]

25. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Automatic_Transitions|Automatic Transitions]]

26. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Show_Video_Thumbnails|Show Video Thumbnails]]

27. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Show_Audio_Thumbnails|Show Audio Thumbnails]]

28. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Show_marker_comments|Show Marker Comments]]

29. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Snap|Snap]]

'''Zoom Tools'''

30. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Fit_Zoom_to_Project|Fit Zoom to Project]]

31. Zoom Out

32. [[Special:MyLanguage/Kdenlive/Manual/Timeline/Editing#Zoom_project|Zoom Project]]

33. Zoom In

==== Button Descriptions ====
<span id="Track Compositing - None"></span>
===== Track Compositing - None =====

When Track Compositing is set to None you will not get tracks with alpha channel information to composite with the other tracks unless an explicit composite or affine transition is added between the clips.  This is the behavior that '''Kdenlive''' displayed in older ( <= ver 0.9.X). 
<span id="Track Compositing - Preview"></span>
===== Track Compositing - Preview =====

When track compositing is set to Preview tracks with alpha channel information will be automatically composited with the other tracks using an algorithm that is somewhat faster than the algorithm used with ''Track Compositing - HighQuality'' but which slightly degrades the colors.
<span id="Track Compositing - HighQuality"></span>
===== Track Compositing - HighQuality =====

When track compositing is set to High-Quality tracks with alpha channel information will be automatically composited with the other tracks using an algorithm (qtblend) that is somewhat slower than the algorithm used with ''Track Compositing - Preview'' but which retains higher fidelity color information.
<span id="Timeline Edit Mode - Normal Mode"></span>
===== Timeline Edit Mode - Normal Mode =====

In this edit mode, you can not drag clips on top of other clips in the same track in the timeline. You can drag them to another track in the timeline but not into the same track at the same time point as an existing clip. Contrast this to overwrite mode.
<span id="Timeline Edit Mode - Overwrite Mode"></span>
===== Timeline Edit Mode - Overwrite Mode =====

In this edit mode, you can drag a clip onto a track where there is an existing clip and the incoming clip will overwrite that portion of the existing clip (or clips) covered by the incoming clip.

[[File:kdenlive_overwrite_mode_before01.png|left|frame|Before]]

[[File:kdenlive_overwrite_mode_after01.png|left|frame|After]]
<br clear=all>

In the "After" screenshot above, you can see that the clip which was dragged from the upper track has replaced a portion of the clip on the lower track.
<span id="Timeline Edit Mode - Insert Mode"></span>

'''Rearrange clips in the timeline'''   

Performing a rearrange edit. This technique lets you quickly change the order of clips in the timeline.

[[File: Overwrite-mode.mp4]]  
 
Drag a clip, as you drop it to a new location performs an overwrite edit that overwrite the existing clip.

===== Timeline Edit Mode - Insert Mode =====

With this mode selected and you drop a selection into the timeline the selection will be inserted into the timeline at the point where the mouse is released. The clip that the selection is dropped on is cut and clips are moved to the right to accommodate the incoming clip.

[[File:Kdenlive Insert mode0before.png|left|frame|Before]]

[[File:Kdenlive Insert mode1before.png|left|frame|During]]

[[File:Kdenlive Insert mode1after.png|left|frame|After. Incoming Clip inserted. Clips after the insert point are shifted Right]]
<br clear=all>
<span id="Selection Tool"></span>
'''Rearrange edit in the timeline'''

Performing a rearrange edit. Only clips in the destination track are shifted; clips in other tracks are not affected. This technique lets you quickly change the order of clips in the timeline. 

It always closes all space in the track.

[[File: Insert-mode.mp4]]   

Drag a clip, as you drop it to a new location. Releasing the clip performs an insert edit that shifts clips in the destination tracks only.

===== Selection Tool =====

Use this to select clips in the timeline. The cursor becomes a hand when this tool is active. 
<span id="Razor Tool"></span>
===== Razor Tool ===== 

Use this to cut clips in the timeline. The cursor becomes a pair of scissors when this tool is active.
<span id="Spacer Tool"></span>
===== Spacer Tool =====

Use this tool ({{Icon1|Kdenilve_Spacer_tool_icon.png}}) to temporarily group separate clips and then drag them around the timeline to create or remove space between clips. Very useful. Experiment with this tool to see how it works.

[[File:Kdenlive_Spacer_tool_crop.png|600px]]

In the above example, these clips are not grouped. However, the spacer tool groups them temporarily for you so you can move them all as a group.
<span id="Fit Zoom to Project"></span>
===== Fit Zoom to Project ===== 

This will zoom the project out so that it all fits in the timeline window. This is the same function that is triggered by [[Special:MyLanguage/Kdenlive/Manual/Timeline Menu|Timeline]] Menu item, <menuchoice>Fit Zoom to Project</menuchoice>.
<span id="Zoom project"></span>
===== Zoom project =====

The magnifying glasses zoom in or out on the timeline. The slider adjusts the zoom by large increments. These same settings are controlled by the <menuchoice>Timeline</menuchoice> menu items, <menuchoice>Zoom In</menuchoice> and <menuchoice>Zoom Out</menuchoice>.
<span id="Split Audio and Video Automatically"></span>
===== Split Audio and Video Automatically =====

When this is on and you drag a clip to the timeline, the audio in the clip will end up on an audio track and the video on a video track. You can achieve the same result if you select the clip, [[Special:MyLanguage/Kdenlive/Manual/Timeline/Right Click Menu|right click]], <menuchoice>Split Audio</menuchoice>.  When this is off and you drag a clip onto the timeline, both the audio and video tracks are combined into one video track.
<span id="Automatic Transitions"></span>
===== Automatic Transitions =====

When active any transitions added to the timeline will have the automatic transition option checked by default.
See [[Special:MyLanguage/Kdenlive/Manual/Transitions#Automatic_Transitions| Automatic Transitions]]
<span id="Show Video Thumbnails"></span>
===== Show Video Thumbnails =====

When on, the video clips in the timeline will contain thumbnails as well a filename. Otherwise, they just have the clip filename.

When the timeline is zoomed in to the maximum, the video track will show a thumbnail for every frame in the clip. When the timeline is not on maximum zoom, the video track will show a thumbnail for the first and last frame in the clip.
<span id="Show Audio Thumbnails"></span>
===== Show Audio Thumbnails =====

When on, the audio clip will have a wave representation of the audio data as well as a filename.  Otherwise, they just have the clip filename.
<span id="Show marker comments"></span>
===== Show marker comments =====

This toggles on and off the display of the comments saved within [[Special:MyLanguage/Kdenlive/Manual/Projects_and_Files/Clips#Markers|markers]] (the text with the gold background in the example below) and within [[Special:MyLanguage/Kdenlive/Manual/Timeline/Guides|guides]] (the text with the purple background).

[[File:Kdenlive_Markers_and_guides_crop.png]]
<span id="Snap"></span>
===== Snap =====

When this feature is on, dragging the beginning of one clip near to the end of another will result at the end of the first clip snapping into place to be perfectly aligned with the beginning of the second clip. As you move the two ends near to each other, as soon as they get within a certain small distance, they snap together so there is no space and no overlap. Note that this occurs even if the clips are on different tracks in the timeline.

Clips will also snap to the cursor position, markers and [[Special:MyLanguage/Kdenlive/Manual/Timeline/Guides|guides]].

==== Cutting Footage from multiple aligned tracks - Ripple Delete ====

This is available on the <menuchoice>Timeline</menuchoice> menu under <menuchoice>All clips->Ripple Delete</menuchoice> <ref>available on bleeding edge versions > 0.9.10 (Jan2015)</ref>.

<b>Seems missing in Kdenlive 17.04 & 18.04</b> <br>
Mark In and Out points in the Project Monitor, then choose <menuchoice>Timeline->All clips->Ripple Delete</menuchoice> (or <keycap>Ctrl-X</keycap>).  Kdenlive deletes all footage between the In and Out points in unlocked tracks, slides everything else back to fill the gap, and puts the playhead on the In point.

==== Subtitle ====

Since Version 20.12.0   

[[File:subtitle-timeline-1.gif]]   

The subtitling tool allows you to add and edit subtitles directly in the timeline on a special subtitle track or by using the new subtitle window. You can also import (SRT/ASS) and export (SRT) subtitles.   

There are 3 ways to add subtitle: 

* ''' Menu '''

:* <menuchoice>Project -> Subtitle -> Add Subtitle</menuchoice>

* ''' Keyboard '''   

:* <keycap>Shift+S</keycap> adds a subtitle.  

* ''' Icon and Mouse'''  

:* Click the "subtitle" icon in the timeline toolbar to open the subtitle track in the timeline.

:* Double-click in the subtitle track to add a subtitle.

''' Adding and editing text'''   

Add or editing text either directly into the subtitle clip or in the subtitle window.

''' Adjust the length of subtitle '''   

Grab the end of a subtitle with the mouse and lengthen or shorten it as needed.
Set subtitle in/out can be achieved with the same shortcut as to set clip in/out (left/right parenthesis shortcut). 

''' Subtitle window '''

[[File:subtitle-widget.gif]]   

* The subtitles window allows easier editing and also makes it possible to easily navigate between subtitles with the left/right button.   

* With the plus sign, you can add subtitles.

* The scissors are mostly here for divide subtitle: let's say your subtitle text is too long and you want to make it 2 different subtitles. Put the cursor in the text widget where you want to cut and click the scissors, it will split the text between 2 different subtitle items. The scissors are only working when the playhead is over the subtitle itself.  

* The tick adds the text to the subtitle.

'''Import and export subtitle'''   

Importing SRT and ASS subtitle file: <menuchoice>Project -> Subtitles -> Import subtitles file</menuchoice> 

Exporting SRT subtitles only: <menuchoice>Project -> Subtitles -> Export subtitles file</menuchoice>   

{{Tip| SRT supports markup for: bold, italic, underline, text color and line break.
* <code><nowiki> <b>text in boldface</b> </nowiki></code>
* <code><nowiki> <i>text in italics</i> </nowiki></code>
* <code><nowiki> <u>text underlined</u> </nowiki></code>
* <code><nowiki> <font color="#00ff00"> text in green</font> </nowiki></code> you can use the font tag only to change color.
* And all combined: <nowiki>   <font color="#00ff00"><b><i><u>All combined</u></i></b></font> </nowiki>     
<!--}}-->
* '''Line break:''' Add on the end of each line a <code><nowiki><br></nowiki></code> (for break). Now the srt file is stored correct and reopened with the line break. The subtitle in the subtitle window will be all in 1 line after several save but the breaks is working.

<keycap>Alt+arrow</keycap> jumps from subtitle to subtitle.}} <!--{{-->

Since version 21.04.0    

*''' Spelling check '''
Spelling check for subtitle is integrated and show incorrect words by a red wiggly line. Right click on the word and you get a list of possible words you can choose by click on it.

[[File: Speech-to-text_Spell-Check.png]]

==== Speech to text ====

Since version 21.04.0    
*''' Install Python '''
Python needs to be installed on your computer. Download it form here https://www.python.org/downloads/ for installation on your computer.

*''' Install Python '''
Python needs to be installed on your computer. Download it from here https://www.python.org/downloads/ for installation on your computer.  

Speech recognition requires the vosk and srt python modules
  
-	On Linux open a terminal and put in and run: "pip3 install vosk;pip3 install srt".   

-	On Windows you can download this batch file ([[File: Install_vosk_srt.zip]]). After download double click starts the installations.  
   
*''' Install a language '''
Goto <menuchoice>Settings -> Configure Kdenlive -> Speech to Text</menuchoice> 
 
Click on the link to get a language model
[[File: Speech-to-text_Download-link.png]]

Drag & drop the language you want from the vosk-model download page to the model window, and it will download and extract it for you.
[[File: Speech-to-text_Download-model.png]]

If you have problems click on "Check configuration" button. 

''' Speech recognition '''
*''' Creating subtitle by speech recognition '''

1.	Mark the timeline zone you want to recognize (adjust the blue line).

2.	Click on the "Speech recognition" icon.

3.	Choose the language.

4.	Choose how the selected zone should be applied.

5.	Click "Process"

The subtitle gets created and inserted automatically.

Remark: Only timeline zone is implemented for now in automatic subtitles.
[[File: Speech-to-text_Subtitle.png]]
*''' Creating clips by speech recognition '''
This is useful for interviews and other speech related footage.
Enable <menuchoice>View -> Text Edit</menuchoice>

Select a clip in the project bin.

1.	If needed set in/out point in the clip monitor and enable "selected zone only". This will only recognize the text inside the zone.

2.	Choose the correct language

3.	Click "start recognition"

4.	Selecting the text you want to either

5.	Put into the timeline

6.	Save as a new clip

7.	Add a Bookmark. You can jump to these bookmarks in the timeline with <keycap>alt+arrow</keycap> or edit the bookmark by double click.

8.	Delete the selection.

9.	Here you can search in the text.

10.	And navigate up

11.	Or down in the text.

[[File: Speech-to-text_Text-Edit.png]]

{{Warning|Speech to text doesn't work with version 21.04.2 due to vosk API issues. Use version 21.04.1 or 21.04.3 and later versions.}}

==== 3 point editing ====

Since version 19.08.0    

3 important points to understand the 3 point editing concept (with keyboard shortcuts): 

[[File:3p-Source-1.gif]]   

'''Source'''

: On the left of the track head the green vertical lines (V1 or A2). The green line is connected to the source clip in the project bin. Only when a clip is selected in the project bin the green line show up depending on the type of the clip (A/V clip, picture/title/color clip, audio clip).

[[File:3p-Target-active-1.gif]]   

'''Target'''

: In the track head the target V1 or A1 is active when it’s yellow. An active target track reacts to edit operations like insert a clip even if the source is not active.

'''The concept is like thinking of connectors'''

: Connect the source (the clip in the project bin) to a target (a track in the timeline). Only when both connectors on the '''same''' track are switched on the clip “flow” from the project bin to the timeline.

'''Be aware'''

: Active target tracks without connected source react on edit operations.

'''Example of advanced edit'''

Here is a brief introduction to the 3 point editing system.

[[File:3p-Insert-clip-1.gif]]   

1.	Select a clip in the project bin with an up/down arrow

2.	Navigate the clip by the <keycap>JKL</keycap> keys or by the <keycap>left/right</keycap> arrows and set the IN and the OUT point by the <keycap>I</keycap> and <keycap>O</keycap> keys.

3.	Hit <keycap>T</keycap> to change to the timeline

4.	Select a video or audio track in the timeline (up/down arrow key) and set it as source with <keycap>Shift+T</keycap>.

5.	Activate the track as a target with shortcut <keycap>A</keycap> (this connects the track to the source)

6.	Hit <keycap>V</keycap> (insert) or <keycap>B</keycap> (overwrite) to add the clip at the play-head position or to fill the selected area in the timeline if it is active. If you need to activate it use the <keycap>G</keycap> key.

[[File:3p-Advanced-edit-1.gif]]   

In the following example, we want only to insert the audio part of a clip in A2 and we want to create a gap in all the other video and audio tracks:

1.	Activate all the target tracks which contain clips (yellow buttons).   

2.	Activate just the audio source on A2   

3.	Press <keycap>V</keycap> (insert).   

<references />
{{Prevnext2
| prevpage=Special:MyLanguage/Kdenlive/Manual/Timeline| nextpage=Special:MyLanguage/Kdenlive/Manual/Timeline/Grouping
| prevtext=Timeline | nexttext=Grouping
| index=Special:MyLanguage/Kdenlive/Manual | indextext=Back to menu
}}

[[Category:Kdenlive]]