Blender’s Directory Layout – Розстава Каталогів Blender’а

This page documents the different directories used by Blender.

This can be helpful for troubleshooting, automation and customization.

User Directories

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.4/

If the $XDG_CONFIG_HOME environment variable is set:

$XDG_CONFIG_HOME/blender/4.4/

macOS

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

Windows

%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.4\

Portable Installation

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.

Environment Variables – Змінні Середовища

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

System Directories

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

Archive downloaded from blender.org:

./4.4/

Linux distribution packages:

/usr/share/blender/4.4/

macOS

./Blender.app/Contents/Resources/4.4/

Windows

Zip file downloaded from blender.org:

./4.4/

Installer downloaded from blender.org:

%ProgramFiles%\Blender Foundation\Blender\4.4\

Microsoft Store installation:

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

Environment Variables – Змінні Середовища

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.

Path Layout – Розстава Шляхів

./autosave

Розміщення автозбережених blend-файлів. (лише Windows, каталог «temp» використовується для інших систем.)

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

User preferences.

./config/bookmarks.txt

Закладки Оглядача Файлів – File Browser.

./config/recent-files.txt

Список для меню недавніх файлів.

./config/{APP_TEMPLATE_ID}/startup.blend

Startup file for an application template.

./config/{APP_TEMPLATE_ID}/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

Default OpenColorIO configuration.

./datafiles/fonts

User interface fonts.

./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

Додатки на Python, які можуть вмикатися в уподобаннях Preferences, включаючи підтримку імпорту/експорту форматів, інтеграцію рушіїв рендера та багато зручних утиліт.

./scripts/addons/modules/*.py

Модулі для використовуваних додатків (додається у системний шлях sys.path для 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’s sys.path when it found).

./scripts/modules/*.py

Модулі для Python, що містять наше ядро API та функції утиліт для інших скриптів для імпорту (додається у системний шлях sys.path для Python).

./scripts/startup/*.py

Скрипти, які автоматично імпортуються при запуску.

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

Передустави, що використовуються для зберігання визначених користувачем устав для тканин, форматів рендера тощо.

./scripts/templates_py/*.py

Приклади скриптів, які доступні через «Редактор Тексту > Шаблони > Python» – Text Editor ‣ Templates ‣ Python.

./scripts/templates_osl/*.osl

Приклади шейдерів на мові OSL, які доступні через «Редактор Тексту > Шаблони > Відкрита Мова Відтінення» – Text Editor ‣ Templates ‣ Open Shading Language.

./python

Дистрибутив Python у комплекті з Blender’ом.

Located in system directories.

Local Cache Directory

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.

The following path will be used:

  • Linux:

    $XDG_CACHE_HOME/blender/ if $XDG_CACHE_HOME is set, otherwise $HOME/.cache/blender/

  • macOS:

    /Library/Caches/Blender/

  • Windows:

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

Temporary Directory – Тимчасова Директорія

Тимчасова директорія використовується для зберігання різних файлів під час прогону (включаючи шари рендера, кеш фізики, буфер копіювання-вставляння та логи крахів).

Тимчасова директорія вибирається, базуючись на наступному пріоритеті:

  • User Preference – Уподобання Користувача (дивіться File Paths – Шляхи Файлів).

  • Environment variables – Змінні середовища (TEMP на Windows, TMP і TMP_DIR на інших платформах).

  • Директорія /tmp/.