The Open Brush config file
The Open Brush config file can be used to tweak various options for advanced users. A blank Open Brush.cfg file will be created in the Open Brush folder on application startup if one does not exist.
Example PC path: C:\Users\<username>\Documents\Open Brush\Open Brush.cfg.
On an Oculus Quest, you can find this file in /sdcard/Open Brush. You can use either adb or the SideQuest file viewer to access this file. You could also sideload a text editor if you want to edit the file directly.
Example of an empty Open Brush.cfg:
{
"User":{
},
"Brushes":{
},
"Video":{
},
"Flags":{
},
"Export":{
},
"Sharing":{}
}Sample contents of a Open Brush.cfg with various fields filled in:
Valid Config file Settings
"User" Section
Author: The name you use here will be stored in files uploaded to Icosa, Sketchfab etc.
"Brushes" Section
AddTagsToBrushes: See Brush Tags
RemoveTagsFromBrushes: See Brush Tags
IncludeTags: See Brush Tags
ExcludeTags: See Brush Tags
"Video" Section
Encoder: (h.264) This setting specifies the video codec used for encoding exported videos. Currently, the only supported codec is h.264.
OfflineResolution: Controls offline rendering resolution. ODS panorama widths from 640 to 8000 pixels are supported. See Video settings.
"Flags" Section
PostEffectsOnCapture: (true | false) This setting determines whether post-processing effects will be applied to captured images or videos. When set to true, effects will be applied; when set to false, they will not.
ShowWatermark: (true | false) This setting controls the visibility of the Open Brush watermark on exported images and videos. When set to true, the watermark will be visible; when set to false, it will be hidden.
ShowHeadset: (true | false) This setting determines whether the user's VR headset will be visible in the final exported images or videos. When set to true, the headset will be shown; when set to false, it will not.
UnlockScale: (true | false) This setting allows users to scale their artwork beyond the default limits. When set to true, users can scale their artwork to larger sizes; when set to false, scaling will be limited to the default range.
SnapshotWidth: (1 - some reasonably large number) This setting controls the width (in pixels) of exported images. Users can specify a value between 1 and a reasonably large number to set the desired image width.
SnapshotHeight: (1 - some reasonably large number) This setting controls the height (in pixels) of exported images. Users can specify a value between 1 and a reasonably large number to set the desired image height.
FOV: (1 - 179) This setting determines the field of view (FOV) for the camera used during image or video capture. Users can specify a value between 1 and 179 degrees to set the desired FOV.
DisableAudio: (true | false) This setting allows users to disable audio playback within Open Brush. When set to true, audio playback will be disabled; when set to false, audio playback will function as normal.
AdvancedKeyboardShortcuts: (true | false) Enables some extra keyboard shortcuts that were previously available in Experimental Mode
SkipIntro: (true | false) Skips the intro scene that appears when Open Brush finishes loading
EnableMonoscopicMode: (true | false) Enables the non-VR painting and debugging interface. See Monoscopic Mode.
DisableXrMode: (true | false) Starts Open Brush without XR. See View-only Mode and Monoscopic Mode.
ForceViewOnly: (true | false) Hides painting and editing tools and enables the restricted viewer interface. It works with or without XR. See View-only Mode.
LargeMeshSupport: (true | false) Allows Open Brush's internal and exported meshes to use 32-bit indices instead of the default smaller batches. This can avoid splitting very large meshes at the cost of higher memory use and reduced compatibility with software that only supports 16-bit mesh indices. It defaults to false.
"Import" Section
"Sharing" Section
IcosaApiRoot: The root URL of the Icosa-compatible API. The default is
https://api.icosa.gallery/v1.IcosaHomePage: The matching gallery website used for links opened by Open Brush. The default is
https://icosa.gallery.
Most users should leave these settings out of the config file and use the defaults. Set both values only when connecting Open Brush to another compatible Icosa Gallery instance.
"Export" Section
ExportBinaryFbx: (true | false) This setting controls whether exported FBX files will be in binary format. When set to true, binary FBX files will be exported; when set to false, ASCII FBX files will be exported.
ExportFbxVersion: (FBX201600 | FBX201400 | FBX201300 | FBX2012 | FBX201100) This setting specifies the version of the FBX file format to be used when exporting 3D models. Users can choose from FBX201600, FBX201400, FBX201300, FBX2012, or FBX201100. If not specified in the config file, the default version is FBX201400. If users experience issues importing the FBX file into older software, they may need to select an older version.
ExportStrokeTimestamp: (true | false) This will put timing information into texcoord2 for all GLB exports. Timestamps are a vec3: x,y = the earliest/latest timestamp in the stroke which contains that vertex. z = the timestamp for that vertex. This setting defaults to true but can be disabled to reduce file size.
Setting config values from the command line
Any of the above settings in the Open Brush.cfg file can also be specified on the command line (not applicable to Quest users). The format is --Section.Setting <value>. For example:
Last updated