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.2/
Si la variable d’environnement $XDG_CONFIG_HOME
est définie :
$XDG_CONFIG_HOME/blender/4.2/
macOS#
/Users/$USER/Library/Application Support/Blender/4.2/
Windows#
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.2\
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.2/
Paquets de la distribution Linux :
/usr/share/blender/4.2/
macOS#
./Blender.app/Contents/Resources/4.2/
Windows#
Fichier Zip téléchargé depuis blender.org :
./4.2/
Programme d’installation téléchargé depuis blender.org :
%ProgramFiles%\Blender Foundation\Blender\4.2\
Installation depuis le Microsoft Store :
%ProgramFiles%\WindowsApps\BlenderFoundation.Blender<HASH>\Blender\4.2\
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 ausys.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
../scripts/templates_osl/*.osl
Exemples de shaders OSL accessibles dans
.
./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
etTMP_DIR
sous les autres plateformes).Le dossier
/tmp/
.