← Documentation

Blender Submitter

Boost your Blender projects with the speed and efficiency of cloud rendering.

Installation

Download Latest Addon

renderfarm_submitter_v7.zip

  1. Download the .zip file above (do not extract it)
  2. In Blender: Edit → Preferences → Add-ons → Install…
  3. Browse to the downloaded .zip and click Install Add-on
  4. Find "Renderfarm Submitter" in the list and enable it
  5. Restart Blender if prompted
The addon is compatible with Blender 3.x and 4.x. Older versions may work but are not officially supported.

Panel Overview

After installation, the Renderfarm Render Submitter panel appears in Properties → Render. It is divided into the following sections:

  • Conductor Job — title, project selection, submit button
  • General Configuration — machine type, preemptible toggle, retry count
  • Render Settings — output path, format, camera override
  • Frames — frame range, chunk size, scout frames, tiled rendering
  • Add-ons — additional Blender add-ons to activate on the render node
  • Advanced — environment variables, upload paths, custom metadata

Connecting to the Farm

Click the Connect button in the Conductor Job section.

  1. A login form appears — enter your renderfarm.swade-art.com email and password
  2. Click Connect to authenticate
  3. Your available projects will populate the Project dropdown
  4. Available machine types will populate the Machine Type dropdown
Your session token is stored locally in Blender so you only need to connect once. Click Disconnect to log out.

Submitting a Job

  1. Set your Blender render settings (engine, resolution, samples, output format)
  2. In the Renderfarm panel, select your Project
  3. Choose a Machine Type appropriate for your scene
  4. Set your frame range (or use Blender's scene range)
  5. Set chunk size (frames per task — 1 for maximum parallelism)
  6. Optionally set scout frames to preview a few frames first
  7. Click Submit — your .blend file and all assets are uploaded automatically
Make sure your output path is set to a local directory. The farm will write outputs to the configured path on GCS. Relative paths like //renders/ work correctly.

Frame Spec Syntax

The frame range field accepts a powerful syntax for describing which frames to render:

SpecDescriptionExample
1-100All frames from 1 to 1001, 2, 3 … 100
1-100x2Every 2nd frame1, 3, 5 … 99
1-100x10Every 10th frame1, 11, 21 … 91
1,50,100Specific frames1, 50, 100
fml:3First, middle, last — N samples1, 50, 100 (of 1-100)
fml:5Five evenly spread frames1, 25, 50, 75, 100
auto:3Automatic split into N tasks3 evenly sized chunks
1-10,50-60Multiple ranges1–10 and 50–60
fml:N (first-middle-last) is ideal for scout frames — use it to quickly preview your scene before committing to a full render.

Scout Frames

Scout frames let you render a small preview set first. All remaining tasks are held on the farm until you approve the scouts from the dashboard.

To use scout frames:

  1. Enable the "Use Scout Frames" toggle in the Frames section
  2. Enter a frame spec like fml:3 to render first/middle/last
  3. Submit the job — scouts render immediately, other tasks are held (Waiting)
  4. Review the scout outputs on the job detail page
  5. Click "Release All Tasks" to start the full render, or Cancel to abort
Chunk size interacts with scout frames. If chunk size is 10 and you use fml:3, the scout spec selects individual frames — you will still get 3 tasks each rendering one frame, regardless of chunk size. The chunk size applies to non-scout tasks.

Troubleshooting

ProblemLikely CauseFix
Cannot connectWrong credentials or session expiredClick Disconnect then Connect again
No machine types listedNo machines enabled in Enterprise settingsAdmin: go to Enterprise → Studio Management → Available Instances
Job stuck in "Syncing"Large scene file or slow uploadWait for upload to complete; check network connection
Render output is blankWrong output path or missing cameraSet output path to //renders/ and verify camera is set
Missing textures on farmTextures not packed or not in upload pathsFile → External Data → Pack Resources, then resubmit
Auth token expired mid-sessionSession timed outDisconnect and reconnect in the addon panel