- Installing Reactor Visually
- Installing Reactor for Fusion Manually
- Using Reactor Content on a Fusion Render Node
- Uninstalling Reactor Manually
- Creating the AllData Folder
Installing Reactor Visually
The
Reactor-Installer.lua
script makes it quick and easy to set up Reactor inside of Fusion or Resolve.Step 1. Drag the Reactor-Installer.lua script from a folder on your desktop into the Fusion Standalone Console tab, or the Resolve Fusion page "Nodes" view. Alternatively, you could paste the Reactor Installer Lua script code into the Fusion Console tab text input field manually and the installer script will be run.
Step 2. Click the "Install and Relaunch" button. After a few seconds the Reactor Installer progress bar will appear and the installation will proceed.
A
Reactor.fu
file will be downloaded from the Reactor GitLab repository and is saved to the Fusion user prefs location at Config:/Reactor.fu
. Also being written is a new AllData:Reactor:/System/Reactor.cfg
file that is used to control what repositories are used with Reactor.When the installer finishes, Fusion will restart automatically and the Reactor Package Manager will be displayed.
Installing Reactor for Fusion Manually
If you are a studio system admin/pipeline TD and need more control over the Reactor install process you can manually download files from the GitLab repo and install the tool by yourself.Step 1. To install Reactor, download
Reactor.fu
and place it in your Fusion Config:/
directory.Windows
Config:/
Installation Path:%appdata%\Blackmagic Design\Fusion\Config\Reactor.fu
Mac
Config:/
Installation Path:$HOME/Library/Application Support/Blackmagic Design/Fusion/Config/Reactor.fu
Linux
Config:/
Installation Path:$HOME/.fusion/BlackmagicDesign/Fusion/Config/Reactor.fu
Note:
$HOME
represents your current user account's home folder.Step 2. The next time Fusion is launched a new "Reactor" menu will be added. Selecting the Reactor > Open Reactor... menu item will open the "Fusion Reactor" Package Manager window.
! | Note: Since Resolve 15 does not support the use of a .fu file for creating menu entries, it is recommended that Reactor for Resolve be installed only by the automated Lua installer script. This is due to the fact there are more files to copy in place so a manual installation would be more complex to describe and support. |
Using Reactor Content on a Fusion Render Node
You can use your Reactor installed content on your render nodes so they have the exact same fuses and plugins installed as your Fusion Studio based workstations have.This is done by opening the Fusion Render Node's preferences up and setting your PathMaps to match what you have configured on your own workstation's Fusion Studio PathMap preferences so they are 1:1 identical.
This means you should re-create the Fusion Studio style PathMap settings like this on each of your render nodes:
User PathMap Entry
From:
Reactor:
To:
C:\ProgramData\Blackmagic Design\Fusion\Reactor\
If you have moved Reactor to a new installation location on your network share you would change the "To" section entry to point to that custom location you have placed the files at. This would be the folder you have set in your "REACTOR_INSTALL_PATHMAP" environment variable.
Defaults PathMap Entry
From:
UserPaths:
To:
UserData:;AllData:;Fusion:;Reactor:Deploy
The
UserPaths:
section is where you define the folders that hold your fusion user preferences. Each PathMap location you define here will have a full set of sub-folders created during Fusion or Fusion Render Node's startup for holding the custom addons you can use with Fusion like:- Bins
- Brushes
- Config
- Defaults
- Filters
- Fuses
- Guides
- Layouts
- Library
- LUTs
- Macros
- Modules
- Plugins
- Scripts
- Settings
- Stamps
Optional Extra PathMap Entry
This extra setting can be configured on a render node if you want to be very thorough with your install. It is not strictly required but is a good idea to have for the future as this setting will become useful a few months from now when more Lua/Python scripted features and atoms are added to the toolset.
From:
Scripts:
To:
UserPaths:Scripts;Reactor:System/Scripts
Fusion Render Node Preference File
The Fusion Render Node preference file has the filename of RenderNode.prefs that is located on your system in this PathMap folder:Profile:/
On Windows this works out to:
%AppData%\Blackmagic Design\Fusion\Profiles\Default\
On Linux this works out to:
$HOME/.fusion/BlackmagicDesign/Fusion/Profiles/Default/
On MacOS this works out to:
$HOME/Library/Application Support/Blackmagic Design/Fusion/Profiles/Default/
Uninstalling Reactor Manually
Step 1. To uninstall Reactor from your system you need to remove the downloaded Reactor "atom" content by deleting the Reactor folder that is located in your shared Fusion
AllData:/Reactor:/
folder.The
AllData:/Reactor:/
folder is located here:Fusion Paths
Windows Reactor Path:
C:\ProgramData\Blackmagic Design\Fusion\Reactor\
Mac Reactor Path:
/Library/Application Support/Blackmagic Design/Fusion/Reactor/
Linux Reactor Path:
/var/BlackmagicDesign/Fusion/Reactor/
Reolve Paths
Windows Reactor Path:
C:\ProgramData\Blackmagic Design\DaVinci Resolve\Fusion\Reactor\
Mac Reactor Path:
/Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Reactor/
Linux Reactor Path:
/var/BlackmagicDesign/DaVinci Resolve/Fusion/Reactor/
Step 2. If you are using Fusion you should remove the Reactor.fu file from your Fusion user preferences Config:/ directory. This will stop the Reactor menu item from being added to Fusion.
Step 3. Open the Fusion Preferences window and switch to the "Global and Default Settings > PathMap" section.
In the "User" section of the PathMap view click on the entry for the "Reactor:" PathMap. Then press the Delete button.
Scroll up to the "Defaults" section and click on the "UserPaths:" entry. Edit the text in the "To" field and remove the words ";Reactor:Deploy". Be sure to keep the rest of the settings in textfield.
Scroll up in the "Defaults" section and click on the "Scripts:" entry. Edit the text in the "To" field and remove the words ";Reactor:System/Scripts". Be sure to keep the rest of the settings that are in textfield.
Step 4. Restart Fusion. Reactor will have been cleanly removed from your system.
Creating the AllData Folder
If you are on macOS and seeAllData:
PathMap folder permission errors in the Console tab or during the Reactor install process, it likely means you have deleted the AllData:
folder at some point and need to manually re-create the directory. Fusion on macOS appears to lack the permissions required to regenerate that folder automatically.The error messages would look like:
[Reactor Error] Disk permissions error when saving: /Library/Application Support/Blackmagic Design/Fusion/Reactor/System/Reactor.lua/
Here are the macOS terminal commands to re-create the
AllData:
Pathmap folder:- # Re-create the Fusion 9.02 "AllData:" PathMap Folder on macOS:
- # Make the folders
- sudo mkdir -p "/Library/Application Support/Blackmagic Design/Fusion/"
- # -------------------------------------------------------------------
- # Change the "Blackmagic Design" folder's owner to root
- sudo chown -R "root" "/Library/Application Support/Blackmagic Design/"
- # Change the "Blackmagic Design" folder's group to wheel
- sudo chgrp "wheel" "/Library/Application Support/Blackmagic Design/"
- # Change the "Blackmagic Design" folder permissions to 755 / "drwxr-xr-x"
- sudo chmod 755 "/Library/Application Support/Blackmagic Design/"
- # -------------------------------------------------------------------
- # Change the "Fusion" folder's group to admin
- sudo chgrp -R "admin" "/Library/Application Support/Blackmagic Design/Fusion/"
- # Change the "Fusion" folder permissions to 777 / "drwxrwxrwx"
- sudo chmod 777 "/Library/Application Support/Blackmagic Design/Fusion/"
- # -------------------------------------------------------------------
- # List the folder contents and permissions
- ls -laR "/Library/Application Support/Blackmagic Design"
- # Open the Fusion Folder in a Finder browsing window
- open "/Library/Application Support/Blackmagic Design/Fusion/"