Disposition des dossiers dans Blender

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.6/
USER:
$HOME/.config/blender/3.6/
SYSTEM:
/usr/share/blender/3.6/

Note

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

Note

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

$XDG_CONFIG_HOME/blender/3.6/

macOS

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

Note

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

./Blender.app/Contents/Resources/3.6/

Windows

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

Note

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.

Agencement des chemins d’accès

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

Emplacement du fichier blend Autosave (pour Windows seulement, les autres systèmes utilisent le dossier temp.)

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

Favoris du Navigateur de fichiers.

./config/recent-files.txt

Liste des fichiers récents du menu File.

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

Les modules complémentaires Python qui peuvent être activés dans les Preferences comprennent la prise en charge du format d’import/export, l’intégration au moteur de rendu ainsi que beaucoup d’utilitaires pratiques.

./scripts/addons/modules/*.py

Modules pour les modules complémentaires à utiliser (ajoutés au sys.path de Python).

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

Les modules Python contenant notre API principale et les fonctions utilitaires pour l’import dans d’autres scripts (ajouté au sys.path de Python).

./scripts/startup/*.py

Scripts qui sont automatiquement importés au démarrage.

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

Préréglages utilisés pour enregistrer les paramètres définis par l’utilisateur pour les tissus (cloth), les formats de rendu, etc.

./scripts/templates_py/*.py

Exemples de scripts accessibles dans Text Editor ‣ Templates ‣ Python.

./scripts/templates_osl/*.osl

Exemples de shaders OSL accessibles dans Text Editor ‣ Templates ‣ Open Shading Language.

./python/ ...

Distribution Python empaquetée.

Search order: LOCAL, SYSTEM.

Répertoire du cache local

Le répertoire de cache est utilisé pour stocker les caches persistants localement. Actuellement, il n’est utilisé que pour l’indexation des Bibliothèques d’Assets. Le système d’exploitation n’est pas censé effacer cela automatiquement.

Le chemin suivant sera utilisé :

  • Linux:

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

  • macOS:

    /Library/Caches/Blender/

  • Windows:

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

Dossier temporaire

Le dossier temporaire est utilisé pour enregistrer divers fichiers à l’exécution (dont les calques de rendu, le cache de physique, le tampon de copier-coller et les logs de crash).

Le dossier temporaire est sélectionné selon la priorité suivante :

  • Préférences utilisateur (voir File Paths (Chemins de fichiers)).

  • Variables d’environnement (TEMP sous Windows, TMP et TMP_DIR sous les autres plateformes).

  • Le dossier /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 Variables d’environnement for details.