# plugins.finalcutpro.timeline.playhead

Manages features relating to the Timeline Playhead.

---

## API Overview
**Variables** - _Configurable values_
 * [alwaysCentered](#alwayscentered)
 * [scrollingTimeline](#scrollingtimeline)
 * [tracking](#tracking)

---

## API Documentation

#### Variables

### [alwaysCentered](#alwayscentered)

|                                             |                                                                                     |
| --------------------------------------------|-------------------------------------------------------------------------------------|
| **Signature**                               | `plugins.finalcutpro.timeline.playhead.alwaysCentered <cp.prop: boolean>`                                                                    |
| **Type**                                    | Variable                                                                     |
| **Description**                             | If `true`, the playhead will be centered in the view while scrolling.                                                                     |
| **Notes**                                   | None |
| **Source**                                  | [src/plugins/finalcutpro/timeline/playhead.lua line 71](https://github.com/CommandPost/CommandPost/blob/develop/src/plugins/finalcutpro/timeline/playhead.lua#L71) |

---

### [scrollingTimeline](#scrollingtimeline)

|                                             |                                                                                     |
| --------------------------------------------|-------------------------------------------------------------------------------------|
| **Signature**                               | `plugins.finalcutpro.timeline.playhead.scrollingTimeline <cp.prop: boolean>`                                                                    |
| **Type**                                    | Variable                                                                     |
| **Description**                             | Enables or disables the scrolling timeline.                                                                     |
| **Notes**                                   | None |
| **Source**                                  | [src/plugins/finalcutpro/timeline/playhead.lua line 57](https://github.com/CommandPost/CommandPost/blob/develop/src/plugins/finalcutpro/timeline/playhead.lua#L57) |

---

### [tracking](#tracking)

|                                             |                                                                                     |
| --------------------------------------------|-------------------------------------------------------------------------------------|
| **Signature**                               | `plugins.finalcutpro.timeline.playhead.tracking <cp.prop: boolean; read-only; live>`                                                                    |
| **Type**                                    | Variable                                                                     |
| **Description**                             | If `true`, we are tracking the playhead position.                                                                     |
| **Notes**                                   | None |
| **Source**                                  | [src/plugins/finalcutpro/timeline/playhead.lua line 76](https://github.com/CommandPost/CommandPost/blob/develop/src/plugins/finalcutpro/timeline/playhead.lua#L76) |

---

---

<script src="https://giscus.app/client.js"
        data-repo="CommandPost/CommandPost"
        data-repo-id="MDEwOlJlcG9zaXRvcnk3NDY0NTk2NQ=="
        data-category="Website Discussion"
        data-category-id="DIC_kwDOBHMBzc4CXFFA"
        data-mapping="pathname"
        data-strict="0"
        data-reactions-enabled="1"
        data-emit-metadata="0"
        data-input-position="bottom"
        data-theme="dark"
        data-lang="en"
        crossorigin="anonymous"
        async>
</script>