Add Settings > Timeline > Adjustment Clip #1873

Stale Open
ddennedy opened 3:02pm on July 22, 2026 wants to merge 54 Δ into mltframework/shotcut master from
adjustment-clip

Pull Request Overview

  • Opened on July 23, 2026
  • Status Stale Open
  • Commit count 2 with first commit July 23, 2026

Total Delta

54 Total Diff Delta

Open Days

Open 42 weekdays

Test Delta

0 Diff Delta in Test Files
Breakdown by Phase

How long has this pull request spent in each phase of its lifecycle?

Fraction of total time Business days Phase
 
0.0 days Authoring 1 commit before pull request opened for review
 
0.0 days Awaiting first review
 
42.0 days Revising work with 1 commit in response to 1 review that left 1 comment

Total time for pull request still awaiting merge (longer than repo's target): 42.0 business days

Author avatar

Add Settings > Timeline > Adjustment Clip

This pull request adds support for "Adjustment Clips" to the timeline, allowing users to add a special type of clip that applies effects to everything below it. The feature is only available when using libmlt version 7.41.0 or newer. The implementation includes UI changes to add the new generator, logic to create and insert the adjustment clip, and support for displaying it in the main window.

Adjustment Clip Feature:


  • Added a menu option to insert an "Adjustment Clip" in the timeline when libmlt >= 7.41.0. (src/docks/timelinedock.cpp, src/docks/timelinedock.h) [[1]](diffhunk://#diff-f68df8db1fd177eef1313a1db87917a1f55cca11cd7d8474f227a25162845a18R1487-R1493) [[2]](diffhunk://#diff-ddb896addd53739957e7ec6971138cc519b45acb3cfb84ca42cbdda5192e2085R289-R291)

  • Implemented the addAdjustmentClip() method to create and insert a color producer configured as an adjustment clip. (src/docks/timelinedock.cpp)

  • Updated loadProducerWidget() to recognize adjustment clips and set up the filter controller appropriately. (src/mainwindow.cpp)

Comments Threads Pending Resolution

ljharb reviewed on July 23, 2026
ljharb left a comment

## Pull request overview

Adds an “Adjustment Clip” generator to Shotcut’s timeline (libmlt ≥ 7.41.0), enabling a special clip type intended to apply effects to everything beneath it. This integrates into the existing generator menu/insert flow and adjusts the Properties/Filters UI behavior when such a clip is selected.

**Changes:**
- Adds a Timeline generator menu item for “Adjustment Clip” gated by `LIBMLT_VERSION_INT >= 7.41`.
- Implements creation/insertion logic for the adjustment clip using a `color` producer tagged with `kShotcutProducerProperty=adjustment`.
- Updates producer-widget loading to treat adjustment clips specially and wire them directly to the filter controller.

### Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

| File | Description |
| ---- | ----------- |
| src/mainwindow.cpp | Detects “adjustment” producers and routes them to the filter controller with a minimal properties widget. |
| src/docks/timelinedock.h | Declares the new `addAdjustmentClip()` slot under a libmlt version compile-time guard. |
| src/docks/timelinedock.cpp | Adds the generator menu entry and implements adjustment clip creation/insertion. |

Resolved Comment Threads

No resolved comments have been left on this PR.