Skip to content

Preferences

To access BatchGenie's Preferences, click on the image/svg+xml icon in the BatchGenie panel. Alternatively, you can go to Edit > Preferences, find BatchGenie listed under the Add-ons tab, and click to access its settings for customization.

Preferences

General

Import Settings

  • Add Node Labels: Adds labels such as 'Base Color', 'Roughness', etc., to imported texture nodes. If not enabled, the file names will be used as labels.

    Label Example

    A texture node with a label compared to one without:

    Node Labels Example

  • Minimize Nodes: Minimizes texture-nodes in the node editor for a cleaner layout.

    Minimize Example

    The top texture node is minimized, while the bottom one remains expanded:

    Minimize Nodes Example

Material Name Settings
  • Folder name as the material name: If enabled, the name of the folder/subfolder will be used as the material name for textures found inside that folder. For the root folder: if only one texture set is found, the folder name will be used; if multiple texture sets are found, the folder name will not be used and the names will be derived from the texture filenames.
    If this option is disabled, the material name will be derived from the texture filenames
  • Split CamelCase names: Splits names such as 'MetalBronzeWorn' into 'Metal Bronze Worn'.
  • Add resolution Suffix: Automatically appends the texture resolution to the material name, e.g., 'Oak Bark 4K', derived from the Base Color image. Skips adding the suffix if the material name already includes terms like 2K or 4K.
  • Add resolution Suffix as Asset tag: Similar to the above, but instead of modifying the material name, it applies the resolution as a tag to the Asset. This works only if 'Mark as Asset' is enabled.
  • Remove Underscore & Dashes: Replaces _ and - in the material names with a space.

  • Remove Keywords: These keywords will be removed from the names of the imported materials. Enter one or more keywords separated by spaces. The process is case insensitive. There are two replacement modes with different behaviors:

    • Loose Mode: Uses regular expressions to match and remove keywords as standalone words. This mode removes keywords that appear as isolated words, considering word boundaries.

    • Strict Mode: Performs direct name replacement for each keyword. This mode removes the exact keyword from the name but does not alter any surrounding characters or delimiters.

      Examples

      Keyword png:

      • Loose:

        • For the name Bark 4 png, the function will remove 'png', resulting in Bark 4.
        • For the name Bark_4_png, no change will occur, as 'png' is part of a compound name with underscores, resulting in Bark_4_png.

      • Strict:

        • For the name Bark 4 png, the function will remove 'png', resulting in Bark 4.
        • For the name Bark_4_png, the function will remove "png", resulting in Bark_4_. The underscores before 'png' will remain.

  • Subfolder Traversing Depth: Specify how many levels deep to search for subfolders when importing textures. The default depth is set to 1, meaning only one level deep will be searched within the selected folder. Adjust this setting to control the folder depth for more complex directory structures.

    Example diagram of traversing
    graph TD A[Main Folder] A --> B[Subfolder Level 1] B --> C[Subfolder Level 2] C --> D[Subfolder Level 3] B --> E[Another Subfolder Level 2] E --> F[Subfolder Level 3] A --> G[Another Subfolder Level 1]

  • Texture Detection: Edit the tags used for detecting different texture types during import. These tags, which are case-insensitive and separated by spaces, help BatchGenie automatically recognize and categorize textures.

    Texture Tags

    Texture Tags

Misc Settings

  • Add-on Location: Choose whether the add-on appears in its own "BatchGenie" tab in the N-Panel or within the existing Tool Panel. This option can help save tab space if the N-Panel is too crowded and also applies to the BatchGenie tab in the Shader Editor.

Advanced

Import Settings

  • DirectX Detection: Specify keywords to automatically detect DirectX normal maps. If a DirectX normal map is found, a converter node is added to transform it to OpenGL format, which Blender uses. Enter one or more case-insensitive keywords separated by spaces.

    Normal Map Conversion Example

    DirectX Conversion Example

  • Asset Preview Generation during Import: Controls whether Asset Previews are automatically generated during the import process. Options include:

    • Disabled (Recommended): Asset previews are not generated automatically. Use the Render Asset Previews function after import to create previews.
    • Enabled - Low Quality: Uses Blender's default Asset generation function for fast, but lower-quality previews.
    • Enabled - High Quality: Uses the add-on to create high-quality previews during import. See the Render Asset Previews tab in the add-on panel for settings.

    Note on automatic generation

    Enabling this feature may significantly increase processing time and affect stability, especially with a large number of textures. It is recommended to keep this setting disabled.

Render Asset Preview Settings

  • Denoise: These settings reflect Blender's default options for denoising, including the choice of denoiser method and adjustments for Passes, Prefilter, and Quality. The selected denoiser method determines how images are denoised during Asset Preview rendering with BatchGenie. Enable this feature via the main BatchGenie panel under Render Settings to apply the chosen denoising method.

    Which Denoiser should I choose?

    While OptiX excels in performance on Nvidia GPUs, OpenImageDenoise stands out for its adaptability across various hardware setups and is often favored for delivering better results. For further details see this section in the Blender manual.

Misc Settings

  • External Asset Processing Max Threads: Controls the number of parallel processes used when handling external Assets via the Asset Browser utilities. Specifically, it determines how many Blender processes run in the background when adding tags or metadata to Assets located outside the current blend file. Adjust this setting based on your system's capabilities to achieve optimal performance when processing external Assets.
    Note that 'Max Threads' does not apply to rendering Assets. The rendering process itself is the primary bottleneck, rather than the integration of rendered images with Assets.

  • Debug To Console: Outputs debug information to the console, useful for troubleshooting. To view the console, go to Window > Toggle System Console.