KBar support for Keystone 2
Last updated
Was this helpful?
Last updated
Was this helpful?
Kbar is a widely used extension for After Effects that allows to create customizable toolbars. More informations on: https://aescripts.com/kbar/
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.
Download a .kbar file below
Go in KBar settings (right-click inside a KBar, then click KBar Settings)
Enter the Settings tab
Import the Keystone-2.kbar
file using the Import from .kbar button
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.
Go in KBar settings (right-click inside a KBar, then click KBar Settings)
Click Add Button
Click Open Extension
On the first line, find and click on Keystone 2 in the list.
Indicate the CSEvent data on the second line (see the tables below)
Add the corresponding description (optional)
Add the corresponding icon (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
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.
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
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.
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
.