Estructura de directorios de Blender#
Esta página documenta los diferentes directorios utilizados por Blender.
Esto podrá ser de utilidad para la resolución de problemas, así como la automatización y personalización del programa.
Directorios del usuario#
User directories store preferences, startup file, installed extensions, presets and more. By default these use the standard configuration folders for each operating system.
Linux#
$HOME/.config/blender/4.2/
If the $XDG_CONFIG_HOME
environment variable is set:
$XDG_CONFIG_HOME/blender/4.2/
macOS#
/Users/$USER/Library/Application Support/Blender/4.2/
Windows#
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.2\
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.
Directorios 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:
./4.2/
Linux distribution packages:
/usr/share/blender/4.2/
macOS#
./Blender.app/Contents/Resources/4.2/
Windows#
Archivo zip descargado desde blender.org:
./4.2/
Instalador descargado desde blender.org:
%ProgramFiles%\Blender Foundation\Blender\4.2\
Microsoft Store installation:
%ProgramFiles%\WindowsApps\BlenderFoundation.Blender<HASH>\Blender\4.2\
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 autoguardado (sólo para Windows, en otros sistemas se utiliza el directorio temporal).
Located in user directories.
./config
User configuration and session info.
Located in user directories.
./config/startup.blend
Blend file to load on startup.
./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_DE_PLANTILLA}/startup.blend
Archivo de inicio para una plantilla de aplicación.
./config/{ID_DE_PLANTILLA}/userpref.blend
User preferences file for an application template.
./datafiles
Data files loaded at runtime.
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
Studio light images for 3D viewport.
./extensions
Extension repositories.
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
The add-ons directory which is used for bundled add-ons.
./scripts/addons_core/modules/*.py
Modules for
addons_core
to use (added to Python’ssys.path
when it found)../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/{APP_TEMPLATE_ID}
Application templates installed in user directories.
./scripts/startup/bl_app_templates_system/{APP_TEMPLATE_ID}
pplication templates automatically loaded from system directories.
./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
../scripts/templates_osl/*.osl
Shaders OSL de ejemplo, accesibles desde
.
./python
Distribución Python incorporada.
Located in system directories.
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
yTMP_DIR
en otras plataformas).El directorio
/tmp/
.