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

For system installations both SYSTEM and USER directories are needed.

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

Here are the default locations for each system:

Linux

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

Белешка

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

Белешка

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

$XDG_CONFIG_HOME/blender/3.3/

macOS

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

Белешка

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

./Blender.app/Contents/Resources/3.3/

Windows

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

Raspored putanja

This is the path layout which is used within the directories described above.

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

Search order: LOCAL, USER.

./config/ ...

Defaults & session info.

Search order: LOCAL, USER.

./config/startup.blend

Default file to load on startup.

./config/userpref.blend

Default preferences to load on startup.

./config/bookmarks.txt

Prečice za izbornik fajlova.

./config/recent-files.txt

Lista nedavno učitanih projekata u meniju.

./datafiles/ ...

Runtime files.

Search order: LOCAL, USER, SYSTEM.

./datafiles/locale/{language}/

Static precompiled language files for UI translation.

./scripts/ ...

Python scripts for the user interface and tools.

Search order: 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

Another add-ons directory which is used for community maintained add-ons (must be manually created).

./scripts/addons_contrib/modules/*.py

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

./scripts/modules/*.py

Pajton moduli sa osnovnim funkcijama i definicijama za kreiranje sopstvenih skripti (ide u sys.path).

./scripts/startup/*.py

Skripte koje su uvek dostupne pri pokretanju programa.

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

Snimljene kombinacije parametara u panelima (npr. tkanina, format vizuelizacije, itd.)

./scripts/templates_py/*.py

Šablonske skripte koje se mogu otvoriti kroz Text Editor ‣ Templates ‣ Python.

./scripts/templates_osl/*.osl

Šabloni za OSL šejdere koji se mogu otvoriti kroz Text Editor ‣ Templates ‣ Open Shading Language.

./python/ ...

Integrisana distribucija Pajton jezika.

Search order: LOCAL, SYSTEM.

Local Cache Directory

The cache directory is used to store persistent chaches 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/Chaches/Blender/

  • Windows

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

Folder za privremene datoteke

Folder za privremene datoteke skladišti razne datoteke prilikom rada (npr. slojevi vizuelizacije, keš simulacije fizike, među-memorija za „copy/paste” i zapisnik o rušenju programa).

Folder za privremene fajlove se razrešava po sledećem prioritetu:

  • Korisnički izbor (vidi File Paths).

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

  • /tmp/ folder.