# plugins.finalcutpro.timeline.audioeffects

Controls Final Cut Pro's Audio Effects.

# API Overview

Functions - API calls offered directly by the extension


Signature	`plugins.finalcutpro.timeline.audioeffects(action) -> boolean`
Type	Function
Description	Applies the specified action as a audio effect.
Parameters	`action` - A table with the name/category/theme for the audio effect to apply, or a string with just the name.
Returns	`true` if a matching audio effect was found and applied to the timeline.
Notes	Expects action to be a table with the following structure: `lua</li><li>{ name = "XXX", category = "YYY", theme = "ZZZ" }</li><li>` ...where `"XXX"`, `"YYY"` and `"ZZZ"` are in the current FCPX language. The `category` and `theme` are optional, but if they are known it's recommended to use them, or it will simply execute the first matching audio effect with that name. Alternatively, you can also supply a string with just the name.
Examples	None
Source	src/plugins/finalcutpro/timeline/audioeffects.lua line 19