Estructura de directorios de Blender#

Esta página documenta los diferentes directorios utilizados por Blender (que pueden ser de utilidad para la resolución de problemas).

Hay tres directorios diferentes que Blender podría utilizar, sus ubicaciones exactas son dependientes del Sistema Operativo.

LOCAL:

Ubicación de la configuración y los datos de ejecución (para un paquete autocontenido).

USUARIO:

Ubicación de los archivos de configuración (normalmente en el directorio «home» del usuario).

SISTEMA:

Ubicación de los datos de ejecución para una instalación completa en el sistema (podría ser de solo lectura).

Para instalaciones en el sistema, son necesarios los directorios SYSTEM y USER.

Para las distribuciones de Blender extraídas localmente, la configuración del usuario y los datos de ejecución se mantienen en el mismo subdirectorio, permitiendo que varias versiones de Blender se ejecuten sin que entren en conflicto, ignorando los archivos de USER y SYSTEM. Esto requiere la creación de una carpeta llamada config en el directorio LOCAL.

Rutas dependientes de cada plataforma#

Estas son las ubicaciones predefinidas para cada sistema:

Linux#

LOCAL:
./4.1/
USUARIO:
$HOME/.config/blender/4.1/
SISTEMA:
/usr/share/blender/4.1/

Nota

La ruta ./4.1/ es relativa al ejecutable de Blender y se utiliza para paquetes autocontenidos distribuidos por compilaciones oficiales de blender.org.

Nota

La ruta USER usará $XDG_CONFIG_HOME si está establecida:

$XDG_CONFIG_HOME/blender/4.1/

macOS#

LOCAL:
./4.1/
USUARIO:
/Users/$USER/Library/Application Support/Blender/4.1/
SISTEMA:
/Library/Application Support/Blender/4.1/

Nota

macOS almacena el binario de Blender en ./Blender.app/Contents/MacOS/Blender. La ruta local a los datos y configuración es:

./Blender.app/Contents/Resources/4.1/

Windows#

LOCAL:
.\4.1\
USUARIO:
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.1\
SISTEMA:
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.1\

Nota

For installations from the Window’s Store, the USER and SYSTEM directories are inside a special folder resembling:

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

Where «HASH» is a string specific to each installation.

Estructura de rutas#

Esta es la estructura de las rutas, la cual es usada dentro de los directorios descritos más arriba.

Donde ./config/startup.blend podría ser, por ejemplo ~/.blender/4.1/config/startup.blend.

./autosave/ ...

Ubicación de autoguardado para el archivo blend (solo para usuarios de Windows, en otros sistemas se utiliza el directorio temporal).

Orden de búsqueda: LOCAL, USER.

./config/ ...

Valores Predefinidos e información de sesión.

Orden de búsqueda: LOCAL, USER.

./config/startup.blend

Archivo predefinido a cargar en el arranque.

./config/userpref.blend

Preferencias predefinidas para cargar en el arranque.

./config/bookmarks.txt

Marcadores del Explorador de archivos.

./config/recent-files.txt

Lista del menú de archivos recientes.

./datafiles/ ...

Archivos de ejecución.

Orden de búsqueda: LOCAL, USER, SYSTEM.

./datafiles/locale/{idioma}/

Archivos de lenguajes precompilados estáticos para la traducción de la IU.

./scripts/ ...

Scripts de Python para la interfaz de usuario y herramientas.

Orden de búsqueda: LOCAL, USER, SYSTEM.

./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_contrib/*.py

Otro directorio de complementos utilizado para complementos mantenidos por la comunidad (debe ser creado manualmente).

./scripts/addons_contrib/modules/*.py

Módulos utilizados por los addons_contrib (agregados al sys.path de Python).

./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/presets/{predefinido}/*.py

Ajustes predefinidos 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.

Orden de búsqueda: LOCAL, SYSTEM.

Directorio 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\

Directorio temporal#

El directorio 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).

El directorio temporal se selecciona basado 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).

  • El directorio /tmp/.

Redefinición de los directorios predefinidos#

It’s possible to override the default USER and SYSTEM directories using environment variables.

While this shouldn’t be needed for typical usage, some specialized use cases may take advantage of this, such as:

  • Using a shared network drives for specific paths.

  • Isolating an instance from the default user files to prevent automated tasks from accessing user configuration.

See Variables de entorno for details.