Blender’s Directory Layout

This page documents the different directories used by Blender (which can be helpful for troubleshooting).

There are three different directories Blender may use, their exact locations are platform dependent.

LOCAL

Location of configuration and run-time data (for self-contained bundle).

USER

Location of configuration files (typically in the user’s home directory).

SYSTEM

Location of run-time data for system wide installation (may be read-only).

Para las instalaciones en el sistema, se necesitan los directorios tanto de SYSTEM como de USER.

For locally extracted Blender distributions, the user configuration and run-time data are kept in the same subdirectory, allowing multiple Blender versions to run without conflict, ignoring the USER and SYSTEM files. This requires you to create a folder named config in the LOCAL directory.

Platform Dependent Paths

Aquí están las ubicaciones predefinidas para cada sistema:

GNU/Linux

LOCAL
./2.83/
USER
$HOME/.config/blender/2.83/
SYSTEM
/usr/share/blender/2.83/

Nota

The path ./2.83/ is relative to the Blender executable and is used for self-contained bundles distributed by official blender.org builds.

Nota

The USER path will use $XDG_CONFIG_HOME if it is set:

$XDG_CONFIG_HOME/blender/2.83/

macOS

LOCAL
./2.83/
USER
/Users/$USER/Library/Application Support/Blender/2.83/
SYSTEM
/Library/Application Support/Blender/2.83/

Nota

macOS stores the Blender binary in ./Blender.app/Contents/MacOS/Blender. The local path to data and config is:

./Blender.app/Contents/Resources/2.83/

Windows

LOCAL
.\2.83\
USER
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\2.83\
SYSTEM
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\2.83\

Organización de Rutas

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

Where ./config/startup.blend could be ~/.blender/|BLENDER_VERSION|/config/startup.blend for example.

./autosave/ ...

Autosave blend-file location. (Windows only, temp directory used for other systems.)

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

File Browser bookmarks.

./config/recent-files.txt

Lista de recientes del menú de Archivo.

./datafiles/ ...

Archivos de ejecución.

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

./datafiles/locale/{idioma}/

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

./scripts/ ...

Scripts de Python para la interfaz de usuario y herramientas.

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

./scripts/addons/*.py

Python add-ons which may be enabled in the Preferences include import/export format support, render engine integration and many handy utilities.

./scripts/addons/modules/*.py

Modules for add-ons to use (added to Python’s sys.path).

./scripts/addons_contrib/*.py

Otro directorio de agregados los cuales se utilizan para los agregados mantenidos por la comunidad (deben ser creados manualmente).

./scripts/addons_contrib/modules/*.py

Modules for addons_contrib to use (added to Python’s sys.path).

./scripts/modules/*.py

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

./scripts/startup/*.py

Scripts que son automáticamente importados en el arranque.

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

Presets used for storing user-defined settings for cloth, render formats, etc.

./scripts/templates_py/*.py

Example scripts which can be accessed from Text Editor ‣ Templates ‣ Python.

./scripts/templates_osl/*.osl

Example OSL shaders which can be accessed from Text Editor ‣ Templates ‣ Open Shading Language.

./python/ ...

Bundled Python distribution.

Orden de búsqueda: LOCAL, SYSTEM.

Directorio Temporal

The temporary directory is used to store various files at run-time (including render layers, physics cache, copy-paste buffer and crash logs).

The temporary directory is selected based on the following priority:

  • User Preference (see File Paths).

  • Environment variables (TEMP on Windows, TMP & TMP_DIR on other platforms).

  • El directorio /tmp/.