> 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: <https://aescripts.com/kbar/>

<figure><img src="/files/sAQznjBb8iTjLFSQchGo" alt=""><figcaption></figcaption></figure>

## 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)

<figure><img src="/files/VdRsv8TFCwWSenDR4zVS" alt=""><figcaption></figcaption></figure>

<table data-full-width="false"><thead><tr><th width="90" align="center">Icons</th><th width="259">CSEvent data</th><th>Description (optional)</th></tr></thead><tbody><tr><td align="center"><img src="/files/RNweV0P6Hpoi9BcLjjt7" alt="" data-size="line"></td><td><strong><code>keyLabels</code></strong></td><td>Keyframe labels</td></tr><tr><td align="center"><img src="/files/zEq3PAnrqR5DD4XBQN5q" alt="" data-size="line"></td><td><strong><code>keyAlignCTI</code></strong></td><td>Align keyframes on the CTI</td></tr><tr><td align="center"><img src="/files/896f8Ull06qF11wTPlHT" alt="" data-size="line"></td><td><strong><code>keyAlignEndPoints</code></strong></td><td>Align keyframes on the layer in/out point</td></tr><tr><td align="center"><img src="/files/is6kiVQFHVhgygwzW0Wu" alt="" data-size="line"></td><td><strong><code>keyStagger</code></strong></td><td>Stagger keyframes</td></tr><tr><td align="center"><img src="/files/qjAobgd6BIpDCtLKA4nF" alt="" data-size="line"></td><td><strong><code>keyDistribute</code></strong></td><td>Distribute keyframes evenly</td></tr><tr><td align="center"><img src="/files/c22bnchHeJiNwQXI99fN" alt="" data-size="line"></td><td><strong><code>keyStretch</code></strong></td><td>Stretch keyframes</td></tr><tr><td align="center"><img src="/files/wzwKWKn8tUBuvGYoF0lg" alt="" data-size="line"></td><td><strong><code>keyShift</code></strong></td><td>Shift keyframes</td></tr><tr><td align="center"><img src="/files/SQ8xN1AxlVHse26QQ6ec" alt="" data-size="line"></td><td><strong><code>keyDuplicate</code></strong></td><td>Duplicate on the CTI</td></tr><tr><td align="center"><img src="/files/bvkaPepC8pqpSXpws9OS" alt="" data-size="line"></td><td><strong><code>keyDuplicateFlip</code></strong></td><td>Duplicate and flip on the CTI</td></tr><tr><td align="center"><img src="/files/CagWAmugs5WYRiS32E9s" alt="" data-size="line"></td><td><strong><code>keyFlip</code></strong></td><td>Flip the keyframes</td></tr><tr><td align="center"><img src="/files/8SCbq0CMGU78qNwesVtH" alt="" data-size="line"></td><td><strong><code>keyCopyPaste</code></strong></td><td>Copy / Paste keyframes</td></tr><tr><td align="center"><img src="/files/jjCVVsIyy3brUQEbT4yn" alt="" data-size="line"></td><td><strong><code>keyAlignNearestFrame</code></strong></td><td>Align on the nearest frame</td></tr><tr><td align="center"><img src="/files/eq9XE0trVxTh8IxhbyUZ" alt="" data-size="line"></td><td><strong><code>keyConstantSpeed</code></strong></td><td>Set constant Speed</td></tr><tr><td align="center"><img src="/files/edmrjqmHNZ60Bcrso7Zy" alt="" data-size="line"> </td><td><strong><code>keyOverlapCleaning</code></strong></td><td>Delete all keys between selected keys</td></tr><tr><td align="center"><img src="/files/zyMsPSyciURtDuHcHXKe" alt="" data-size="line"></td><td><strong><code>layerLabels</code></strong></td><td>Layer labels</td></tr><tr><td align="center"><img src="/files/YnaQrER80lDF4PdPzhQR" alt="" data-size="line"></td><td><strong><code>layerAlign</code></strong></td><td>Align layers</td></tr><tr><td align="center"><img src="/files/pGTJndPJlYN1kHFZQGox" alt="" data-size="line"></td><td><strong><code>layerStagger</code></strong></td><td>Stagger layers</td></tr><tr><td align="center"><img src="/files/UN4f8rc8m0eeNk3kI2vK" alt="" data-size="line"></td><td><strong><code>layerStretch</code></strong></td><td>Stretch layers</td></tr><tr><td align="center"><img src="/files/VT87YLBt1B1uGyRCQiSn" alt="" data-size="line"></td><td><strong><code>layerShift</code></strong></td><td>Shift layers</td></tr><tr><td align="center"><img src="/files/sVzTo58lAMVgooiKiKTw" alt="" data-size="line"></td><td><strong><code>layerTrim</code></strong></td><td>Trim layers</td></tr></tbody></table>

### 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`)

<figure><img src="/files/pp0C5y7JtOE7gu4h3G6v" alt=""><figcaption></figcaption></figure>

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 %}

<table data-full-width="false"><thead><tr><th width="87" align="center">Icons</th><th width="295">CSEvent data</th><th>Description (optional)</th></tr></thead><tbody><tr><td align="center"><img src="/files/zEq3PAnrqR5DD4XBQN5q" alt="" data-size="line"></td><td><strong><code>keyAlignFirstKeyCTI</code></strong></td><td>Align on the first keyframe</td></tr><tr><td align="center"><img src="/files/ns9oT1CYxxQ5ml9nxyN7" alt="" data-size="line"></td><td><strong><code>keyAlignLastKeyCTI</code></strong></td><td>Align on the last keyframe</td></tr><tr><td align="center"><img src="/files/896f8Ull06qF11wTPlHT" alt="" data-size="line"></td><td><strong><code>keyAlignInPoint</code></strong></td><td>Align on the layer in point</td></tr><tr><td align="center"><img src="/files/ffbCewdQC7xZ34NdjXO7" alt="" data-size="line"></td><td><strong><code>keyAlignOutPoint</code></strong></td><td>Align on the layer out point</td></tr><tr><td align="center"><img src="/files/xRBSIg7UB97szECrBNkJ" alt="" data-size="line"></td><td><strong><code>keyShift10FramesLeft</code></strong></td><td>Shift 10 frames to the left</td></tr><tr><td align="center"><img src="/files/Fsbt8Dd3X31QcQa9WH55" alt="" data-size="line"></td><td><strong><code>keyShift1FrameLeft</code></strong></td><td>Shift 1 frame to the left</td></tr><tr><td align="center"><img src="/files/LxJmon18s2NTCmKWSRIq" alt="" data-size="line"></td><td><strong><code>keyShift1FrameRight</code></strong></td><td>Shift 1 frame to the right</td></tr><tr><td align="center"><img src="/files/wzwKWKn8tUBuvGYoF0lg" alt="" data-size="line"></td><td><strong><code>keyShift10FramesRight</code></strong></td><td>Shift 10 frames to the right</td></tr><tr><td align="center"><img src="/files/YnaQrER80lDF4PdPzhQR" alt="" data-size="line"></td><td><strong><code>layerAlignInPointCTI</code></strong></td><td>Align layers in point on the CTI</td></tr><tr><td align="center"><img src="/files/HZ2LISMPNqrWskyOn1j5" alt="" data-size="line"></td><td><strong><code>layerAlignOutPointCTI</code></strong></td><td>Align layers out point on the CTI</td></tr><tr><td align="center"><img src="/files/VhoafLIgtnhpwg0tocKG" alt="" data-size="line"></td><td><strong><code>layerAlignInPoint</code></strong></td><td>Align layers on the earliest in point</td></tr><tr><td align="center"><img src="/files/7pA6B059pNL8FfjXYugg" alt="" data-size="line"></td><td><strong><code>layerAlignOutPoint</code></strong></td><td>Align layers on the latest out point</td></tr><tr><td align="center"><img src="/files/Z2xDpXCaHIIdN8UsjPA9" alt="" data-size="line"></td><td><strong><code>layerShift10FramesLeft</code></strong></td><td>Shift 10 frames to the left</td></tr><tr><td align="center"><img src="/files/gOOrW8puPFqp908t3ETP" alt="" data-size="line"></td><td><strong><code>layerShift1FrameLeft</code></strong></td><td>Shift 1 frame to the left</td></tr><tr><td align="center"><img src="/files/yKMltXJ7sjjQYK7VCnvF" alt="" data-size="line"></td><td><strong><code>layerShift1FrameRight</code></strong></td><td>Shift 1 frame to the right</td></tr><tr><td align="center"><img src="/files/VT87YLBt1B1uGyRCQiSn" alt="" data-size="line"></td><td><strong><code>layerShift10FramesRight</code></strong></td><td>Shift 1 frame to the right</td></tr><tr><td align="center"><img src="/files/eJvQnwXt4y4VjiWQc4BY" alt="" data-size="line"></td><td><strong><code>layerTrimFirstKey</code></strong></td><td>Trim layer on the first keyframe</td></tr><tr><td align="center"><img src="/files/mmwmSFJklbZM3rxPsvQJ" alt="" data-size="line"></td><td><strong><code>layerTrimLastKey</code></strong></td><td>Trim layer on the last keyframe</td></tr><tr><td align="center"><img src="/files/sVzTo58lAMVgooiKiKTw" alt="" data-size="line"></td><td><strong><code>layerTrimAllKeys</code></strong></td><td>Trim layer on the first and last keyframes</td></tr></tbody></table>

## 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`**.

<figure><img src="/files/YIUA0ecAP8aUTxxqBjNy" alt=""><figcaption></figcaption></figure>

{% 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 %}