# cp.apple.finalcutpro.timeline.Contents

Timeline Contents Module.

# API Overview

Functions - API calls offered directly by the extension

  • clipsUI
  • matches
  • playheadClipsUI
  • positionClipsUI
  • skimmingPlayheadClipsUI

Constructors - API calls which return an object, typically one that offers API methods

  • Contents

Fields - Variables which can only be accessed from an object returned by a constructor

  • children
  • isLoaded
  • playhead
  • scrollArea
  • scrollAreaUI
  • selectedChildren
  • skimmingPlayhead
  • viewFrame

Methods - API calls which can only be made on an object returned by a constructor

  • activePlayhead
  • doFocus
  • doHide
  • doSelectClip
  • doSelectClips
  • doSelectNone
  • doSelectTopClip
  • doShow
  • rangeSelectionUI
  • selectedClipsUI

# API Documentation

# Functions

# clipsUI

Signature cp.apple.finalcutpro.timeline.Contents:clipsUI(expandedGroups, filterFn) -> table of axuielements
Type Function
Description Returns a table containing the list of clips in the Timeline.
Parameters
  • expandGroups - (optional) if true, expand AXGroups to include contained AXLayoutItems
  • filterFn - (optional) if provided, the function will be called to check each clip
Returns
  • The table of axuielements that match the conditions
Notes
  • If expandsGroups is true any AXGroup items will be expanded to the list of contained AXLayoutItems.
  • If filterFn is provided it will be called with a single argument to check if the provided clip should be included in the final table.
Examples None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 274

# matches

Signature cp.apple.finalcutpro.timeline.Contents.matches(element) -> boolean
Type Function
Description Checks if an axuielementObject matches the Contents type.
Parameters
  • element - An axuielementObject to check.
Returns
  • true if it matches, otherwise false.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 28

# playheadClipsUI

Signature cp.apple.finalcutpro.timeline.Contents:playheadClipsUI(expandedGroups, filterFn) -> table of axuielements
Type Function
Description Returns a table array containing the list of clips in the Timeline under the playhead, ordered with the highest clips at the beginning of the array.
Parameters
  • expandGroups - (optional) if true, expand AXGroups to include contained AXLayoutItems
  • filterFn - (optional) if provided, the function will be called to check each clip
Returns
  • The table of axuielements that match the conditions
Notes
  • If expandsGroups is true any AXGroup items will be expanded to the list of contained AXLayoutItems.
  • If filterFn is provided it will be called with a single argument to check if the provided clip should be included in the final table.
Examples None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 345

# positionClipsUI

Signature cp.apple.finalcutpro.timeline.Contents:positionClipsUI(position, expandedGroups, filterFn) -> table of axuielements
Type Function
Description Returns a table array containing the list of clips in the Timeline at the specified position, ordered with the highest clips at the beginning of the array.
Parameters
  • position - The X (or horizontal) position value to find clips under.
  • expandGroups - (optional) if true, expand AXGroups to include contained AXLayoutItems
  • filterFn - (optional) if provided, the function will be called to check each clip
Returns
  • The table of axuielements that match the conditions
Notes
  • If expandsGroups is true any AXGroup items will be expanded to the list of contained AXLayoutItems.
  • If filterFn is provided it will be called with a single argument to check if the provided clip should be included in the final table.
Examples None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 318

# skimmingPlayheadClipsUI

Signature cp.apple.finalcutpro.timeline.Contents:skimmingPlayheadClipsUI(expandedGroups, filterFn) -> table of axuielements
Type Function
Description Returns a table array containing the list of clips in the Timeline under the skimming playhead, ordered with the highest clips at the beginning of the array.
Parameters
  • expandGroups - (optional) if true, expand AXGroups to include contained AXLayoutItems
  • filterFn - (optional) if provided, the function will be called to check each clip
Returns
  • The table of axuielements that match the conditions
Notes
  • If expandsGroups is true any AXGroup items will be expanded to the list of contained AXLayoutItems.
  • If filterFn is provided it will be called with a single argument to check if the provided clip should be included in the final table.
Examples None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 363

# Constructors

# Contents

Signature cp.apple.finalcutpro.timeline.Contents(parent) -> Contents
Type Constructor
Description Creates a new Timeline Contents instance.
Parameters
  • parent - The parent Timeline
Returns
  • A new Contents object.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 43

# Fields

# children

Signature cp.apple.finalcutpro.timeline.Contents.children <cp.prop: table; read-only; live>
Type Field
Description The current set of child elements in the Contents.
Notes None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 115

# isLoaded

Signature cp.apple.finalcutpro.timeline.Contents.isLoaded <cp.prop: booelan; read-only; live>
Type Field
Description Checks if the Timeline has content loaded.
Notes None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 139

# playhead

Signature cp.apple.finalcutpro.timeline.Contents.playhead <cp.apple.finalcutpro.main.Playhead>
Type Field
Description The main Playhead.
Notes None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 196

# scrollArea

Signature cp.apple.finalcutpro.timeline.Contents.scrollArea <cp.ui.ScrollArea>
Type Field
Description The ScrollArea for the Contents element.
Notes None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 94

# scrollAreaUI

Signature cp.apple.finalcutpro.timeline.Contents.scrollAreaUI <cp.prop: hs.axuielement; read-only; live>
Type Field
Description The parent ScrollArea UI of the Timeline Contents area.
Notes None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 84

# selectedChildren

Signature cp.apple.finalcutpro.timeline.Contents.selectedChildren <cp.prop: table; read-only; live>
Type Field
Description The current set of selected child elements in the Contents.
Notes None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 127

# skimmingPlayhead

Signature cp.apple.finalcutpro.timeline.Contents.skimmingPlayhead <cp.apple.finalcutpro.main.Playhead>
Type Field
Description The Playhead that tracks with the mouse pointer.
Notes None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 203

# viewFrame

Signature cp.apple.finalcutpro.timeline.Contents.viewFrame <cp.prop: table; read-only; live>
Type Field
Description The current 'frame' of the internal timeline content, or nil if not available.
Notes None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 108

# Methods

# activePlayhead

Signature cp.apple.finalcutpro.timeline.Contents:activePlayhead() -> Playhead
Type Method
Description Returns the active Playhead. If the Skimming Playhead is available, return that, otherwise, return the normal Playhead.
Parameters
  • None
Returns
  • The active Playhead.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 211

# doFocus

Signature cp.apple.finalcutpro.timeline.Contents:doFocus(show) -> cp.rx.go.Statement
Type Method
Description A Statement which will focus on the Contents.
Parameters
  • show - if true, the Contents will be shown before focusing.
Returns
  • The Statement.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 576

# doHide

Signature cp.apple.finalcutpro.timeline.Contents:doHide() -> cp.rx.go.Statement
Type Method
Description A Statement that will attempt to hide the Timeline Contents.
Parameters
  • None
Returns
  • The Statement.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 177

# doSelectClip

Signature cp.apple.finalcutpro.timeline.Contents:doSelectClip(clipUI) -> cp.rx.go.Statement
Type Method
Description A Statement which will select the specified single hs.axuielement value in the Timeline Contents area.
Parameters
  • clipUI - The hs._asm.axuilement values to select.
Returns
  • A Statement that will select the clip or throw an error if there is an issue.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 529

# doSelectClips

Signature cp.apple.finalcutpro.timeline.Contents:doSelectClips(clipsUI) -> cp.rx.go.Statement
Type Method
Description A Statement which will select the specified list of hs.axuielement values in the Timeline Contents area.
Parameters
  • clipsUI - The table of hs._asm.axuilement values to select.
Returns
  • A Statement that will select the clips or throw an error if there is an issue.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 502

# doSelectNone

Signature cp.apple.finalcutpro.timeline.Contents:doSelectNone() -> cp.rx.go.Statement
Type Method
Description Returns a Statement that will clear any clip selection.
Parameters
  • None
Returns
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 480

# doSelectTopClip

Signature cp.apple.finalcutpro.timeline.Contents:doSelectTopClip([position]) -> cp.rx.go.Statement
Type Method
Description Creates a Statement that will select the top clip at the given position, resolving to the top clip if available.
Parameters
  • position - (optional) The position table to select the top clip at. If not provided, the current active playhead position is used.
Returns
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 550

# doShow

Signature cp.apple.finalcutpro.timeline.Contents:doShow() -> cp.rx.go.Statement
Type Method
Description A Statement that will attempt to show the Timeline Contents.
Parameters
  • None
Returns
  • The Statement.
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 158

# rangeSelectionUI

Signature cp.apple.finalcutpro.timeline.Contents:rangeSelectionUI() -> axuielements
Type Method
Description Returns the UI for the current 'Range Selection', if present.
Parameters
  • None
Returns
  • The 'Range Selection' UI or nil
Notes None
Examples None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 300

# selectedClipsUI

Signature cp.apple.finalcutpro.timeline.Contents:selectedClipsUI(expandedGroups, filterFn) -> table of axuielements
Type Method
Description Returns a table containing the list of selected clips.
Parameters
  • expandGroups - (optional) if true, expand AXGroups to include contained AXLayoutItems
  • filterFn - (optional) if provided, the function will be called to check each clip
Returns
  • The table of selected axuielements that match the conditions
Notes
  • If expandsGroups is true any AXGroup items will be expanded to the list of contained AXLayoutItems.
  • If filterFn is provided it will be called with a single argument to check if the provided clip should be included in the final table.
Examples None
Source src/extensions/cp/apple/finalcutpro/timeline/Contents.lua line 252

© Copyright 2025 LateNite Films Pty Ltd. All rights reserved.