De Blender au navigateur en un clic : plongée dans le plugin Cotoon
fonctionnalités blender pipeline technique

De Blender au navigateur en un clic : plongée dans le plugin Cotoon

Comment l'application desktop Cotoon et le add-on Blender éliminent le fossé entre vos fichiers locaux et votre pipeline de production.

T

The Cotoon Team

Chaque animateur connaît cette friction. Vous terminez une passe dans Blender, sauvegardez le fichier, puis passez les minutes suivantes à l’uploader manuellement dans votre outil de gestion de projet, à le tagger correctement et à notifier votre équipe. Ce sont deux minutes de tâches sans valeur, mais elles se répètent des dizaines de fois par jour — et c’est exactement le genre de friction qui vous arrache à votre flux créatif.

Nous avons construit l’application desktop Cotoon et le add-on Blender pour éliminer ce fossé entièrement. Voici comment tout cela fonctionne sous le capot.

Le système en un coup d’œil

L’intégration repose sur trois composants qui fonctionnent de concert : un add-on Blender léger qui surveille les sauvegardes de fichiers, une application desktop qui tourne discrètement dans la barre système, et un protocole URL personnalisé qui leur permet de communiquer instantanément. Quand les trois sont actifs, dès que vous appuyez sur Cmd+S dans Blender, votre fichier est automatiquement mis en file d’attente pour l’upload — sans changer d’application, sans aucune étape manuelle.

Le add-on Blender : un observateur silencieux

Le add-on (cotoon-blender-autoqueue) est un petit script Python qui enregistre un handler persistant sur l’événement save_post de Blender. À chaque sauvegarde d’un fichier .blend, il se déclenche.

Ce handler fait quelque chose d’élégant dans sa simplicité : il prend le chemin du fichier sauvegardé, l’encode en URL et construit un deep link personnalisé — my-uploader://add?path=... — puis déclenche cette URL via le gestionnaire de protocole natif de l’OS. Sur macOS, c’est un appel subprocess à open -g (le flag -g est crucial — il ouvre l’application cible en arrière-plan sans voler le focus). Sur Windows, il utilise os.startfile.

Le résultat : Blender ne marque jamais de pause. Il sauvegarde, déclenche l’événement, et le add-on passe la main à l’application desktop de manière invisible. Votre viewport 3D reste au premier plan.

Filtrage par dossier : ne surveiller que ce qui compte

Le add-on est livré avec une préférence optionnelle qui permet de restreindre son comportement à un dossier spécifique. Si vous définissez un Dossier surveillé, seules les sauvegardes à l’intérieur de ce répertoire (et ses sous-dossiers) déclencheront la file d’attente. C’est idéal pour les artistes qui ont un dossier de production dédié — cela signifie que les fichiers de travail personnels ou les projets de tutoriels sauvegardés ailleurs n’atterriront pas accidentellement dans la file d’upload du studio.

La vérification du dossier utilise os.path.commonpath pour confirmer que le fichier est bien un enfant du répertoire surveillé, ce qui gère également les cas limites comme les sauvegardes sur des lecteurs différents sous Windows.

L’application desktop : le pont

L’application desktop est construite avec Electron et vit dans la barre système, tournant discrètement en arrière-plan. Quand macOS ou Windows reçoit l’URL de protocole my-uploader:// déclenchée par le add-on, l’OS la route directement vers l’application desktop Cotoon.

L’application traite le chemin entrant dans une fonction processDeepLink qui distingue délibérément deux types de requêtes : les callbacks d’authentification (qui nécessitent que la fenêtre s’affiche au premier plan) et les ajouts de fichiers (qui doivent rester complètement invisibles). Quand un fichier arrive via le add-on Blender, la fenêtre ne surgit jamais. Sur macOS, l’icône du dock rebondit une fois pour signaler qu’il s’est passé quelque chose — et c’est tout.

Le fichier mis en file d’attente est ensuite traité : lu depuis le disque, converti pour la visualisation web, et uploadé vers votre espace de travail Cotoon dans la bonne étape du projet.

Installation en un clic

Nous voulions que l’installation soit aussi fluide que le workflow lui-même. L’application desktop scanne automatiquement votre système à la recherche des versions de Blender installées en vérifiant les chemins de configuration standard (~/Library/Application Support/Blender sur macOS, %APPDATA%/Blender Foundation/Blender sur Windows). Elle liste chaque version trouvée et vous indique si le add-on Cotoon est déjà installé pour chacune.

Un seul clic copie le fichier du add-on dans le bon répertoire scripts/addons et lance ensuite un processus Blender en arrière-plan pour activer le add-on par programmation — vous n’avez donc jamais à ouvrir manuellement le panneau des préférences de Blender. Votre paramètre de dossier surveillé est également synchronisé depuis l’application desktop directement dans les préférences de Blender de la même manière, de sorte que vous configurez tout en un seul endroit.

Le pipeline d’export : de la 3D prête pour le navigateur

Uploader un fichier .blend brut n’est que la moitié de l’histoire. Pour les assets qui doivent être consultables directement dans l’interface navigateur de Cotoon — sans aucun plugin — l’application fait également tourner un pipeline d’export en arrière-plan.

Quand vous mettez un fichier en file d’attente pour l’export, l’application desktop lance un processus Blender headless et y fait tourner un script Python d’export. Vous pouvez configurer la résolution, la compression, le moteur de rendu et les objets à inclure. Le script scanne la hiérarchie de la scène (en respectant la visibilité des collections et la parentalité des objets), cuit les textures dans un atlas, et génère un format optimisé pour le web qui s’affiche dans n’importe quel navigateur moderne.

Le scanner de scène lit directement le view layer de Blender — en respectant la visibilité de l’icône « œil » que vous avez définie dans l’Outliner — de sorte que ce que votre équipe voit dans le navigateur correspond exactement à ce que vous voyez dans votre viewport.

Une fois l’export réussi, le chemin de sortie est renvoyé à l’application desktop, uploadé dans le stockage Supabase, et publié dans la bonne étape de votre projet Cotoon. Les fichiers temporaires sont ensuite nettoyés automatiquement.

Ce que ça donne en pratique

Dans une session typique, un artiste ouvre son rig de personnage, fait des ajustements et sauvegarde. L’icône du dock rebondit. Dix secondes plus tard, une nouvelle version apparaît dans Cotoon — avec un aperçu 3D consultable dans le navigateur — et le directeur reçoit une notification. Pas d’e-mails, pas d’uploads manuels, plus de messages « tu peux m’envoyer la dernière version ? ».

Tout le pipeline est conçu autour d’un seul principe : vos outils doivent disparaître. Le meilleur logiciel de production est celui auquel on arrête de penser, parce qu’il fait tranquillement son travail pendant que vous vous concentrez sur la création.


Le plugin Blender et l’application desktop sont actuellement en accès anticipé. Si vous souhaitez l’essayer sur votre production, contactez-nous — nous intégrons les studios directement.

Back to Blog