IMPROVEMENTS: - AUDIO CAN NOW BE IMPORTED TO KEYFRAME GRAPHS. - To animate a parameter along to an audio track, you’ll need an audio file from the same part of your timeline as the clip you’re animating with Keyframe Toolbox. The audio file needs to be the same length as the clip to which Keyframe Toolbox has been applied. If you don’t have the audio file already, an easy way to create this file is to: 1. Press R, to select the Range Selection tool. 2. Click the clip you plan to animate, to select it as a range. 3. Choose File > Share > Export File (⌘E) and save an audio-only file as a WAV. - In Keyframe Toolbox, choose the parameter you want to animate, such as Scale, click the graph menu, then choose Import Audio as Graph. - After processing, controls appear below the graph: - Upper limit — the highest value produced. - Lower limit — the lowest value produced. - Bend — to smooth the transition between keyframes. This will not be visible with shorter clips, where one keyframe will be added for each video frame, but can be important for longer clips. - Number of keyframes — lower numbers are faster to work with, but less precise. The maximum value is 1000, and it’s recommended to limit the duration of audio to about 5 minutes. - Lower Frequency — the lowest frequency recognised. - Upper Frequency — the highest frequency recognised. - Control the lower and upper frequency values to reveal specific instruments or sounds from your exported file. - Important: the Upper and Lower limit of the audio controls are set beyond the Upper and Lower limits of the graph, the audio graph will be clipped. This allows you to remove quieter parts of the graph by setting the audio lower limit to a lower value than the graph’s lower limit. - As with the presets, the controls disappear if you move a keyframe manually. - VELOCITY GRAPHS HAVE BEEN ADDED. Thanks for requesting, Alex Lindsay! - Enable "Velocity" in Settings to show a velocity graph behind each keyframe graph, instead of the default grid lines. - The Velocity graph shows change in speed, is scaled automatically to fill the space available, and cannot be edited directly. - OPTIONAL SCALE X AND SCALE Y GRAPHS HAVE BEEN ADDED. Thanks for requesting, yoggypap and many others! - If you wish, enable "Scale X" and/or "Scale Y" graphs in Settings. - You can use any combination of Scale, Scale X and Scale Y that you wish. - NUMERIC EDITING FOR ALL BELOW-GRAPH CONTROLS AND LIMITS - This includes the new Import Audio to Graph feature. - Double-click any value or limit, then type a number, or use up+down arrows to change values by 1. Add Shift for ±10, Option for ±100. - OPACITY CAN OPTIONALLY FADE TO BLACK. - This helps to avoid strange results when applying some third-party filters after Keyframe Toolbox is set to a low opacity. Note that this can also be an issue with FCP’s built-in opacity controls. BUG FIXES: - The fit button now expands to show all handles. Thanks for reporting, pbetan! - OSC controls can now push through graph limits, and they'll adjust them in real time as you push past them. Thanks for reporting, Moritz Holzinger!

IMPROVEMENTS: - KEYFRAME TOOLBOX 360 REFRAME HAS BEEN ADDED. Thanks for requesting, many people! Please read and follow the Quick Start instructions in the effect before using it. - To reframe 360° footage, you'll apply the new, dedicated effect: Keyframe Toolbox 360 Reframe. If you don't see it, please run the Keyframe Toolbox app, then restart FCP. - Standard Keyframe Toolbox graph controls can be used with a new set of properties, including Pan, Tilt, Field of View and Roll. Additionally, Opacity, Distortion and Blur can be added in Settings. - A new Projection button at the top switches between five ways to reframe your footage: - Rectilinear will never curve a straight line, but allows Field of View up to 180°. - Wide/Panini is a cylindrical view that allows a Field of View up to 220°. - Fisheye allows more distortion around the edges of frame, and allows a Field of View up to 360°. - Stereographic is the default projection, and it allows smooth transitions between a normal Field of View and (if Pan is adjusted down) a Tiny Planet-style view. - Tiny Planet is a stereographic projection with a Tilt and Field of View offset to make it easier to achieve this effect — it defaults to looking down, with a wider FOV. - In each Projection, Field of View is interpreted slightly differently, and each has different Distortion parameters behind the scenes too. - To animate smoothly between perspectives, choosing the Stereographic projection and recording keyframes on the Field of View property is usually enough. However, if you want more control, consider also animating the Distortion parameter. This graph is disabled by default, but can be enabled in Settings. - NEW KEYFRAMES NOW MAINTAIN EXISTING CURVES MORE CLOSELY - Previously, newly added keyframes defaulted to linear, unless Command was held. Now, if the new keyframe is along a curve, it will be created with handles that maintain that curve. - While creating a new keyframe in the OSC, you can still hold Command or Option to force new flat handles to be created. - If you want a linear keyframe, it's still easy to Command- or Option-click on a keyframe to remove its handles. - THE KEYFRAME TOOLBOX EFFECT NOW USES A MORE FLEXIBLE HEIGHT - The Inspector will always maintain enough space for all visible graphs to be shown at standard size. - Graphs can still be minimized to make more room for larger graphs, but minimized graphs will be returned to standard size next time the effect is loaded. If any graphs are expanded, they will remain expanded. - To force the Inspector to update, simply select any other clip, then reselect a clip with Keyframe Toolbox. - In some rare situations, when most graphs were hidden and are then all made visible at once, there may not be enough space to show the header and the graphs in the limited space available. This is temporary. Simply select any other clip, then reselect the clip you want to work on, and the Inspector will return to normal. BUG FIXES: - An issue with incorrect Position values being shown in Better Performance mode has been fixed. - Linking keyframes is now more reliable and resilient. - Previous/next keyframe buttons in the OSC are more reliable. - Keyframes now light up (when the playhead is over them) more reliably. - Performance improvements have been made to the regular Keyframe Toolbox effect. If you ever experienced a delay when loading a timeline with multiple instances of Keyframe Toolbox, this has now been improved. - Potential issues with very large images have been resolved. Note that Keyframe Toolbox is now limited to images no larger than 8500px across.

IMPROVEMENTS: - ON-SCREEN CONTROLS (OSC) HAVE BEEN ADDED. - Thanks for requesting, Dylan Bates and others! - Labels appear while the diamonds are dragged. - Position is in the centre, Rotation Z/X/Y are on spokes, Scale has a circle, Opacity is above and Blur is below. - Click or drag the colour-matched diamonds for any of the existing properties to create a new linear keyframe at the current time. - Command-click or drag an OSC diamond to create a new keyframe with easing handles applied. - Keyframe diamonds are now filled in if they are at the current playhead position, in the OSC and in the graphs. - Clicking a filled keyframe diamond in the OSC will delete that keyframe. (This doesn’t happen in the graph.) - Use the previous/next buttons around each keyframe to jump to the neighbouring keyframe on that property. - If you hold Shift while adjusting Position keyframes, you’ll constrain movement to only one dimension and only create a keyframe on that graph. - Motion paths are shown, using diamonds to indicate keyframe positions (on X, Y, or both) and white dots to indicate tweened frames. - On-screen controls can be instantly hidden by activating the Live/OSC mode, using Caps Lock. (Note that the Live Scrubbing button in the Inspector has been renamed.) - If you prefer not to see the OSC at all, it can be disabled in Settings. - KEYFRAMES ON DIFFERENT PROPERTY GRAPHS CAN BE LINKED. - Thanks for requesting, Dylan Bates! - Two or more keyframes positioned at the same point in time can now be linked with the Link Keyframes command in the right-click or graph menus. - Linked keyframes are drawn with a thicker outline. - Handle direction, handle length and keyframe time positions are synced between linked keyframes. - Keyframes can be unlinked manually. Select one or more keyframes and choose “Unlink Keyframe(s)” in the menu. (When only one keyframe would remain linked, it is also unlinked.) - Keyframes are also unlinked if a preset or paste operation would affect a linked keyframe. - KEYFRAME TIMING IS NOW FRAME-ACCURATE IN ABSOLUTE MODE. - Previously, if you added an Oscillate preset to Position Y to create a bouncing animation, the lowest point of each bounce might not have been visible, because keyframes in the graph might not have landed exactly on real frames in the clip. This is only visible in moments where a very quick direction change occurs (like a bounce) but it’s been seen in Apple Motion and Adobe Animate too. - In Absolute Timing mode, keyframes are now snapped to real frames, so every keyframe in the graphs represents a real frame on-screen. Every bounce will land. - In Relative Timing mode, not every keyframe will end up exactly on a frame, because the graph needs to stretch to match any clip length. While this is rarely visible, switching to Absolute Timing mode will fix any issues. Alternatively, fix these issues manually with the OSC, by Shift-dragging the visible object position to the desired position. - PLAYHEAD MOVEMENT CAN BE DISABLED IN SETTINGS TO WORK AROUND A STORYLINE BUG IN FINAL CUT PRO. - If possible, avoid using Keyframe Toolbox on clips in storylines. - In a storyline, we recommend to uncheck Playhead Movement in Settings. This lets you use Keyframe Toolbox in storylines without unwanted playhead jumps. Why? - In a secondary storyline, the playhead cannot be moved reliably, as the clip's timecode is not accurately reported. We also can't reliably detect that a clip is in a secondary storyline and disable these features automatically. As a result, the playhead is likely to jump to near the start of your timeline instead of the correct position. - Playhead movement includes clicking in the graphs to move the playhead to a specific position, jumping to a keyframe position when editing a keyframe numerically, moving the playhead in the graphs when Live Scrubbing is active, and using the previous/next keyframe buttons in the OSC.

IMPROVEMENTS: - Clicking the name of a property creates a keyframe at the current time, maintaining the current graph shape. - Shift-clicking a property name creates a keyframe on all graphs. Thanks for requesting, Honusan and others! - Related — clicking the name of a property while over a keyframe (or double-clicking the keyframe property name) opens that keyframe for numeric editing. Thanks for requesting, Honusan and others! - Graphs can now be zoomed horizontally. Use two fingers on a trackpad or hold option while scrolling. Alternatively, double-click in empty space to zoom in to show just 25% of the graph width. When zoomed in, a scroll indicator at the bottom shows the visible part of the total graph. This can be dragged manually. Alternatively, you can scroll with a horizontal scroll on a trackpad or by holding shift while using a scroll wheel. Thanks for requesting, Jake, Honusan and others! - Presets can be saved, using the new Save Preset option at the end of the Presets menu. When you apply one of your own presets, you’ll be able to control limits, scale handles up or down, and flip the preset as you can with the other presets. Thanks for requesting, cinestillsamurai, Honusan and others! - Use Manage Presets, in the same menu, to reveal a folder containing all your presets. Share presets with your friends if you wish! - Renaming presets renames them in the menu; deleting them removes them. - Easing has been added to the graph menu and right-click menu, for Ease In, Ease Out, or Ease In+Out, for many common curve types (Linear, Sine, Quad, Cubic, Quart, Quint, Circ, Expo, Back). If you’re a fan of Easy Ease in After Effects, try Sine here. Note that selecting two or more keyframes applies easing to the curves between the presets, while selecting a single keyframe applies easing to the handles around that keyframe. Thanks for requesting something like this, Alex Gollner! - Clicking on a line connecting two keyframes selects both keyframes. This makes it easier to apply easing to the graph between two keyframes. (Note that double-clicking on a line still creates a new linear keyframe.) - Settings can now be saved as default. If you always want to use Motion Blur and Absolute Timing, set your preferred options, then press the new button at the bottom of the Settings panel. This affects new instances of Keyframe Toolbox. Thanks for requesting, Honusan! - In Absolute Timing mode, time is now shown in frames and timecode. If a clip is less than a minute long, only seconds and frames are shown. Thanks for requesting, Honusan! - Several improvements to numeric editing. - When you double-click a keyframe, the playhead moves to that frame so you can see your changes directly. - When editing values numerically, use up/down to change by 1, ⇧-up/down to change by 10, and (new!) ⌥-up/down to change by 100. - Changing values with arrow keys now immediately updates a keyframe or handle. - Left and right arrow keys now switch to editing neighbouring keyframes (and move the playhead) so you can easily edit all values in a graph numerically if you wish. - If you wish, hold Command while using the scroll wheel to move the playhead. BUG FIXES: - Important: property changes now more closely follow extreme graph curves. Please check any existing animations to make sure they're still doing what you want; very minor tweaks may be needed. - Scrolling behavior is more consistent. - It's easier to select groups of keyframes.