> For the complete documentation index, see [llms.txt](https://romaincousin.gitbook.io/keystone-2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://romaincousin.gitbook.io/keystone-2/kbar-support.md). # KBar support for Keystone 2 *Kbar* is a widely used extension for After Effects that allows to create customizable toolbars.\ More informations on:

## Installing Keystone 2 features with .kbar files (recommended) The easiest and most recommended way to set up the features of Keystone 2 in KBar is to use the .kbar files. It contains all KBar-compatible Keystone 2 functions and associated icons. {% stepper %} {% step %} **Download** a .kbar file below {% file src="/files/o8Q0l3q2ePz3klu8ZnQO" %} Contains all the Keystone 2 functions in the most compact way possible (recommended) {% endfile %} {% file src="/files/eyKiVkviDJWJtnrR1MXb" %} [Individual / window-less features](#invididual-window-less-features) (optional) {% endfile %} {% endstep %} {% step %} Go in **KBar settings** (right-click inside a KBar, then click **KBar Settings**) {% endstep %} {% step %} Enter the **Settings** tab {% endstep %} {% step %} Import the `Keystone-2.kbar` file using the **Import from .kbar** button {% endstep %} {% endstepper %} {% hint style="warning" %} ### Switching from "jsx" to "Extension" buttons In the latest releases (**v2.04 +**), Keystone 2 uses KBar 3's **"Extension"** buttons. This change from the previous **"jsx"** buttons makes installation much easier for users, as it is no longer necessary to enter the path to the Keystone 2 .jsx file, and features run a little faster. * **"jsx"** type buttons are now deprecated and may no longer work. * **"Extension"** buttons are only available on **KBar v3**. * In order for Keystone 2 features to work in KBar, the **Keystone 2 main extension must be open**. However, it can be hidden behind any other After Effects panel or script. {% endhint %} ## Install Keystone 2 features manually 1. Go in **KBar settings** (right-click inside a KBar, then click **KBar Settings**) 2. Click **Add Button** 3. Click **Open Extension** 4. On the first line, find and click on **Keystone 2** in the list. 5. Indicate the **CSEvent data** on the second line ([see the tables below](#icons-and-script-functions)) 6. Add the corresponding **description** (optional) 7. Add the corresponding **icon** (optional)

Icons	CSEvent data	Description (optional)
	`keyLabels`	Keyframe labels
	`keyAlignCTI`	Align keyframes on the CTI
	`keyAlignEndPoints`	Align keyframes on the layer in/out point
	`keyStagger`	Stagger keyframes
	`keyDistribute`	Distribute keyframes evenly
	`keyStretch`	Stretch keyframes
	`keyShift`	Shift keyframes
	`keyDuplicate`	Duplicate on the CTI
	`keyDuplicateFlip`	Duplicate and flip on the CTI
	`keyFlip`	Flip the keyframes
	`keyCopyPaste`	Copy / Paste keyframes
	`keyAlignNearestFrame`	Align on the nearest frame
	`keyConstantSpeed`	Set constant Speed
	`keyOverlapCleaning`	Delete all keys between selected keys
	`layerLabels`	Layer labels
	`layerAlign`	Align layers
	`layerStagger`	Stagger layers
	`layerStretch`	Stretch layers
	`layerShift`	Shift layers
	`layerTrim`	Trim layers

### Invididual / Window-less features By default, certain features are grouped together in a single KBar button, which displays a window of options when clicked. (e.g. `keyShift`)

Following on from the previous example of `keyShift`, you may wish to use the single functions allowing you to simply move keyframes by 1 or 10 frames without displaying the options window. {% hint style="info" %} * Modes (`property`, `layer` or `global`) are always accessible by using the appropriate [hotkey](/keystone-2/modes-hotkeys.md) directly on the KBar button. * Options for linking layers and keyframes are not available. {% endhint %}

Icons	CSEvent data	Description (optional)
	`keyAlignFirstKeyCTI`	Align on the first keyframe
	`keyAlignLastKeyCTI`	Align on the last keyframe
	`keyAlignInPoint`	Align on the layer in point
	`keyAlignOutPoint`	Align on the layer out point
	`keyShift10FramesLeft`	Shift 10 frames to the left
	`keyShift1FrameLeft`	Shift 1 frame to the left
	`keyShift1FrameRight`	Shift 1 frame to the right
	`keyShift10FramesRight`	Shift 10 frames to the right
	`layerAlignInPointCTI`	Align layers in point on the CTI
	`layerAlignOutPointCTI`	Align layers out point on the CTI
	`layerAlignInPoint`	Align layers on the earliest in point
	`layerAlignOutPoint`	Align layers on the latest out point
	`layerShift10FramesLeft`	Shift 10 frames to the left
	`layerShift1FrameLeft`	Shift 1 frame to the left
	`layerShift1FrameRight`	Shift 1 frame to the right
	`layerShift10FramesRight`	Shift 1 frame to the right
	`layerTrimFirstKey`	Trim layer on the first keyframe
	`layerTrimLastKey`	Trim layer on the last keyframe
	`layerTrimAllKeys`	Trim layer on the first and last keyframes

## Download *Keystone 2* icons {% file src="/files/6fMy7TuLBzv7RQktjupB" %} {% hint style="info" %} The icons are in svg format, so feel free to modify them if you wish. {% endhint %} ## Suffixes *(optional)* It is possible to add a suffix to the end of the script function in order to force *Keystone 2* to group keyframes by layer, by property or all together. * **`-LAYER`** groups keyframes by layer. Correspond to the **default** behaviour of a simple click. * **`-PROPERTY`** groups keyframes by property. Correspond to the **`ALT (⌥)`** + **`click`** behaviour. * **`-GLOBAL`** groups keyframes all together. Correspond to the **`SHIFT`** + **`click`** behaviour. ### Suffix Example **`keyAlignFirstKeyCTI-PROPERTY`** will force the alignement of all the selected keyframes of each property on the CTI without having to use the combination **`ALT (⌥)`** + **`click`**.

{% hint style="info" %} * Suffixes are **optional** and without any suffix the hotkeys **`ALT (⌥)`** and **`SHIFT`** apply like in the main extension. * Suffixes are not available for all features (e.g. *Constant speed*, *Overlap cleaning*, *Align to nearest frame*...) {% endhint %}