Estructura de carpetas de Blender

Esta página documenta las diferentes carpetas utilizadas por Blender.

Esto podrá ser de utilidad para la resolución de problemas, así como la automatización y personalización del programa.

Carpetas del usuario

Las carpetas del usuario almacenarán las preferencias, archivo de inicio, extensiones instaladas, preajustes y otros. De forma predefinida, éstos usarán la configuración de carpetas estándar para cada sistema operativo.

Linux

$HOME/.config/blender/5.3/

En caso de que la variable de entorno $XDG_CONFIG_HOME se encontrara definida:

$XDG_CONFIG_HOME/blender/5.3/

macOS

/Users/$USER/Library/Application Support/Blender/5.3/

Windows

%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\5.3\

Instalación portable

When running Blender from a portable drive, it’s possible to keep the configuration files on the same drive to take with you.

To enable this, create a folder named portable at the following locations:

  • Windows: Next to the Blender executable, in the unzipped folder

  • Linux: Next to the Blender executable, in the unzipped folder

  • macOS: Inside the application bundle at Blender.app/Contents/Resources

This folder will then store preferences, startup file, installed extensions and presets.

Variables de entorno

The BLENDER_USER_RESOURCES environment variable can be set to a custom directory to replace the default user directory.

Carpetas del sistema

System directories store files that come bundled with Blender and are required for it to function. This includes scripts, presets, essential assets and more.

Linux

Archivo descargado desde blender.org:

./5.3/

Paquetes de distribución de Linux:

/usr/share/blender/5.3/

macOS

./Blender.app/Contents/Resources/5.3/

Windows

Archivo zip descargado desde blender.org:

./5.3/

Instalador descargado desde blender.org:

%ProgramFiles%\Blender Foundation\Blender\5.3\

Instalación desde la Microsoft Store:

%ProgramFiles%\WindowsApps\BlenderFoundation.Blender<HASH>\Blender\5.3\

Variables de entorno

BLENDER_SYSTEM_SCRIPTS and BLENDER_SYSTEM_EXTENSIONS environment variables can be used to bundle additional scripts and extensions, that are not part of the regular Blender installation.

Other BLENDER_SYSTEM environment variables can override other system paths, though are not commonly used in practice.

Estructura de rutas

./autosave

Ubicación del archivo .blend de guardado automático (sólo para Windows, en otros sistemas se utilizará la carpeta temporal).

Ubicado en carpetas del usuario.

./config

Configuración del usuario e información de la sesión.

Ubicado en carpetas del usuario.

./config/startup.blend

Archivo .blend a cargar en el arranque.

./config/userpref.blend

Preferencias de usuario.

./config/bookmarks.txt

Marcadores del Explorador de archivos.

./config/recent-files.txt

Lista del menú de archivos recientes.

./config/{ID_PLANTILLA_APLICACIÓN}/startup.blend

Archivo de inicio para una plantilla de aplicación.

./config/{ID_PLANTILLA_APLICACIÓN}/userpref.blend

Archivo de preferencias de usuario para una plantilla de aplicación.

./datafiles

Archivos de datos cargados durante la ejecución.

Located in both user and system directories. User data files either override or add to system data files.

./datafiles/colormanagement

Configuración predefinida de OpenColorIO.

./datafiles/fonts

Tipografías de la interfaz.

./datafiles/studiolights

Imágenes de iluminación de estudio para la Vista 3D.

./extensions

Repositorios de extensiones.

Located in both user and system directories. Repositories are loaded from both directories.

./scripts

Add-ons, presets, templates, user interface, startup scripts.

Located in both user and system directories. Scripts are loaded from both directories.

./scripts/addons/*.py

Los complementos Python que podrán ser habilitados en las Preferencias, incluyen soporte para la importación/exportación de formatos, integración de motores de procesamiento y muchas utilidades prácticas.

./scripts/addons/modules/*.py

Módulos para ser utilizados por los complementos (agregados al sys.path de Python).

./scripts/addons_core/*.py

La carpeta de complementos, utilizada para los complementos incorporados.

./scripts/addons_core/modules/*.py

Módulos utilizados por los addons_core (agregados al sys.path de Python cuando sea encontrado).

./scripts/modules/*.py

Módulos de Python que contienen el núcleo de nuestra API y funciones de utilidades para que puedan importar otros scripts (agregados al sys.path de Python).

./scripts/startup/*.py

Scripts que son automáticamente importados en el arranque.

./scripts/startup/bl_app_templates_user/{ID_PLANTILLA_APLICACIÓN}

Application templates installed in user directories.

./scripts/startup/bl_app_templates_system/{ID_PLANTILLA_APLICACIÓN}

Application templates automatically loaded from system directories.

./scripts/presets/{preajuste}/*.py

Preajustes usados para almacenar opciones definidas por el usuario para telas, formatos de procesamiento, etc.

./scripts/templates/*.py

Scripts de ejemplo, accesibles desde Text Editor ‣ Templates ‣ Python.

./scripts/templates_osl/*.osl

Shaders OSL de ejemplo, accesibles desde Text Editor ‣ Templates ‣ Open Shading Language.

./python

Distribución Python incorporada.

Located in system directories.

Carpeta local de cachés

The cache directory is used to store persistent caches locally. Currently it is only used for the indexing of Asset Libraries. The operating system is not expected to clear this automatically.

La siguiente ruta será usada:

  • Linux:

    $XDG_CACHE_HOME/blender/ si $XDG_CACHE_HOME se encontrara definida, en caso contrario será $HOME/.cache/blender/

  • macOS:

    /Library/Caches/Blender/

  • Windows:

    %USERPROFILE%\AppData\Local\Blender Foundation\Blender\Cache\

Carpeta temporal

La carpeta temporal se usará para almacenar varios archivos durante la ejecución (incluyendo capas de procesamiento, caché de dinámicas, buffer de copiar/pegar y registros de errores).

La carpeta temporal se selecciona basada en la siguiente prioridad:

  • Preferencias de Usuario (véase Rutas de archivos).

  • Variables de entorno (TEMP en Windows, TMP y TMP_DIR en otras plataformas).

  • La carpeta /tmp/.