In order to have Render workbench fully functional, you must give it access to one or more external rendering engines. To achieve that, you must follow a 2-step process:
- Install the rendering engine(s) on your system.
- Set up this/these external rendering engine(s) in Render workbench.
We are aware that installation, particularly the set up of a rendering engine, can be a daunting and even dissuasive step. Therefore, if you encounter any difficulty, please do not hesitate to report an issue in order for us to help you and also to improve the process for other users.
To use Render Workbench, you must first install one of the supported rendering engines on your system.
At the moment, the following engines are supported:
- Pov-Ray
- LuxCoreRender
- Appleseed
- Blender Cycles ( standalone )
- Intel Ospray Studio
- Pbrt v4 (experimental)
The precise installation procedure for each of those engines should be first searched on their respective websites. However, you will find below some indications for a few platforms.
After installing, it is recommended to make sure your rendering engine is fully functional: test scenes are usually provided with the renderer for that purpose, please refer to its documentation.
You'll also find a 'Test' button on the settings screen for each renderer, so you can make sure that the settings you've entered for a renderer make sense for Render Workbench.
Each renderer has some configurations to be set in Edit > Preferences > Render before being able to use it.
At least, you must fill in the path to your renderer executable, in the corresponding section. This is a mandatory step, otherwise the workbench will not be able to run the engine when required. Some renderers may provide two flavours of their engine: a command-line and a GUI; in which case you should fill in both.
Optionally, you may want to add some command-line parameters (for instance, to activate GPU rendering, or to specify halt conditions etc.: see your renderer's documentation) to renderer invocation. In that case, you can use the dedicated field 'Render parameters' in your renderer section.
Optionally as well, you can set a few renderer-wide parameters:
Prefix: A prefix that can be added before the renderer executable invocation. This is useful, for example, to add environment variables or run the renderer inside a GPU switcher such as primusrun or optirun on Linux. This parameter is fully optional and can be left empty if not needed.Default render width,default render height: the default dimensions of the rendering output. Default values are 800x600 and can be left as-is if no special dimensions are required.
Install
Povray is in the repo, so just do it the simple way:
sudo apt install povray
Set up
In workbench settings, enter /usr/bin/povray in 'PovRay executable path'.
Caveat: this install is easier (and lighter), but you won't be able to run Luxcorerender in batch mode
Install
Download Luxcore binaries package from website, with this link:
Standalone release v2.6
Choose a target directory for the application. Let's call it <appdir>.
Unzip the downloaded package file into <appdir>
Set up
In workbench settings:
- Leave 'LuxCore command (cli) path' blank.
- Enter
<appdir>/LuxCore/luxcoreuiin 'LuxCore UI path'
Install
Download Luxcore binaries package from website, with this link:
LuxCore API SDK release v2.6
Choose a target directory for the application. We'll call it <appdir>.
Unzip the downloaded package file into <appdir>
Copy all the files in <appdir>/LuxCore-sdk/lib/ to <appdir>/LuxCore-sdk/bin/.
Very important: If you miss this step, you'll get some fatal "cannot open shared object file: No such file or directory" messages...
Set up
In workbench settings:
- Enter
<appdir>/LuxCore-sdk/bin/luxcoreconsolein 'LuxCore command (cli) path' - Enter
<appdir>/LuxCore-sdk/bin/luxcoreuiin 'LuxCore UI path'
Install
Download Appleseed binaries package from website, with this link:
Appleseed for Linux
Choose a target directory for the application. We'll call it <appdir>.
Unzip the downloaded package file into <appdir>
Install Python 2.7 library
sudo apt install libpython2.7
(Very important)
Set up
In workbench settings:
- Enter
<appdir>/appleseed/bin/appleseed.cliin 'Appleseed command (cli) path' - Enter
<appdir>/appleseed/bin/appleseed.studioin 'Appleseed Studio path'
Install
Download Ospray Studio binaries package from website, with this link:
Ospray Studio for Linux
Choose a target directory for the application. We'll call it <appdir>.
Unzip the downloaded file into <appdir>
Set up
In workbench settings:
- Enter
<appdir>/ospray_studio-0.12.1.x86_64.linux/bin/ospStudioin 'OspStudio executable path'
Cycles standalone has to be compiled from sources. See https://github.com/blender/cycles
Warning: Installing Cycles standalone from sources can be tricky and time-consuming, see below. You'll be warned...
Pbrt has to be compiled from sources. See https://github.com/mmp/pbrt-v4
In Archlinux, all renderers have been packaged, either in official repositories or in AUR.
There is just a point of attention: for a given renderer, it can exist several packages in AUR (version, -git etc.) and not all will fit correctly. The following array gathers the recommended packages and the corresponding workbench settings:
| Renderer | Repo | Package | Workbench Settings | |
|---|---|---|---|---|
| Povray | Official | povray |
PovRay executable path: | /usr/bin/povray |
| LuxCore | AUR | luxcorerender |
LuxCore command (cli) path: LuxCore UI path: |
/usr/bin/luxcoreconsole /usr/bin/luxcoreui |
| Appleseed | AUR | appleseed-git |
Appleseed command (cli) path: Appleseed Studio path: |
/usr/bin/appleseed.cli /usr/bin/appleseed.studio |
| Ospray | AUR | ospray-studio |
OspStudio executable path: | /usr/bin/ospStudio |
| Cycles | AUR | cycles-standalone |
Cycles executable path: | /usr/bin/cycles |
| Pbrt | AUR | pbrt-v4-git |
Pbrt executable path: | /usr/bin/pbrt |
Install
Download Povray 3.7 installer: https://www.povray.org/ftp/pub/povray/Official/povwin-3.7-agpl3-setup.exe
Run Povray installer.
Set up
Look for pvengine64.exe on your system. In Render settings, fill 'PovRay executable path' with <path/to/pvengine64.exe>
Install
Download Luxcore binaries package from website, with this link:
LuxCore API SDK release v2.6
Choose a target directory for the application. We'll call it <appdir>.
Unzip the downloaded package file into <appdir>
As stated in Download page (https://luxcorerender.org/download/):
All Windows executables require the Visual C++ Redistributable Packages for
VS 2017 and Intel C++ redistributable.
Please check your system meets those requirements, or update it accordingly.
Set up
In workbench settings:
- Enter
<appdir>/luxcorerender-v2.6-win64-sdk/bin/luxcoreconsole.exein 'LuxCore command (cli) path' - Enter
<appdir>/luxcorerender-v2.6-win64-sdk/bin/luxcoreui.exein 'LuxCore UI path'
Install
Download Appleseed binaries package from website, with this link:
Appleseed for Windows
Choose a target directory for the application. We'll call it <appdir>.
Unzip the downloaded package file into <appdir>
Set up
In workbench settings:
- Enter
<appdir>/appleseed/bin/appleseed.cli.exein 'Appleseed command (cli) path' - Enter
<appdir>/appleseed/bin/appleseed.studio.exein 'Appleseed Studio path'
Install
Download Ospray Studio installer: https://github.com/ospray/ospray_studio/releases/download/v0.12.1/ospray_studio-0.12.1.x86_64.windows.msi
Run Ospray Installer
Set up
Look for ospStudio.exe on your system. In Render settings, fill 'OspStudio executable path' with <path/to/ospStudio.exe>
Users @MisterMakerNL and @metalex201 provide precompiled versions, many thanks to them:
https://github.com/metalex201/Cycles-standalone-windows-build. [4.0.0]
https://github.com/MisterMakerNL/Cycles-stand-alone-windows-build. [1.13.4]
Download the repository as a zip, unzip to a target directory and enter the path to binary to 'Cycles (standalone) executable path' field.
In other cases, for instance for those who like challenges, Cycles standalone can be compiled from sources, from here: https://github.com/blender/cycles
Compiling Cycles standalone from sources can be tricky and time-consuming; it is recommended to stick to precompiled versions - you'll be warned.
Pbrt has to be compiled from sources. See https://github.com/mmp/pbrt-v4
To use Cycles renderer with Render workbench, you need a standalone version of Cycles, named Cycles Standalone. This version is distinct from the one embedded in Blender. You will find some more information about Cycles Standalone in the dedicated Blender wiki page.
No precompiled binaries are provided by Blender team in standard environments.
In several environments, however, you'll be able to find such binaries, on the initiatives of advanced users (thanks to them!): see per-platform instructions above.
Mac OS Big Sur users may also find some valuable instructions here.
In other cases, Cycles Standalone may require compilation from sources. Sources and compilation instructions can be found here.
As an alternative, in the (fairly rare) case you already compile Blender by
yourself, you can enable WITH_CYCLES_STANDALONE and
WITH_CYCLES_STANDALONE_GUI in cmake variables (I also had to add -lGLU to
CMAKE_EXE_LINKER_FLAGS) before your build process. You will then get a
separate 'cycles' executable compiled together with Blender.
Caveat: Compiling Cycles Standalone can be tricky and time-consuming. If you don't have access to binaries, but if you have no taste for poorly documented installation procedures or if you have no time to waste, you should rather consider using Appleseed, LuxCoreRender or Ospray, which both provide ready-to-use binaries for many platforms, along with excellent rendering features.
In practical terms, at first rendering, LuxCore seems to hang with the following message:
"[PathOCL kernel] Compiling kernels".
BE PATIENT, DO NOT INTERRUPT RENDERING AT THIS STAGE.
The compilation will eventually reach completion after a few minutes. And for subsequent renderings, the compiled kernels will be cached and reused, without recompilation.
Most of the indications above rely on external information that can vary.
Please do not hesitate to open an issue to report errors, dead links, out-of-date information, questions and so on.