Use a clip marker when the cue describes content inside the source media and should remain attached when that media is reused. Use a timeline marker when the cue belongs to the edited sequence, such as a chapter, delivery point, or event at a particular sequence position. The Kdenlive documentation describes the Timeline Marker Locked option specifically for moving clips with the Spacer Tool: locked markers stay in place, while unlocked markers move with the clip. Do not generalize that behavior to other ways of moving clips; record the intended meaning and verify the result for the operation used.
Specific Judgment and Steps
A cue such as “hand enters at 00:04 of the generated shot” is source-specific. A cue such as “opening chapter begins at 00:30 in the finished video” is sequence-specific. A cue covering a duration should use a range marker when the documented marker controls support that choice.
- Write the cue’s subject in one sentence. If it names an action, visual change, or usable moment within one source clip, classify it as source content. If it names a chapter, narration section, gap, delivery cue, or other event in the assembled edit, classify it as timeline content.
- Decide whether the cue should be reusable. Kdenlive documents clip markers as attached to the clip. When the same clip is used again, changing its marker changes the marker on both instances. This is useful for a shared source note, but it also makes the change broader than one timeline occurrence. See the official clip-marker documentation.
- Choose the object in Kdenlive. Add a clip marker through the Clip Monitor or by selecting the clip in the timeline and adding a marker. Add a timeline marker from the timeline ruler or timeline marker command. Do not infer the type from flag color alone; use the actual command or marker listing.
- Set movement behavior for a timeline marker. The manual describes timeline markers as either stationary or movable with clips. With the documented Timeline Marker Locked option, a locked marker stays in place when the spacer tool moves clips; an unlocked marker moves with the clip. Select the behavior that matches the cue’s meaning, then record it in the decision table.
- For a clip range marker, enable Range Marker and set its Duration in the Edit Marker window, or define a zone in the Clip Monitor and create a marker from that clip zone. For a timeline range marker, enable Range Marker and set its Duration in the Edit Marker window, or create the marker from a timeline zone. Keep a point cue as a point rather than assigning an arbitrary duration.
A New Acceptance Worksheet
This is an editorial worksheet for a hypothetical project, not a report of software testing. The timestamps and observations are examples used to expose the decision.
| Cue | Hypothetical observation | Object | Movement rule | Range? | Decision check |
|---|---|---|---|---|---|
| AI shot A: product rotates at source 00:02.4 | The same generated shot is reused at sequence 00:10 and 01:05 | Clip | Attached to source clip | No | Clip marker; both instances intentionally share the note |
| AI shot B: label is briefly covered from source 00:05 to 00:07 | The note describes a two-second interval inside one source file | Clip | Attached to source clip | Yes | Clip range marker; review the source interval before reuse |
| Voice-over section starts at sequence 00:30 | The chapter begins after an edit and does not belong to one source file | Timeline | Locked or stationary | No | Timeline marker at the approved sequence position |
| Final title should remain with the opening montage after a spacer move | The title event should travel with that montage, not with every source instance | Timeline | Unlocked or movable with clips when using the Spacer Tool | No | Set the timeline marker to unlocked so it moves with the montage; record that this rule is specifically for the Spacer Tool |
| Review whether a generated transition occupies sequence 00:42–00:46 | The interval spans an edit between two clips | Timeline | Choose based on whether the interval follows the edit | Yes | Timeline range marker, then verify its relation to the assembled sequence |
Acceptance is complete when each row has a stated subject, owning object, movement rule, and point-or-range choice. For reused source media, also state whether simultaneous marker changes on multiple instances are intended. If a marker’s type is unclear from the timeline display, open the marker view or select the relevant clip and inspect the object identity rather than relying on color.
Limits and Next Steps After Failure
A clip marker does not become an independent annotation for each timeline instance. Because the source clip owns it, editing that marker can affect every use of the same clip. If two instances require different notes, place the instance-specific notes on the timeline instead, or use distinct source media where that separation is editorially necessary.
A timeline marker is not automatically a permanent clock-time guarantee. Its documented locked or movable behavior matters when clips are repositioned. If the cue must remain at an agreed elapsed time, keep it stationary or locked according to the available control. If it describes an event that should travel with a group of clips, use the movable behavior and verify the event after the edit.
If the cue still lands on the wrong content, do not rename it and assume the problem is solved. Reclassify its subject: source frame, sequence position, or sequence interval. Then edit the existing marker or create the correctly owned one. Kdenlive documents range markers and timeline markers as usable for regions, but it does not establish that a marker restores missing AI-generated detail or proves visual continuity.
Three Short Questions
Should color decide the type?
No. Colors can help scanning, but the owning object and marker type are the reliable decision points.
Should a reusable AI cue always be a clip marker?
Only when it describes reusable source content. A cue about where that shot appears in one edit remains a timeline cue.
Can a timeline marker cover a duration?
Yes. The official guide documents timeline range markers. Use one when the cue represents an interval in the assembled timeline, not merely because the source action lasts several seconds.
Sources: Kdenlive Markers and Kdenlive Timeline Markers.
Sources and next step
- Markers — Kdenlive 26.08 Manual 26.08 documentation
- Timeline Markers — Kdenlive 26.08 Manual 26.08 documentation
This guide interprets public documentation and uses explicitly hypothetical acceptance examples, not application tests. Controls and availability can change; verify the cited manual against your installed version.
For work created in Imagild, carry the input requirements and acceptance checklist into the film workspace. The external software controls discussed above belong to their respective products.