1BLENDER(1)                  General Commands Manual                 BLENDER(1)
2
3
4
5Color management: Error could not find role data role.  Blender 2.81 (sub 16)"
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.81  (sub  16)  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       --addons <addon(s)>
203              Comma separated list of add-ons (no spaces).
204
205
206   Logging Options:
207       --log <match>
208              Enable logging categories, taking a single comma separated argu‐
209              ment.
210              Multiple categories can be matched using a '.*' suffix,
211              so '--log "wm.*"' logs every kind of window-manager message.
212              Use "^" prefix to ignore, so '--log "*,^wm.operator.*"' logs all
213              except for 'wm.operators.*'
214              Use "*" to log everything.
215
216
217       --log-level <level>
218              Set  the  logging  verbosity  level  (higher  for  more details)
219              defaults to 1,
220              use -1 to log all levels.
221
222
223       --log-show-basename
224              Only show file name in output (not the leading path).
225
226
227       --log-show-backtrace
228              Show a back trace for each log message (debug builds only).
229
230
231       --log-show-timestamp
232              Show a timestamp for each log message in seconds since start.
233
234
235       --log-file <filename>
236              Set a file to output the log to.
237
238
239   Debug Options:
240       -d or --debug
241              Turn debugging on.
242
243
244              * Enables memory error detection
245              * Disables mouse grab (to  interact  with  a  debugger  in  some
246              cases)
247              * Keeps Python's 'sys.stdin' rather than setting it to None
248
249
250       --debug-value <value>
251              Set debug value of <value> on startup.
252
253
254       --debug-events
255              Enable debug messages for the event system.
256
257
258       --debug-handlers
259              Enable debug messages for event handling.
260
261
262       --debug-libmv
263              Enable debug messages from libmv library.
264
265
266       --debug-cycles
267              Enable debug messages from Cycles.
268
269
270       --debug-memory
271              Enable fully guarded memory allocation and debugging.
272
273
274       --debug-jobs
275              Enable time profiling for background jobs.
276
277
278       --debug-python
279              Enable debug messages for Python.
280
281
282       --debug-depsgraph
283              Enable all debug messages from dependency graph.
284
285
286       --debug-depsgraph-eval
287              Enable  debug  messages from dependency graph related on evalua‐
288              tion.
289
290
291       --debug-depsgraph-build
292              Enable debug messages from dependency  graph  related  on  graph
293              construction.
294
295
296       --debug-depsgraph-tag
297              Enable debug messages from dependency graph related on tagging.
298
299
300       --debug-depsgraph-no-threads
301              Switch dependency graph to a single threaded evaluation.
302
303
304       --debug-depsgraph-time
305              Enable debug messages from dependency graph related on timing.
306
307
308       --debug-depsgraph-pretty
309              Enable colors for dependency graph debug messages.
310
311
312       --debug-gpu
313              Enable gpu debug context and information for OpenGL 4.3+.
314
315
316       --debug-gpumem
317              Enable GPU memory stats in status bar.
318
319
320       --debug-gpu-shaders
321              Enable GPU memory stats in status bar.
322
323
324       --debug-gpu-force-workarounds
325              Enable GPU memory stats in status bar.
326
327
328       --debug-wm
329              Enable  debug  messages for the window manager, shows all opera‐
330              tors in search, shows keymap errors.
331
332
333       --debug-all
334              Enable all debug messages.
335
336
337       --debug-io
338              Enable debug messages for I/O (collada, ...).
339
340
341       --debug-fpe
342              Enable floating point exceptions.
343
344
345       --disable-crash-handler
346              Disable the crash handler.
347
348
349       --disable-abort-handler
350              Disable the abort handler.
351
352
353   Misc Options:
354       --app-template <template>
355              Set the application template (matching the directory name),  use
356              'default' for none.
357
358
359       --factory-startup
360              Skip  reading  the BLENDER_STARTUP_FILE in the users home direc‐
361              tory.
362
363
364       --enable-event-simulate
365              Enable  event   simulation   testing   feature   'bpy.types.Win‐
366              dow.event_simulate'.
367
368
369       --env-system-datafiles
370              Set the BLENDER_SYSTEM_DATAFILES environment variable.
371
372
373       --env-system-scripts
374              Set the BLENDER_SYSTEM_SCRIPTS environment variable.
375
376
377       --env-system-python
378              Set the BLENDER_SYSTEM_PYTHON environment variable.
379
380
381       -noaudio
382              Force sound system to None.
383
384
385       -setaudio
386              Force sound system to a specific device.
387
388
389       -h or --help
390              Print this help text and exit.
391
392
393       -R
394              Register blend-file extension, then exit (Windows only).
395
396
397       -r
398              Silently  register  blend-file  extension,  then  exit  (Windows
399              only).
400
401
402       -v or --version
403              Print Blender version and exit.
404
405
406       --
407              End option processing,  following  arguments  passed  unchanged.
408              Access via Python's 'sys.argv'.
409
410
411   Other Options:
412       /?
413              Print this help text and exit (windows only).
414
415
416       --debug-freestyle
417              Enable debug messages for Freestyle.
418
419
420       --verbose <verbose>
421              Set  logging  verbosity  level for debug messages which supports
422              it.
423
424
425       --disable-library-override
426              Enable Library Override features in the UI.
427
428
429   Argument Parsing:
430        Arguments must be separated by white space, eg:
431         # blender -ba test.blend
432         ...will exit since '-ba' is an unknown argument.
433
434   Argument Order:
435        Arguments are executed in the order they are given. eg:
436         # blender --background test.blend  --render-frame  1  --render-output
437       '/tmp'
438         ...will  not  render  to  '/tmp'  because  '--render-frame 1' renders
439       before the output path is set.
440         # blender --background --render-output /tmp test.blend --render-frame
441       1
442         ...will  not  render  to  '/tmp' because loading the blend-file over‐
443       writes the render output that was set.
444         # blender --background test.blend --render-output /tmp --render-frame
445       1
446         ...works as expected.
447

ENVIRONMENT VARIABLES

449         $BLENDER_USER_CONFIG      Directory for user configuration files.
450         $BLENDER_USER_SCRIPTS     Directory for user scripts.
451         $BLENDER_SYSTEM_SCRIPTS   Directory for system wide scripts.
452         $BLENDER_USER_DATAFILES    Directory  for  user  data  files  (icons,
453       translations, ..).
454         $BLENDER_SYSTEM_DATAFILES Directory for system wide data files.
455         $BLENDER_SYSTEM_PYTHON    Directory for system Python libraries.
456         $TMP or $TMPDIR           Store temporary files here.
457         $SDL_AUDIODRIVER          LibSDL audio driver - alsa, esd, dma.
458         $PYTHONHOME                Path  to   the   Python   directory,   eg.
459       /usr/lib/python.
460
461

SEE ALSO

463       luxrender(1)
464
465

AUTHORS

467       This manpage was written for a Debian GNU/Linux system by Daniel Mester
468       <mester@uni-bremen.de> and updated  by  Cyril  Brulebois  <cyril.brule‐
469       bois@enst-bretagne.fr> and Dan Eicher <dan@trollwerks.org>.
470
471
472
473Blender management: using fallbaDcekcemmobdeer f1o4r, m2a0n1a9gement              BLENDER(1)