Skip to content

aturtur/fusion-scripts

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

68 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Aturtur's Fusion Scripts

My collection of Blackmagic Design Fusion Studio (standalone) scripts (@aturtur.bsky.social).

Latest release version 1.7.0 (Released 12.01.2026)

All of the scripts are developed and tested with Windows 11 machine. All of the scripts might not work in Linux or Mac.

Changelog

Changes coming in 1.8.0

  • 20.05.2026 New: ar_TransformFromTracker.
  • 17.05.2026 New: ar_UpdateScriptCollection.
  • 17.05.2026 Updated: ar_ScriptLauncher.
  • 18.03.2026 Updated: ar_RevealInExplorer, ar_Snapshot.
  • 18.03.2026 New: ar_PasteColor, ar_PasteImage.
  • 06.03.2026 Updated: ar_OpenMacroFolder, ar_OpenScriptsFolder, ar_OpenFusesFolder.
  • 26.02.2026 Updated: ar_VersionUp.
  • 20.02.2026 Updated: ar_RangeManager, ar_JumpToFrame.
  • 07.02.2026 New: ar_SwapViews.
  • 30.01.2026 Updated: ar_OpenProjectVersion.
  • 28.01.2026 New: ar_OpenProjectVersion.
  • 28.01.2026 Updated: ar_AlignNodes.
  • 27.01.2026 New: ar_EnableSelected, ar_DisableSelected.
  • 23.01.2026 Updated: ar_ClearViews.
  • 22.01.2026 Change: Replaced pyautogui with keyboard library.
  • 22.01.2026 Updated: ar_AddMetadata, ar_ScriptLauncher.
  • 20.01.2026 New: ar_Snapshot.

Changes in 1.7.0

  • 09.01.2026 Bug fix: ar_RangeManager.
  • 13.12.2025 Updated: ar_SetCompResolution.
  • 13.12.2025 Bug fix: ar_LoaderFromSaver.
  • 04.12.2025 Change: Scripts' prefix changed AR_ → ar_ for better readability.
  • 21.11.2025 Updated: ar_JumpToFrame, ar_RangeManager.

Check all changes in CHANGELOG.md file.

Installation

Warning

Use these scripts with your own risk!

  1. Install Python 3 (64-bit) if you don't have it installed.
  2. Download the latest ar_Scripts_Fusion release.
  3. Put script files to one of these paths:
    • C:/Appdata/Roaming/Blackmagic Design/Fusion/Scripts/Comp
    • C:/ProgramData/Blackmagic Design/Fusion/Scripts/Comp
    • C:/Program Files/Blackmagic Design/Fusion 20/Scripts/Comp
    • Or setup custom scripts path with Path Map.
  4. Some of the scripts requires third-party libraries.
    • You can install all dependencies using pip install -r requirements.txt.
    • Or install manually with pip install [module name]:
      • keyboard
      • pillow
      • pyperclip
      • tabulate

If you want the latest scripts (including an experimental ones too), download this repository and use scripts from it.

How to use

In Blackmagic Design Fusion software select the Script tab in the main toolbar and select the script you want to run.

Note

In Blackmagic Design Fusion 20 there is a bug that sometimes the selected node stays selected even though it's not selected in the flow. This causes some scripts to fail. To resolve this you have to reopen the composition.

Notices

  • Some scripts requires a specific tool selection and or active tool selection!
  • Some scripts requires a specific attributes from selected tool e.g. TOOLI_ImageWidth and TOOLI_ImageHeight, these are not provided by every tool so be cautious about it.

Script descriptions

ar_2DTrackerTo3DSpace ar_2DTrackerTo3DSpace (GUI)

Default: Creates a setup that converts active 2D tracker's point to 3D space.

ar_AddMetadata ar_AddMetadata (GUI)

Default: Adds metadata nodes.
Dependencies: keyboard.

ar_AlignImage ar_AlignImage (GUI)

Default: Aligns merge node's foreground image according to the background image.
How to use: Select merge node that has foreground and background inputs connected, then press the button where you want to align the foreground image.

ar_AlignNodes ar_AlignNodes (GUI)

Default: Align selected nodes.

ar_CropToDoD ar_CropToDoD

Default: Crops to selected tools' DoD (Domain of Definition).

ar_AutoWhiteBalanceFromSampleImage ar_AutoWhiteBalanceFromSampleImage

Default: Creates an auto white balance setup from selected sample image tool.\nCurrent frame is used as a reference frame.
It's recommended to bake sample image values, before using this script.

ar_CleanNodeNames ar_CleanNodeNames

Default: Cleans node names (eg. ..._1_1_1_1_1).
Supports expressions.

ar_ClearViews ar_ClearViews

Default: Clears all views (preview windows).
Shift: Clears B buffers views (preview windows).

ar_Colorise ar_ColoriseNodes (GUI)

Default: Colorises selected nodes.

ar_CopyPathToClipboard ar_CopyPathToClipboard

Default: Copies selected tool(s) path(s) to the clipboard.
Dependencies: Pyperclip.

ar_CopyToolNameToClipboard ar_CopyToolNameToClipboard

Default: Copies selected tool(s) name(s) to the clipboard.
Dependencies: Pyperclip.

ar_CreateLocator3D ar_CreateLocator3D

Default: Creates a Locator3D node connected to selected 3D shape.

ar_ClearViews ar_CreateSaver

Default: Creates a saver for selected tools with custom export settings.
Edit the script to match your saver settings.

ar_CropToRoI ar_CropToRoI (GUI)

Default: Crops the canvas to the region of interest.

ar_DisableAllSavers ar_DisableAllSavers

Default: Disables all savers in the active composition.

ar_DisableSelected ar_DisableSelected

Default: Disables selected tool(s) in the active composition.

ar_EnableAllSavers ar_EnableAllSavers

Default: Enables all savers in the active composition.

ar_EnableSelected ar_EnableSelected

Default: Enables selected tool(s) in the active composition.

ar_FreezeFrame ar_FreezeFrame

Default: Creates a time_speed node that freezes frame at current frame.
Fusion now has this functionality built-in to the TimeSpeed tool.

ar_ImportFolder ar_ImportFolder (GUI)

Default: Import all image sequences from selected folder.
Currently supports only image sequences.

ar_JoinTiles ar_JoinTiles

Default: Merges selected tools into one big image, based on node positions in Flow.
Tiles has to line up perfectly! Use Arrange Tools → to Grid.

ar_JumpToFrame ar_JumpToFrame (GUI)

Default: Jumps to the given frame in the timeline.
Shift: Get the frame. Ctrl+1-8: Jumps to the frame (1-8 slots).

ar_LoaderFromSaver ar_LoaderFromSaver

Default: Creates loader(s) from selected saver(s).

ar_MergeComp ar_MergeComp (GUI)

Default: Merges the given composition with the active one.
Basically copy pastes the given composition into the open composition.
Dependencies:: Pyperclip.

ar_MergeSelected ar_MergeSelected

Default: Merges selected tools with merge nodes.

ar_MoveAnchorPoint ar_MoveAnchorPoint (GUI)

Default: Moves the anchor point (pivot) using the DoD values.

ar_MoveNodes ar_MoveNodes (GUI)

Default: Moves selected node(s).

ar_MultiMergeSelected ar_MultiMergeSelected

Default: Merge selected tools using a multi merge tool.

ar_NoteFromLoader ar_NoteFromLoader

Default: Creates a sticky note filled with info from the selected loader(s).

ar_NoteFromMetadata ar_NoteFromMetadata

Default: Creates a sticky note filled with metadata from selected tool(s).

ar_OffsetKeyframes ar_OffsetKeyframes

Default: Offsets all keyframes of selected tool(s) by given value.

ar_OpenFusesFolder ar_OpenFusesFolder

Default: Opens the folder where Fuses are located.
Default path: Appdata.

ar_OpenMacroFolder ar_OpenMacroFolder

Default: Opens the folder where Macros are located.
Default path: Appdata.

ar_OpenProjectFolder ar_OpenProjectFolder

Default: Opens the folder where the project file is located.

ar_OpenProjectVersion ar_OpenProjectVersion (GUI)

Default: Lists all versions of the project. Uses '_v' delimiter.

ar_OpenScriptFolder ar_OpenScriptFolder

Default: Opens the script folder in explorer.
Default path: Appdata.

ar_PasteColor ar_PasteColor

Default: Creates a background with the hex color from the clipboard.
Dependencies: pypercut.

ar_PasteImage ar_PasteImage

Default: Creates a loader from the image from the clipboard.
Saves the image from the clipboard to the assets folder under the project folder. If the project is not saved, saves to the temp folder.
Dependencies: pillow.

ar_PrintMetadata ar_PrintMetadata

Default: Prints metadata from active tool.

ar_PrintUsedLoaders ar_PrintUsedLoaders

Default: Prints file paths that loaders of the current composition uses.

ar_PrintUsedSavers ar_PrintUsedSavers

Default: Prints file paths that savers of the current composition uses.

ar_RangeManager ar_RangeManager (GUI)

Set global and render range easily.
Option to save ranges with comments in a sticky note and load settings from it. Default: Set render range. Shift: Get render range. Ctrl: Set global range. Ctrl+Shift: Get global range.

ar_ReloadLoader ar_ReloadLoader

Default: Reloads selected loaders and extends ranges if needed.

ar_RemoveKeyframes ar_RemoveKeyframes

Default: Removes all keyframes from selected tool(s).

ar_RemoveKeyframesAfterCurrentFrame ar_RemoveKeyframesAfterCurrentFrame

Default: Removes all keyframes from selected tool(s) after the current frame. Global End Time is the start frame!

ar_RemoveKeyframesBeforeCurrentFrame ar_RemoveKeyframesBeforeCurrentFrame

Default: Removes all keyframes from selected tool(s) before the current frame.\nGlobal Start Time is the start frame!

ar_ResizeCanvas ar_ResizeCanvas (GUI)

Default: Resize canvas of the selected tool.
Width and height inputs supports basic calculations.

ar_RevealInExplorer ar_RevealInExplorer

Default: Opens saver's or loader's media input in the explorer.

ar_ReverseCrop ar_ReverseCrop

Default: Puts the cropped image back in place.

ar_ReverseSetup ar_ReverseSetup

Default: Reverses the node setup of the selected tools (basic workflow).

Supported nodes:

  • Aces Transform (All Input Transforms can't we swapped to Output)
  • BrightnessContrast
  • Cineon Log
  • Color Space Transform
  • Gamut

ar_ReverseStabilizationSetup ar_ReverseStabilizationSetup

Default: Creates reverse stabilization setup for clean up painting from a active Tracker Node.

ar_SampleImage ar_SampleImage

Default: Creates a sample image setup for the selected tool(s).

ar_ScaleToFitComp ar_ScaleToFitComp

Default: Scales foreground image to fit background image's width and height.
Requires that the merge tool is active!

ar_ScaleToFitCompHeight ar_ScaleToFitCompHeight

Default: Scales proportionally foreground image to fit background image's height.
Requires that the merge tool is active!

ar_ScaleToFitCompWidth ar_ScaleToFitCompWidth

Default: Scales proportionally foreground image to fit background image's width.
Requires that the merge tool is active!

ar_ScriptLauncher ar_ScriptLauncher (GUI)

Default: Search and run sripts easily.
Dependencies: keyboard (recommended but not required.)
Scans script from folder where ar_ScriptLauncher is located, subfolders included.

Gets the name of the script with Name-US: and the tooltip with Description-US.

Highly recommended to add this script to hotkey:

  • View → Customize Hotkeys...
    • Views → New...
      • E.g. Shift+Tab
        • Scripts → ar_ScriptLauncher

ar_SelectAllLoaders ar_SelectAllLoaders

Default: Selects all loader tools of the active composition.

ar_SelectAllThisType ar_SelectAllThisType

Default: Selects all tools that are same type as the current active tool.

ar_SelectAllThisTypeSameColor ar_SelectAllThisTypeSameColor

Default: Selects all tools that are same type and same color as the current active tool.

ar_SetCompResolution ar_SetCompResolution

Default: Sets composition's frame format resolution from the active tool.

ar_SetRangeFromMetadata ar_SetRangeFromMetadata

Default: Sets global and render range from selected tool's metadata.

ar_SetRangeFromTool(s) ar_SetRangeFromTool(s)

Default: Sets global and render range from selected tool(s).

ar_SetRangeGlobalToRender ar_SetRangeGlobalToRender

Default: Sets global range to match render range.

ar_SetRangeRenderToGlobal ar_SetRangeRenderToGlobal

Default: Sets render range to match global range.

ar_SetRangeCurrentFrame ar_SetRangeCurrentFrame

Default: Sets render range to the current frame.

ar_Snapshot ar_Snapshot (GUI)

Default: Takes a snapshot from a given viewer. Snapshots are saved to snapshot folder placed in project file folder.
The project has to be saved first!

ar_SplitEXRFile ar_SplitEXRFile

Default: Splits EXR loader to multiple loaders.

ar_SplitToTiles ar_SplitToTiles (GUI)

Default: Splits the active tool in to tiles by given rows and columns.

ar_Stack ar_Stack (GUI)

Default: Stacks selected tools' image output horizontally or vertically.

ar_SwapViews ar_SwapViews

Default: Swaps the views (left and right views), including B buffers.

ar_SwitchFromSelected ar_SwitchFromSelected

Default: Creates a switch tool from selected tools.

ar_Tracker(Points)ToGridWarp ar_Tracker(Points)ToGridWarp

Default: Connects Tracker's points to GridWarp's published points.

How to use: Select the Tracker and the GridWarp tools and run the script.
Make sure the point count is same in Tracker and GridWarp (published points).
Tracker point IDs starts from 1 and GridWarp point IDs starts from 0.

Note: Use clean Tracker and clean GridWarp!
Tracker point count and count of published GridWarp points must be the same!
Order of the points must be the same!

ar_Tracker(UnsteadyPosition)ToGridWarp ar_Tracker(UnsteadyPosition)ToGridWarp

Default: Connects Tracker's unsteady position to GridWarp's published points.
How to use: Select the Tracker and the GridWarp tools and run the script.
Use clean Tracker and clean GridWarp!

ar_TransformFromTracker ar_TransformFromTracker

Default: Creates a Transform tool from selected Tracker.

ar_TrimLoaderWithTimecode(SMPTE) ar_TrimLoaderWithTimecode(SMPTE) (GUI)

Default: Trims the loader with SMPTE timecode.
Loader's media has to have timecode in its metadata!

ar_UpdateScriptCollection ar_UpdateScriptCollection

Default: Updates the JSON-file, that contains information about the scripts, used by ar_ScriptLauncher.

ar_VersionUp ar_VersionUp (GUI)

Default: Easily change between different versions.

Support the project

If you find these scripts useful, consider supporting the project to keep it up and running: Tip jar.

Contact

Website
Bluesky

About

My collection of Fusion scripts

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages