1BLENDER(1)                  General Commands Manual                 BLENDER(1)
2
3
4
5Color management: Error could not find role data role.  Blender 2.82 (sub 7)"
6
7

NAME

9       blender - a full-featured 3D application
10

SYNOPSIS

12       blender [args ...] [file] [args ...]
13

DESCRIPTION

15       blender  is a full-featured 3D application. It supports the entirety of
16       the 3D pipeline - modeling, rigging, animation, simulation,  rendering,
17       compositing, motion tracking, and video editing.
18
19       Use  Blender to create 3D images and animations, films and commercials,
20       content for games, architectural and industrial visualizatons, and sci‐
21       entific visualizations.
22
23       https://www.blender.org
24

OPTIONS

26       Color  management: using fallback mode for management Color management:
27       Error could not find role data  role.   Blender  2.82  (sub  7)  Usage:
28       blender [args ...] [file] [args ...]
29
30   Render Options:
31       -b or --background
32              Run in background (often used for UI-less rendering).
33
34
35       -a or --render-anim
36              Render frames from start to end (inclusive).
37
38
39       -S or --scene <name>
40              Set the active scene <name> for rendering.
41
42
43       -f or --render-frame <frame>
44              Render frame <frame> and save it.
45
46
47              * +<frame> start frame relative, -<frame> end frame relative.
48              * A comma separated list of frames can also be used (no spaces).
49              *  A  range  of  frames  can  be  expressed using '..' separator
50              between the first and last frames (inclusive).
51
52
53       -s or --frame-start <frame>
54              Set start to frame <frame>, supports  +/-  for  relative  frames
55              too.
56
57
58       -e or --frame-end <frame>
59              Set end to frame <frame>, supports +/- for relative frames too.
60
61
62       -j or --frame-jump <frames>
63              Set number of frames to step forward after each rendered frame.
64
65
66       -o or --render-output <path>
67              Set the render path and file name.
68              Use  '//'  at  the  start  of the path to render relative to the
69              blend-file.
70
71
72              The '#' characters are replaced by the frame number, and used to
73              define zero padding.
74
75
76              * 'animation_##_test.png' becomes 'animation_01_test.png'
77              * 'test-######.png' becomes 'test-000001.png'
78
79
80              When  the  filename  does  not contain '#', The suffix '####' is
81              added to the filename.
82
83
84              The frame number will be added at the end of the filename, eg:
85              # blender -b animation.blend -o //render_ -F PNG -x 1 -a
86
87
88       -E or --engine <engine>
89              Specify the render engine.
90              Use '-E' help to list available engines.
91
92
93       -t or --threads <threads>
94              Use amount of <threads> for rendering and other operations
95              [1-1024], 0 for systems processor count.
96
97
98   Format Options:
99       -F or --render-format <format>
100              Set the render format.
101              Valid options are:
102
103
104              Formats that can be compiled into Blender, not available on  all
105              systems:
106
107
108       -x or --use-extension <bool>
109              Set option to add the file extension to the end of the file.
110
111
112   Animation Playback Options:
113       -a <options> <file(s)>
114              Instead  of  showing Blender's user interface, this runs Blender
115              as an animation player,
116              to view movies and image sequences rendered in Blender  (ignored
117              if '-b' is set).
118
119
120              Playback Arguments:
121
122
123              -p <sx> <sy>
124                Open with lower left corner at <sx>, <sy>.
125              -m
126                Read from disk (Do not buffer).
127              -f <fps> <fps-base>
128                Specify FPS to start with.
129              -j <frame>
130                Set frame step to <frame>.
131              -s <frame>
132                Play from <frame>.
133              -e <frame>
134                Play until <frame>.
135
136
137   Window Options:
138       -w or --window-border
139              Force opening with borders.
140
141
142       -W or --window-fullscreen
143              Force opening in fullscreen mode.
144
145
146       -p or --window-geometry <sx> <sy> <w> <h>
147              Open  with  lower left corner at <sx>, <sy> and width and height
148              as <w>, <h>.
149
150
151       -M or --window-maximized
152              Force opening maximized.
153
154
155       -con or --start-console
156              Start with the console window open (ignored  if  '-b'  is  set),
157              (Windows only).
158
159
160       --no-native-pixels
161              Do not use native pixel size, for high resolution displays (Mac‐
162              Book 'Retina').
163
164
165       --no-window-focus
166              Open behind other windows and without taking focus.
167
168
169   Python Options:
170       -y or --enable-autoexec
171              Enable automatic Python script execution.
172
173
174       -Y or --disable-autoexec
175              Disable automatic Python script execution (pydrivers  &  startup
176              scripts), (compiled as non-standard default).
177
178
179       -P or --python <filename>
180              Run the given Python script file.
181
182
183       --python-text <name>
184              Run the given Python script text block.
185
186
187       --python-expr <expression>
188              Run the given expression as a Python script.
189
190
191       --python-console
192              Run Blender with an interactive console.
193
194
195       --python-exit-code <code>
196              Set  the  exit-code in [0..255] to exit if a Python exception is
197              raised
198              (only for scripts executed from the  command  line),  zero  dis‐
199              ables.
200
201
202       --python-use-system-env
203              Allow  Python  to  use  system  environment  variables  such  as
204              'PYTHONPATH'.
205
206
207       --addons <addon(s)>
208              Comma separated list of add-ons (no spaces).
209
210
211   Logging Options:
212       --log <match>
213              Enable logging categories, taking a single comma separated argu‐
214              ment.
215              Multiple categories can be matched using a '.*' suffix,
216              so '--log "wm.*"' logs every kind of window-manager message.
217              Use "^" prefix to ignore, so '--log "*,^wm.operator.*"' logs all
218              except for 'wm.operators.*'
219              Use "*" to log everything.
220
221
222       --log-level <level>
223              Set the  logging  verbosity  level  (higher  for  more  details)
224              defaults to 1,
225              use -1 to log all levels.
226
227
228       --log-show-basename
229              Only show file name in output (not the leading path).
230
231
232       --log-show-backtrace
233              Show a back trace for each log message (debug builds only).
234
235
236       --log-show-timestamp
237              Show a timestamp for each log message in seconds since start.
238
239
240       --log-file <filename>
241              Set a file to output the log to.
242
243
244   Debug Options:
245       -d or --debug
246              Turn debugging on.
247
248
249              * Enables memory error detection
250              *  Disables  mouse  grab  (to  interact  with a debugger in some
251              cases)
252              * Keeps Python's 'sys.stdin' rather than setting it to None
253
254
255       --debug-value <value>
256              Set debug value of <value> on startup.
257
258
259       --debug-events
260              Enable debug messages for the event system.
261
262
263       --debug-handlers
264              Enable debug messages for event handling.
265
266
267       --debug-libmv
268              Enable debug messages from libmv library.
269
270
271       --debug-cycles
272              Enable debug messages from Cycles.
273
274
275       --debug-memory
276              Enable fully guarded memory allocation and debugging.
277
278
279       --debug-jobs
280              Enable time profiling for background jobs.
281
282
283       --debug-python
284              Enable debug messages for Python.
285
286
287       --debug-depsgraph
288              Enable all debug messages from dependency graph.
289
290
291       --debug-depsgraph-eval
292              Enable debug messages from dependency graph related  on  evalua‐
293              tion.
294
295
296       --debug-depsgraph-build
297              Enable  debug  messages  from  dependency graph related on graph
298              construction.
299
300
301       --debug-depsgraph-tag
302              Enable debug messages from dependency graph related on tagging.
303
304
305       --debug-depsgraph-no-threads
306              Switch dependency graph to a single threaded evaluation.
307
308
309       --debug-depsgraph-time
310              Enable debug messages from dependency graph related on timing.
311
312
313       --debug-depsgraph-pretty
314              Enable colors for dependency graph debug messages.
315
316
317       --debug-gpu
318              Enable gpu debug context and information for OpenGL 4.3+.
319
320
321       --debug-gpumem
322              Enable GPU memory stats in status bar.
323
324
325       --debug-gpu-shaders
326              Enable GPU memory stats in status bar.
327
328
329       --debug-gpu-force-workarounds
330              Enable GPU memory stats in status bar.
331
332
333       --debug-wm
334              Enable debug messages for the window manager, shows  all  opera‐
335              tors in search, shows keymap errors.
336
337
338       --debug-all
339              Enable all debug messages.
340
341
342       --debug-io
343              Enable debug messages for I/O (collada, ...).
344
345
346       --debug-fpe
347              Enable floating point exceptions.
348
349
350       --disable-crash-handler
351              Disable the crash handler.
352
353
354       --disable-abort-handler
355              Disable the abort handler.
356
357
358   Misc Options:
359       --app-template <template>
360              Set  the application template (matching the directory name), use
361              'default' for none.
362
363
364       --factory-startup
365              Skip reading the BLENDER_STARTUP_FILE in the users  home  direc‐
366              tory.
367
368
369       --enable-event-simulate
370              Enable   event   simulation   testing   feature  'bpy.types.Win‐
371              dow.event_simulate'.
372
373
374       --env-system-datafiles
375              Set the BLENDER_SYSTEM_DATAFILES environment variable.
376
377
378       --env-system-scripts
379              Set the BLENDER_SYSTEM_SCRIPTS environment variable.
380
381
382       --env-system-python
383              Set the BLENDER_SYSTEM_PYTHON environment variable.
384
385
386       -noaudio
387              Force sound system to None.
388
389
390       -setaudio
391              Force sound system to a specific device.
392
393
394       -h or --help
395              Print this help text and exit.
396
397
398       -R
399              Register blend-file extension, then exit (Windows only).
400
401
402       -r
403              Silently  register  blend-file  extension,  then  exit  (Windows
404              only).
405
406
407       -v or --version
408              Print Blender version and exit.
409
410
411       --
412              End  option  processing,  following  arguments passed unchanged.
413              Access via Python's 'sys.argv'.
414
415
416   Other Options:
417       /?
418              Print this help text and exit (windows only).
419
420
421       --debug-freestyle
422              Enable debug messages for Freestyle.
423
424
425       --debug-ghost
426              Enable debug messages for event handling.
427
428
429       --verbose <verbose>
430              Set logging verbosity level for debug  messages  which  supports
431              it.
432
433
434       --disable-library-override
435              Enable Library Override features in the UI.
436
437
438   Argument Parsing:
439        Arguments must be separated by white space, eg:
440         # blender -ba test.blend
441         ...will exit since '-ba' is an unknown argument.
442
443   Argument Order:
444        Arguments are executed in the order they are given. eg:
445         #  blender  --background  test.blend --render-frame 1 --render-output
446       '/tmp'
447         ...will not render  to  '/tmp'  because  '--render-frame  1'  renders
448       before the output path is set.
449         # blender --background --render-output /tmp test.blend --render-frame
450       1
451         ...will not render to '/tmp' because  loading  the  blend-file  over‐
452       writes the render output that was set.
453         # blender --background test.blend --render-output /tmp --render-frame
454       1
455         ...works as expected.
456

ENVIRONMENT VARIABLES

458         $BLENDER_USER_CONFIG      Directory for user configuration files.
459         $BLENDER_USER_SCRIPTS     Directory for user scripts.
460         $BLENDER_SYSTEM_SCRIPTS   Directory for system wide scripts.
461         $BLENDER_USER_DATAFILES    Directory  for  user  data  files  (icons,
462       translations, ..).
463         $BLENDER_SYSTEM_DATAFILES Directory for system wide data files.
464         $BLENDER_SYSTEM_PYTHON    Directory for system Python libraries.
465         $TMP or $TMPDIR           Store temporary files here.
466         $SDL_AUDIODRIVER          LibSDL audio driver - alsa, esd, dma.
467         $PYTHONHOME                 Path   to   the   Python  directory,  eg.
468       /usr/lib/python.
469
470

SEE ALSO

472       luxrender(1)
473
474

AUTHORS

476       This manpage was written for a Debian GNU/Linux system by Daniel Mester
477       <mester@uni-bremen.de>  and  updated  by  Cyril Brulebois <cyril.brule‐
478       bois@enst-bretagne.fr> and Dan Eicher <dan@trollwerks.org>.
479
480
481
482Blender management: using fallbacAkprmiolde11f,or20m2a0nagement              BLENDER(1)