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:

Lokacija konfiguracije in podatkov med izvajanjem programa (za self-contained bundle).

USER:

Location of configuration files (typically in the user’s home directory).

SYSTEM:

Lokacija podatkov med izvajanjem programa za sistemsko namestitev (morda je nastavljena samo za branje).

Za sistemske namestitve sta potrebna tako SYSTEM kot USER direktorija.

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.

Poti, odvisne od platforme#

Tukaj so privzete lokacije za vsak operacijski sistem:

Linux#

LOCAL:
./4.1/
USER:
$HOME/.config/blender/4.1/
SYSTEM:
/usr/share/blender/4.1/

Opomba

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

Opomba

Pot za USER bo uporabljala $XDG_CONFIG_HOME, če je nastavljena:

$XDG_CONFIG_HOME/blender/4.1/

macOS#

LOCAL:
./4.1/
USER:
/Users/$USER/Library/Application Support/Blender/4.1/
SYSTEM:
/Library/Application Support/Blender/4.1/

Opomba

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

./Blender.app/Contents/Resources/4.1/

Windows#

LOCAL:
.\4.1\
USER:
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.1\
SYSTEM:
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.1\

Opomba

For installations from the Window’s Store, the USER and SYSTEM directories are inside a special folder resembling:

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

Where „HASH“ is a string specific to each installation.

Zgradba poti#

Spodaj je razložena zgradba poti, ki je uporabljena za zgoraj opisane direktorije.

Pri tem je lahko ./config/startup.blend na primer tudi ~/.blender/|RAZLIČICA_BLENDERJA|/config/startup.blend.

./autosave/ ...

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

Iskalna ureditev: LOCAL, USER.

./config/ ...

Privzete nastavitve in informacije o seji.

Iskalna ureditev: LOCAL, USER.

./config/startup.blend

Privzeta datoteka ob zagonu.

./config/userpref.blend

Privzete nastavitve ob zagonu.

./config/bookmarks.txt

Zaznamki datotečnega brskalnika.

./config/recent-files.txt

Nedaven seznam datotečnega menija.

./datafiles/ ...

Datoteke med izvajanjem programa.

Iskalna ureditev: LOCAL, USER, SYSTEM.

./datafiles/locale/{language}/

Statične nesestavljene (ang. precompiled) jezikovne datoteke za prevajanje uporabniškega vmesnika.

./scripts/ ...

Python skripte za uporabniški vmesnik in orodja.

Iskalna ureditev: 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

Še en direktorij za dodatke, v katerem so dodatki, ki jih vzdržuje skupnost (morate ga ustvariti ročno).

./scripts/addons_contrib/modules/*.py

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

./scripts/modules/*.py

Pythonovi moduli, ki vsebujejo naše temeljne API-je in funkcije za uvažanje drugih skript (dodano k Pythonovi poti sys.path).

./scripts/startup/*.py

Skripte, ki so samodejno uvožene ob zagonu programa.

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

Prednastavitve za shranjevanje uporabnikovih nastavitev za blago, izrisovalne formate, itd.

./scripts/templates_py/*.py

Skripte s primeri, do katerih lahko dostopate prek Text Editor ‣ Templates ‣ Python.

./scripts/templates_osl/*.osl

Primeri OSL senčenj (ang. shaders), do katerih lahko dostopate prek Text Editor ‣ Templates ‣ Open Shading Language.

./python/ ...

Pripeta Pythonova distribucija.

Iskalna ureditev: 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\

Začasni direktorij#

V začasni direktorij se shranjujejo različne datoteke med delovanjem programa (vključno z izrisovalnimi plastmi, predpomnilnikom fizikalnih simulacij, copy-paste medpomnilnikom in poročili o sesutju).

Začasni direktorij je izbran glede na sledečo prioriteto:

  • Uporabniške nastavitve (berite File Paths).

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

  • Direktorij /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 Environment Variables for details.