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.

LOCAIS (LOCAL): Location of configuration and run-time data (for self-contained bundle).
USUÁRIO (USER): Location of configuration files (typically in the user’s home directory).
SISTEMA (SYSTEM): Location of run-time data for system wide installation (may be read-only).

Para as instalações, tanto os diretórios do SISTEMA quanto do Usuário são necessários.

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.

Caminhos dependentes de plataformas¶

Aqui estão as localizações padrão para cada sistema:

Linux¶

LOCAIS (LOCAL)

./2.82/

USUÁRIO (USER)

$HOME/.config/blender/2.82/

SISTEMA (SYSTEM)

/usr/share/blender/2.82/

Nota

The path ./2.82/ 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.82/

macOS¶

LOCAIS (LOCAL)

./2.82/

USUÁRIO (USER)

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

SISTEMA (SYSTEM)

/Library/Application Support/Blender/2.82/

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

Windows¶

LOCAIS (LOCAL)

.\2.82\

USUÁRIO (USER)

%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\2.82\

SISTEMA (SYSTEM)

%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\2.82\

Esquema de caminhos¶

Este é o esquema de caminhos que é utilizado em conjunto com os diretórios descritos acima.

Onde ./config/startup.blend poderá ser ~/.blender/|BLENDER_VERSION|/config/startup.blend por exemplo.

./autosave/ ...

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

Ordem de pesquisa: LOCAL, USER.

./config/ ...

Padrões e informações da sessão.

Ordem de pesquisa: LOCAL, USER.

./config/startup.blend

Arquivos padrão a ser carregados durante a inicialização.

./config/userpref.blend

As preferências padrão a ser carregadas durante a inicialização.

./config/bookmarks.txt

Favoritos do navegador de arquivos

./config/recent-files.txt

Menu com a lista de arquivos recentes.

./datafiles/ ...

Arquivos de tempo de execução.

Ordem de pesquisa: LOCAL, USER, SYSTEM.

./datafiles/locale/{linguagem}/

Arquivos estáticos pré-compilados de linguagem para a tradução da interface de usuário.

./scripts/ ...

Scripts Python para a interface de usuário e ferramentas.

Ordem de pesquisa: 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

Outros diretórios de complemento os quais são usados para os complementos mantidos pela comunidade (devem ser criados manualmente)

./scripts/addons_contrib/modules/*.py

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

./scripts/modules/*.py

Módulos Python contendo nossa API principal e funções úteis para outros scripts para serem importados (adicionados ao diretório «sys.path» Python).

./scripts/startup/*.py

Scripts que são automaticamente importados durante a inicialização.

./scripts/presets/{predefinições}/*.py

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

./scripts/templates_py/*.py

Scripts de exemplo que podem ser acessados a partir do Editor de texto ‣ Modelos ‣ Python.

./scripts/templates_osl/*.osl

Sombreadores OSL, os quais podem ser acessados a partir do Editor de texto ‣ Modelos ‣ Linguagem de sombreamento aberto.

./python/ ...

Distribuição do Python embutida

Ordem de pesquisa: LOCAL, SYSTEM.

Diretório temporário¶

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

O diretório temporário é selecionado com base na seguinte prioridade:

Preferências de usuário (see File Paths).
Environment variables (TEMP on Windows, TMP & TMP_DIR on other platforms).
O diretório definido como /tmp/.