Mouse Settings

Configure mouse wheel scroll speed, zoom speed, and direction for timeline navigation.

Open from Settings > Mouse (keyboard shortcut: Cmd+, then select the Mouse tab).

Settings

Setting	Type	Default	Range	Description
Scroll Speed	float	1.0×	0.5×–2.0×	Mouse wheel scroll sensitivity
Reverse Scroll	bool	Off	—	Invert scroll wheel direction
Zoom Speed	float	1.0×	0.5×–2.0×	Mouse wheel zoom sensitivity
Reverse Zoom	bool	Off	—	Invert zoom wheel direction

Scroll Speed

Controls how fast the timeline scrolls when using the mouse wheel. The slider is centered at 1.0× (default), with slower speeds to the left and faster to the right.

0.5× — Half speed, for fine control
1.0× — Default system speed
2.0× — Double speed, for quick navigation

Reverse Scroll

Toggle to invert the scroll direction. When enabled, scrolling up moves the timeline content down (and vice versa), matching “natural” scrolling on macOS trackpads.

Zoom Speed

Controls how fast the timeline zooms when using Option + mouse wheel (or Alt + mouse wheel on Windows/Linux). Uses the same 0.5×–2.0× range as scroll speed.

Reverse Zoom

Toggle to invert the zoom direction. When enabled, scrolling up zooms out and scrolling down zooms in.

Mouse Wheel Modifiers

Action	Input
Vertical scroll	Mouse wheel
Horizontal scroll	Shift + mouse wheel
Zoom	Option + mouse wheel

Lua API

-- Get scroll sensitivity
local speed = pl.cmd("settings:get", { key = "mouse.scroll_sensitivity" })

-- Set scroll speed to 1.5×
pl.cmd("settings:set", { key = "mouse.scroll_sensitivity", value = "1.5" })

-- Enable reverse scroll
pl.cmd("settings:set", { key = "mouse.invert_scroll", value = "true" })

-- Get zoom sensitivity
local zoom = pl.cmd("settings:get", { key = "mouse.zoom_sensitivity" })

-- Set zoom speed to 0.8×
pl.cmd("settings:set", { key = "mouse.zoom_sensitivity", value = "0.8" })

-- Enable reverse zoom
pl.cmd("settings:set", { key = "mouse.invert_zoom", value = "true" })

All Storage Keys

Key	Type	Default	Range
`mouse.scroll_sensitivity`	float	`1.0`	0.5–2.0
`mouse.invert_scroll`	bool	`false`	—
`mouse.zoom_sensitivity`	float	`1.0`	0.5–2.0
`mouse.invert_zoom`	bool	`false`	—