**Bella CLI** Version 20.15 [Bella for Rhino](../bella_rhino/index.html) | [Bella for Maya](../bella_maya/index.html) | [Bella for SketchUp](../bella_sketchup/index.html) | [Bella GUI](../bella_gui/index.html) | [Bella CLI](../bella_cli/index.html) | [Bella Core](../bella/index.html) | [Tutorials](../../tutorials) | [Node Definitions](../nodes/index.html) | [Main site](https://bellarender.com) | [Forums](https://bellarender.com/forums) Overview =================================================================================================== Bella CLI is a command-line application for automating the rendering of Bella scenes, and may therefore be used to create a render farm. ![](cli.png) ## Scope This document intends to explain specifically about the Bella CLI, not about general Bella concepts, for which you should refer to the [core Bella](../bella/index.html) and [node definition](../nodes/index.html) documentation. Installation =================================================================================================== To install Bella CLI, download the package appropriate for you operating system (.zip for Windows, .dmg for MacOS, .tar.gz for linux) and follow these steps: ## Windows - Unzip the downloaded .zip file on your desktop. - Double-click on the installer .exe file and follow the directions. ## MacOS - Double-click the downloaded .dmg to mount it. - Drag bella_cli to the Applications folder. ## linux - Unzip the downloaded .tar.gz file. - bella_cli is ready to run. Arguments =================================================================================================== Following is a listing of currently-supported Bella CLI arguments. You can always print this in the console by using `bella_cli --help`. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SHELL Bella CLI 20.15.0.0, Copyright (c) 2020, Diffuse Logic USAGE bella_cli [-i:path] [-o:path] [-v|-h|-i|-o|-mi|-li|-tp|-vo|-hg|-od|-on|-fbd|-fbn|-t| -s|-tt|-tl|-sa|-sb|-si|-res|-rtt|-tta|-tts|-m|-fo|-fm] OPTIONS version -v [ --version ] /v [ /version ] NOTES: Print application version to the console. help -h [ --help ] /h [ /help ] /? NOTES: Print this help text. input -i: [ --input: ] /i: [ /input: ] NOTES: Input file path. output -o: [ --output: ] /o: [ /output: ] NOTES: Output file path. machineInfo -mi [ --machineinfo ] /mi [ /machineinfo ] NOTES: Print machine/os info and exit. licenseInfo -li [ --licenseinfo ] /li [ /licenseinfo ] NOTES: Print license info and exit. thirdParty -tp [ --thirdparty ] /tp [ /thirdparty ] NOTES: Print third-party licenses used by Bella and exit. verboseOutput -vo [ --verboseoutput ] /vo [ /verboseoutput ] NOTES: Enable verbose output. helpGen -hg [ --helpgen ] /hg [ /helpgen ] NOTES: Generate html help from a .bnd file. If no input path is given, help will be generated for the built-in Bella node definitions. If no output path is given, the path of the input .bnd will be used (renamed to .html). If neither input nor output paths are given, the command will fail. outputDir -od [ --outputdir ] /od [ /outputdir ] NOTES: Override settings:outputDir in the rendered scene. outputName -on [ --outputname ] /on [ /outputname ] NOTES: Override settings:outputName in the rendered scene. finalBsiDir -fbd [ --finalbsidir ] /fbd [ /finalbsidir ] NOTES: A directory where local BSI files (saved as according to beautyPass:saveBsi) will be copied at end of rendering. finalBsiName -fbn [ --finalbsiname ] /fbn [ /finalbsiname ] NOTES: A custom name to use when copying BSI files to --finalBsiDir. Specify with or without the extension. threads -t:<0> [ --threads:<0> ] /t:<0> [ /threads:<0> ] NOTES: Override settings:threads from the bsx. Accepts values in [-2, 512]. solver -s: [ --solver: ] /s: [ /solver: ] NOTES: Overrides beautyPass:solver in the BSX. Accepts values in [atlas, ares, apollo]. targetTime -tt:<240> [ --targettime:<240> ] /tt:<240> [ /targettime:<240> ] NOTES: Overrides beautyPass:targetTime in the BSX. Accepts values in [0.1, 1.0e11]. targetLevel -tl:<100> [ --targetlevel:<100> ] /tl:<100> [ /targetlevel:<100> ] NOTES: Overrides beautyPass:targetLevel in the BSX. Accepts values in [1, 100]. stopAt -sa: [ --stopat: ] /sa: [ /stopat: ] NOTES: Overrides beautyPass:stopAt in the BSX. Accepts values in [time, level, first]. saveBsi -sb:<0> [ --savebsi:<0> ] /sb:<0> [ /savebsi:<0> ] NOTES: Overrides beautyPass:saveBsi in the BSX. Accepts values in [-1, 20]. saveImage -si:<0> [ --saveimage:<0> ] /si:<0> [ /saveimage:<0> ] NOTES: Overrides beautyPass:saveImage in the BSX. Accepts values in [-1, 20]. resolution -res [ --resolution ] /res [ /resolution ] NOTES: Overrides camera::resolution in the BSX. Accepts values formatted as WxH. renderTurnTable -rtt [ --renderturntable ] /rtt [ /renderturntable ] NOTES: Tells the CLI to render a turntable animation of the input file. The animation will be 360 degrees, by 1 degree steps, unless the --turnTableAngle and/or --turnTableStep args are given. Turntable animations ignore customized output and BSI naming args. Also, at this time, BSI-generation is disabled for animations. turnTableAngle -tta:<360> [ --turntableangle:<360> ] /tta:<360> [ /turntableangle:<360> ] NOTES: Sets the total angle covered by a turntable animation. turnTableStep -tts:<1> [ --turntablestep:<1> ] /tts:<1> [ /turntablestep:<1> ] NOTES: Sets the angle between frames for a turntable animation. merge -m [ --merge ] /m [ /merge ] NOTES: Merge a list of BSI files. -o: must specify the output BSI. forceOverwrite -fo [ --forceoverwrite ] /fo [ /forceoverwrite ] NOTES: Force overwrite of existing files. forceMerge -fm [ --forcemerge ] /fm [ /forcemerge ] NOTES: Force merging of BSI files with mismatched scene hashes. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~