Disposition des dossiers dans Blender

Cette page documente les différents répertoires utilisés par Blender.

Cela peut être utile pour le dépannage, l’automatisation et la personnalisation.

Répertoires utilisateur

Les répertoires utilisateur stockent les préférences, le fichier de démarrage, les extensions installées, les préréglages et bien plus encore. Par défaut, ceux-ci utilisent les dossiers de configuration standard pour chaque système d’exploitation.

Linux

$HOME/.config/blender/4.3/

Si la variable d’environnement $XDG_CONFIG_HOME est définie :

$XDG_CONFIG_HOME/blender/4.3/

macOS

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

Windows

%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.3\

Installation portable

Lorsque vous exécutez Blender à partir d’un disque portable, il est possible de conserver les fichiers de configuration sur le même disque pour les emporter avec vous.

Pour activer cela, créez un dossier nommé portable aux emplacements suivants :

  • Windows : à côté de l’exécutable Blender, dans le dossier décompressé

  • Linux : à côté de l’exécutable Blender, dans le dossier décompressé

  • macOS : dans le paquet d’applications sur Blender.app/Contents/Resources

Ce dossier stockera ensuite les préférences, le fichier de démarrage, les extensions installées et les préréglages.

Variables d’environnement

La variable d’environnement BLENDER_USER_RESOURCES peut être définie sur un répertoire personnalisé pour remplacer le répertoire utilisateur par défaut.

Répertoires du système

Les répertoires système stockent les fichiers fournis avec Blender et nécessaires à son fonctionnement. Cela inclut les scripts, les préréglages, les ressources essentielles et bien plus encore.

Linux

Archive téléchargée depuis blender.org :

./4.3/

Paquets de la distribution Linux :

/usr/share/blender/4.3/

macOS

./Blender.app/Contents/Resources/4.3/

Windows

Fichier Zip téléchargé depuis blender.org :

./4.3/

Programme d’installation téléchargé depuis blender.org :

%ProgramFiles%\Blender Foundation\Blender\4.3\

Installation depuis le Microsoft Store :

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

Variables d’environnement

Les variables d’environnement BLENDER_SYSTEM_SCRIPTS et BLENDER_SYSTEM_EXTENSIONS peuvent être utilisées pour regrouper des scripts et des extensions supplémentaires, qui ne font pas partie de l’installation normale de Blender.

D’autres variables d’environnement BLENDER_SYSTEM peuvent remplacer d’autres chemins système, bien qu’elles ne soient pas couramment utilisées dans la pratique.

Agencement des chemins d’accès

./autosave

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

Situé dans les répertoires des utilisateurs.

./config

Configuration utilisateur et informations sur la session.

Situé dans les répertoires des utilisateurs.

./config/startup.blend

Fichier Blend à charger au démarrage.

./config/userpref.blend

Préférences de l’utilisateur.

./config/bookmarks.txt

Favoris du Navigateur de fichiers.

./config/recent-files.txt

Liste des fichiers récents du menu File.

./config/{APP_TEMPLATE_ID}/startup.blend

Fichier de démarrage pour un modèle d’application.

./config/{APP_TEMPLATE_ID}/userpref.blend

Fichier de préférences utilisateur pour un modèle d’application.

./datafiles

Fichiers de données chargés au moment de l’exécution.

Situé dans les répertoires utilisateur et système. Les fichiers de données utilisateur remplacent ou s’ajoutent aux fichiers de données système.

./datafiles/colormanagement

Configuration OpenColorIO par défaut.

./datafiles/fonts

Polices de l’interface utilisateur.

./datafiles/studiolights

Images de lumière de studio pour la fenêtre 3D.

./extensions

Dépôts des extensions.

Situé dans les répertoires utilisateur et système. Les dépôts sont chargés à partir de ces deux répertoires.

./scripts

Modules complémentaires, préréglages, modèles, interface utilisateur, scripts de démarrage.

Situé dans les répertoires utilisateur et système. Les scripts sont chargés à partir de ces deux répertoires.

./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_core/*.py

Le répertoire des modules complémentaires utilisé pour les modules complémentaires groupés.

./scripts/addons_core/modules/*.py

Modules à utiliser pour addons_core (ajoutés au sys.path de Python).

./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/startup/bl_app_templates_user/{APP_TEMPLATE_ID}

Modèles d’application installés dans les répertoires des utilisateurs.

./scripts/startup/bl_app_templates_system/{APP_TEMPLATE_ID}

Modèles d’application chargés automatiquement à partir des répertoires système.

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

Situé dans les répertoires système.

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