Blender’s Directory Layout

Esta página documenta os diferentes diretórios utilizados pelo Blender (que podem ser úteis para a solução de problemas).

Existem três diretórios diferentes que o Blender poderá utilizar, as suas localizações exatas são dependentes do sistema operacional (ou operativo, em Portugal) utilizado.

LOCAIS (LOCAL):

A localização da configuração e dos dados em tempo de execução (para os arquivos embutidos como blocos)

USUÁRIO (USER):

Localização dos arquivos de configuração (normalmente, dentro de diretórios no ambiente de cada usuário)

SISTEMA (SYSTEM):

A localização dos dados em tempo de execução para a instalação ampla do sistema (pode ser marcado como somente leitura)

Para as instalações, tanto os diretórios SYSTEM e USER são necessários.

Para as distribuições Blender extraídas localmente, as configurações do usuário e dados em tempo de execução são mantidos dentro do mesmo subdiretório, permitindo que múltiplas versões do Blender sejam executadas sem conflitos, ignorando os arquivos das pastas definidas pelas variáveis USER e SYSTEM. Isto requer que você crie uma pasta chamada config` no diretório LOCAL*.

Caminhos dependentes de plataformas

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

Linux

LOCAIS (LOCAL):
./4.0/
USUÁRIO (USER):
$HOME/.config/blender/4.0/
SISTEMA (SYSTEM):
/usr/share/blender/4.0/

Nota

O caminho ./|BLENDER_VERSION|/ é relativo ao executável do Blender e também é utilizado para os arquivos contidos em si que são embutidos e distribuídos pelo site oficial blender.org.

Nota

O caminho USER irá utilizar o valor da variável $XDG_CONFIG_HOME caso esteja definida:

$XDG_CONFIG_HOME/blender/4.0/

macOS

LOCAIS (LOCAL):
./4.0/
USUÁRIO (USER):
/Users/$USER/Library/Application Support/Blender/4.0/
SISTEMA (SYSTEM):
/Library/Application Support/Blender/4.0/

Nota

O macOS guarda o binário do Blender em ./blender.app/Contents/MacOS/blender. O caminho local para os dados e configuração é:

./Blender.app/Contents/Resources/4.0/

Windows

LOCAIS (LOCAL):
.\4.0\
USUÁRIO (USER):
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.0\
SISTEMA (SYSTEM):
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.0\

Nota

For installations from the Window’s Store, the USER and SYSTEM directories are inside a special folder resembling: %USERPROFILE%\AppData\Local\Packages\BlenderFoundation.Blender<HASH>\LocalCache\Roaming\Blender Foundation\Blender where «HASH» is a string specific to each installation.

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

Localização do arquivo salvo automaticamente. (Somente para Windows, o diretório temporário é usado como padrão em outros sistemas).

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/{language}/

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

Add-ons Python que podem ser habilitados em Preferences, incluindo os formatos suportados para importação/exportação, integração com motores de renderização e muitas utilidades práticas.

./scripts/addons/modules/*.py

Módulos para add-ons a serem usados (adicionados ao diretório «sys.path» Python).

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

Módulos para addons_contrib` a utilizar (adicionado ao sys.path do Python).

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

Presets usadas para o armazenamento de outras configurações definidas pelos usuários para tecidos, formatos de renderização, 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.

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\

Diretório temporário

O diretório temporário é usado para armazenar vários arquivos em tempo de execução (incluindo render layers, cache físicos, copy-paste buffer e logs de erros).

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

  • Preferências de usuário (see File Paths).

  • Variáveis de ambiente (TEMP no Windows, TMP e TMP_DIR em outras plataformas).

  • O diretório definido como /tmp/.

Overriding Default Directories

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 Variáveis de ambiente for details.