VBS FileSync
VBS FileSync est le module interne de synchronisation média, de copie sécurisée et de routage automatique de fichiers de VBS Overlay.
Il permet de préparer des Sync Jobs pour copier, déplacer, filtrer, router ou synchroniser des médias entre plusieurs dossiers, machines ou destinations de travail.
Depuis VBS Overlay 1.4.1, FileSync remplace les anciens workflows basés sur FreeFileSync pour les boutons Sync Repository et Sync Project/Composition.
L’objectif est de garder la synchronisation directement dans VBS Overlay, avec une meilleure lisibilité, un suivi d’état, des compteurs, un mode Dry Run et une intégration avec OSC / Companion.
À quoi sert VBS FileSync ?
VBS FileSync sert à automatiser les transferts de fichiers importants dans un environnement live.
Il permet notamment de :
créer plusieurs Sync Jobs ;
définir des dossiers source et destination ;
copier des fichiers ;
déplacer des fichiers ;
ignorer certains fichiers ;
supprimer ou nettoyer certaines destinations selon les règles ;
surveiller un dossier ;
filtrer par extension ;
exclure certains dossiers ou fichiers ;
inclure les sous-dossiers ;
gérer les conflits ;
renommer automatiquement en cas de doublon ;
créer des règles de routage par nom de fichier ;
suivre la progression du transfert ;
afficher les compteurs de fichiers copiés, déplacés, ignorés, supprimés ou en erreur ;
lancer une synchronisation manuellement ;
lancer une synchronisation depuis Manage ;
lancer une synchronisation depuis OSC ou Companion.
FileSync est pensé pour les workflows où il faut sécuriser les transferts médias avant une exploitation.
Profile
La section Profile définit le profil FileSync principal.
On y retrouve le nom du profil et les interrupteurs globaux du module.
Sur la capture, le profil s’appelle FileSync.
Les options principales sont Enable, Watch folder, Dry run et Run at startup.
Enable
Enable active ou désactive le profil FileSync.
Si Enable est désactivé, le profil ne doit pas être considéré comme actif.
Cette option permet de garder une configuration prête sans forcément l’utiliser immédiatement.
Watch folder
Watch folder active la surveillance de dossier.
Quand cette option est activée, FileSync peut surveiller les dossiers sources et réagir aux changements selon la configuration.
C’est utile lorsqu’un dossier reçoit régulièrement de nouveaux médias.
Dry run
Dry run active le mode simulation.
Quand Dry run est activé, FileSync peut analyser ce qu’il devrait faire sans appliquer réellement les copies, déplacements, suppressions ou modifications.
C’est un mode très important pour sécuriser les premiers tests.
Le bouton en haut indique Dry run recommended, ce qui rappelle qu’il est recommandé de tester les règles en Dry Run avant de lancer une vraie synchronisation.
Run at startup
Run at startup permet de lancer ou préparer FileSync automatiquement au démarrage de VBS Overlay selon la configuration.
Cette option peut être utile sur une machine dédiée à un workflow de synchronisation permanent.
Preset & sync jobs
La section Preset & sync jobs permet de gérer les presets FileSync et les Sync Jobs.
Un preset correspond à une configuration enregistrée.
Un Sync Job correspond à un ensemble de règles de synchronisation.
Cette section permet de charger, créer, sauvegarder ou exporter une configuration.
Open preset
Open preset permet de charger un preset FileSync existant.
C’est utile lorsque plusieurs configurations sont utilisées selon les shows, clients ou machines.
New preset
New preset permet de créer une nouvelle configuration FileSync.
Il est recommandé de créer un preset propre par workflow important, par exemple Repository, Project, Backup ou Media routing.
Save
Save enregistre les modifications dans le preset actuel.
Save as
Save as permet d’enregistrer la configuration sous un nouveau nom.
C’est utile pour dupliquer une configuration existante et l’adapter sans écraser l’original.
Export run preset
Export run preset permet d’exporter un preset destiné à être lancé ou utilisé dans un contexte spécifique.
Cela peut servir à préparer une configuration transférable ou documentée pour un workflow de production.
Sync Jobs
Les Sync Jobs sont les onglets visibles dans la partie principale de FileSync.
Chaque onglet correspond à un job de synchronisation.
Sur la capture, le job visible s’appelle Sync 1.
Le badge REPO indique que ce job est affecté au bouton Repository.
Le bouton + permet d’ajouter un nouveau Sync Job.
Le x permet de fermer ou retirer un job selon le contexte.
Affectation Sync Dashboard
La zone Affectation Sync Dashboard permet de choisir quel bouton Sync de Manage ou quel endpoint OSC peut appeler ce Sync Job.
Chaque Sync Job peut être affecté à :
Repository ;
Project/Composition ;
Repository + Project/Composition ;
Manual only.
Si Repository est activé, ce job sera lancé par le bouton Sync Repository.
Si Project/Composition est activé, ce job sera lancé par le bouton Sync Project/Composition.
Si les deux sont activés, le job pourra être lancé par les deux types d’actions.
Si aucun des deux n’est activé, le job reste en mode manuel et ne sera pas appelé par les boutons Sync principaux.
Cette affectation est très importante car elle permet de savoir précisément quel job est déclenché par chaque bouton de gestion ou commande OSC.
Line
Chaque Sync Job peut contenir une ou plusieurs lignes.
Une ligne définit un couple source / destination et un comportement de transfert.
Sur la capture, la ligne visible est Line 1.
Le bouton + permet d’ajouter une nouvelle ligne.
Le bouton de suppression permet de retirer la ligne.
Dossier source
Le dossier source est le dossier surveillé ou analysé par FileSync.
C’est le dossier d’où partent les fichiers.
Il peut s’agir d’un dossier média, d’un repository, d’un dossier projet, d’un dossier d’export ou de tout autre emplacement à synchroniser.
Il faut toujours vérifier que le dossier source est correct avant de lancer une synchronisation.
Dossier destination
Le dossier destination est le dossier qui reçoit les fichiers copiés ou déplacés.
C’est la cible du transfert.
Il peut s’agir d’un autre dossier local, d’un disque, d’un partage réseau, d’une machine backup ou d’un dossier de préparation.
Il faut vérifier que la destination existe, qu’elle est accessible et que Windows autorise l’écriture.
Browse
Les boutons Browse permettent de sélectionner les dossiers source et destination sans saisir le chemin manuellement.
C’est la méthode recommandée pour éviter les erreurs de chemin.
Comportement
La section Comportement définit comment FileSync doit traiter les fichiers de la ligne.
Elle regroupe l’action par défaut, le mode conflit, les délais de stabilité, l’anti-rebond, l’inclusion des sous-dossiers, les extensions surveillées, les filtres exclus et les règles de routage.
Action par défaut
Action par défaut définit ce que FileSync fait avec les fichiers qui correspondent à la ligne.
Sur la capture, l’action est Copy.
Selon la configuration, l’action peut être Copy, Move, Skip, Delete, Mirror ou une autre action disponible.
Copy copie les fichiers vers la destination.
Move déplace les fichiers vers la destination.
Skip ignore les fichiers concernés.
Delete supprime selon les règles configurées.
Mirror permet d’aligner une destination avec une source selon la logique prévue.
Il est recommandé de bien comprendre l’action choisie avant de lancer une vraie synchronisation.
Mode conflit
Mode conflit définit ce qui se passe si un fichier existe déjà dans la destination.
Sur la capture, le mode conflit est Auto rename.
Auto rename permet d’éviter d’écraser un fichier existant en créant automatiquement un nouveau nom.
C’est une option sécurisante pour les workflows live, car elle limite le risque de remplacer un média par erreur.
Stabilité
Stabilité définit le délai d’attente avant de considérer qu’un fichier est prêt à être traité.
Sur la capture, la stabilité est réglée à 2 secondes.
Ce délai est important lorsqu’un fichier est encore en cours de copie ou d’écriture dans le dossier source.
Attendre quelques secondes permet d’éviter de transférer un fichier incomplet.
Anti-rebond
Anti-rebond définit un délai de protection contre les événements répétés trop rapidement.
Sur la capture, l’anti-rebond est réglé à 1500 ms.
Cela permet d’éviter qu’un même fichier ou événement déclenche plusieurs fois le traitement de manière inutile.
Inclure les sous-dossiers
L’option Inclure les sous-dossiers permet à FileSync de traiter également les fichiers contenus dans les sous-dossiers du dossier source.
Cette option est utile lorsqu’un dossier média est organisé en arborescence.
Si elle est désactivée, FileSync peut se limiter au dossier source principal.
Extensions à surveiller
La zone Extensions à surveiller permet de définir les types de fichiers concernés par le Sync Job.
Sur la capture, plusieurs extensions média sont listées, par exemple .mov, .mp4, .mxf, .avi, .mkv, .wav, .aif, .aiff, .png, .jpg, .jpeg ou .psd.
Cela permet d’éviter de transférer des fichiers inutiles.
Il est recommandé de ne surveiller que les extensions nécessaires au workflow.
Ajouter une extension
Le champ Ajouter une extension permet d’ajouter manuellement une extension à la liste.
C’est utile si un format spécifique n’est pas encore présent.
Filtres exclus
La zone Filtres exclus permet d’ignorer certains fichiers ou dossiers.
Les filtres doivent être séparés par des points-virgules.
Cette zone est utile pour exclure les caches, fichiers temporaires, exports proxy, dossiers inutiles ou fichiers qui ne doivent pas être transférés.
Exemples possibles :
cache ;
tmp ;
bak ;
exports/proxy.
Les filtres d’exclusion permettent de garder les transferts propres et d’éviter les fichiers parasites.
Règles de routage
Les règles de routage permettent de traiter certains fichiers différemment selon leur nom ou leur chemin.
Chaque règle peut contenir une condition, un pattern, une action et un dossier cible.
Cela permet de router automatiquement certains médias vers des sous-dossiers ou destinations spécifiques.
Par exemple, un fichier contenant un mot précis peut être déplacé vers un dossier cible dédié.
On
L’interrupteur On active ou désactive une règle de routage.
Cela permet de garder une règle prête sans forcément l’appliquer.
Condition
Condition définit la logique utilisée pour tester le fichier.
Sur la capture, la condition est Contains.
Cela signifie que la règle s’applique si le nom ou le chemin contient le pattern défini.
Pattern
Pattern correspond au texte ou motif recherché.
C’est la valeur que FileSync utilise pour savoir si la règle doit s’appliquer.
Action
Action définit ce que fait la règle lorsque la condition est remplie.
Sur la capture, l’action est Move.
Cela signifie que les fichiers correspondant à la règle peuvent être déplacés vers le dossier cible.
Target folder
Target folder définit le dossier cible de la règle.
FileSync peut créer automatiquement ce dossier selon la configuration.
C’est utile pour organiser automatiquement des médias dans des sous-dossiers spécifiques.
Live status
La section Live status affiche l’état de connexion et de disponibilité de FileSync.
Elle permet de voir rapidement si FileSync est connecté, si les sources et destinations sont disponibles, combien de fichiers sont en file d’attente, et si des erreurs sont présentes.
Connected
Connected indique si FileSync est connecté ou actif selon le contexte.
Sur la capture, Connected affiche false.
Cela signifie que FileSync n’est pas actuellement connecté ou actif en mode surveillance.
Availability
Availability indique la disponibilité des sources et destinations.
Sur la capture, les sources disponibles sont 1/2 et les destinations disponibles sont 1/2.
Cela permet de repérer rapidement si un chemin source ou destination est inaccessible.
File
File indique le nombre de fichiers en cours ou en file selon le contexte.
Temps
Temps indique la durée ou l’estimation liée au traitement si disponible.
Progression
Progression affiche l’avancement du transfert.
Sur la capture, la progression est à 0 %.
Cette zone est importante pendant une synchronisation, car elle permet de suivre l’état général du traitement.
Fichier en cours
Fichier en cours affiche le fichier actuellement traité.
Si aucun transfert n’est en cours, la valeur reste vide ou à tiret.
Counters
La section Counters affiche les compteurs de traitement.
Elle peut indiquer :
le nombre de fichiers copiés ;
le nombre de fichiers déplacés ;
le nombre de fichiers ignorés ;
le nombre de fichiers supprimés ;
le nombre d’erreurs.
Ces compteurs sont utiles pour vérifier le résultat d’une synchronisation après exécution.
Start FileSync
Le bouton Start FileSync démarre FileSync ou la surveillance selon la configuration.
Il est utile lorsque Watch folder est activé et que FileSync doit commencer à surveiller les dossiers.
Stop FileSync
Le bouton Stop FileSync arrête FileSync ou la surveillance active.
Il permet de stopper le traitement sans fermer la fenêtre.
Sync now
Le bouton Sync now lance immédiatement une synchronisation.
C’est le bouton à utiliser pour exécuter manuellement le ou les jobs configurés.
Avant de cliquer sur Sync now, il est recommandé d’utiliser Dry run pour vérifier ce qui va se passer.
Cancel
Le bouton Cancel annule la synchronisation en cours.
Il est utile si une erreur est détectée, si le mauvais job a été lancé ou si le transfert doit être interrompu.
Media routing
Le bouton Media routing rappelle que FileSync peut faire du routage automatique de médias.
Cette logique permet d’organiser les fichiers selon leur nom, leur extension, leur dossier source ou les règles définies.
C’est utile lorsqu’un dossier reçoit plusieurs types de médias qui doivent être dirigés vers des emplacements différents.
Logging
L’onglet Logging permet d’accéder aux logs FileSync.
Les logs servent à comprendre ce qui a été fait, ce qui a été ignoré, ce qui a échoué, et pourquoi.
Ils sont utiles pour diagnostiquer un transfert ou garder une trace des opérations.
Barre de statut inférieure
La barre de statut inférieure donne une vue rapide de l’état global de FileSync.
Sur la capture, on retrouve :
Connected: false ;
Sources disponibles ;
Queue ;
Erreurs ;
Status FileSync ready.
Cette zone est utile pour vérifier en un coup d’œil si FileSync est prêt, connecté, en erreur ou en attente.
Companion dynamique
Les Sync Jobs FileSync peuvent être publiés dans le remote status de VBS Overlay.
Le module Bitfocus Companion peut alors générer des boutons dynamiques pour chaque Sync Job.
Cela permet de déclencher directement un job précis depuis un Stream Deck.
Le feedback du bouton peut indiquer l’état du dernier transfert :
jaune pendant un transfert ;
vert si le dernier transfert s’est terminé correctement ;
rouge si le dernier transfert a échoué, a été annulé ou ne s’est pas terminé correctement.
Cette intégration est particulièrement utile pour les opérateurs qui veulent déclencher des synchronisations précises sans ouvrir la fenêtre FileSync.
Différence entre Sync Repository et Sync Project/Composition
Sync Repository lance les Sync Jobs affectés à Repository.
Sync Project/Composition lance les Sync Jobs affectés à Project/Composition.
Ce mode est prévu pour les synchronisations liées à un projet de show, une composition, un dossier de travail ou une configuration qui peut nécessiter une action après la copie.
Dans Admin Access, une option dédiée au workflow Project/Composition permet de configurer une action post-sync sur la machine backup.
L’objectif est de pouvoir arrêter le projet ou la composition sur la machine backup avant la synchronisation, puis le relancer automatiquement une fois la synchronisation terminée.
Ce fonctionnement est utile lorsqu’une machine backup doit récupérer les derniers fichiers d’un projet sans garder une ancienne version ouverte en arrière-plan.
Le workflow peut donc être :
arrêter ou killer le projet backup ;
synchroniser les fichiers Project/Composition avec VBS FileSync ;
relancer le projet ou la composition sur la machine backup après la synchronisation.
Un même Sync Job peut être affecté à Repository et Project/Composition si nécessaire.
Un job en Manual only ne sera pas appelé par les boutons Sync principaux. Il devra être lancé manuellement depuis FileSync ou via son bouton Companion dédié.
Cette logique permet de séparer clairement les synchronisations simples, les synchronisations de projet, les jobs manuels et les workflows backup avec relance automatique.
Différence entre FileSync et QuickShare
FileSync est destiné aux synchronisations structurées, répétables et contrôlées.
QuickShare est destiné aux transferts rapides et temporaires avec un invité via QR code ou PIN.
Utilisez FileSync pour les dossiers de production, les repositories, les projets, les backups et les workflows répétables.
Utilisez QuickShare pour échanger rapidement un fichier avec un appareil invité.
Différence entre FileSync et Actions
FileSync sert à synchroniser et router des fichiers selon des jobs configurés.
Actions sert à envoyer rapidement un package, une URL ou une commande vers une machine VBS Overlay sélectionnée.
Utilisez FileSync pour des transferts structurés.
Utilisez Actions pour des opérations ponctuelles.
Utilisation recommandée
Utilisez VBS FileSync pendant :
la préparation d’un show ;
la synchronisation d’un repository ;
la synchronisation d’un projet ou d’une composition ;
la mise à jour d’une machine backup ;
le routage automatique de médias ;
la copie sécurisée de fichiers ;
le transfert de fichiers vers une destination organisée ;
la surveillance d’un dossier d’arrivée ;
la préparation de médias pour plusieurs machines ;
les workflows nécessitant des compteurs et un suivi d’état.
FileSync est particulièrement utile lorsqu’un transfert doit être fiable, répétable et compréhensible.
Bonnes pratiques
Avant une vraie synchronisation, activez Dry run.
Vérifiez toujours les dossiers source et destination.
Utilisez des noms de Sync Jobs clairs.
Affectez chaque Sync Job au bon rôle : Repository, Project/Composition ou Manual only.
Ne surveillez que les extensions nécessaires.
Utilisez les filtres exclus pour éviter les caches et fichiers temporaires.
Utilisez Auto rename pour éviter les écrasements accidentels.
Vérifiez les sources et destinations disponibles avant de lancer Sync now.
Contrôlez les compteurs après le transfert.
Utilisez Logging en cas de doute.
Testez les boutons Companion avant une exploitation live.
Évitez de modifier les règles pendant un transfert actif.
Dépannage
Si FileSync ne démarre pas :
vérifiez que Enable est activé ;
vérifiez que les chemins source et destination existent ;
vérifiez les droits Windows ;
vérifiez que VBS Overlay a les autorisations nécessaires ;
vérifiez que les disques ou partages réseau sont accessibles.
Si un fichier n’est pas transféré :
vérifiez son extension ;
vérifiez les filtres exclus ;
vérifiez les règles de routage ;
vérifiez que le fichier n’est pas encore en cours de copie ;
augmentez la valeur Stabilisation si nécessaire ;
vérifiez qu’il n’est pas déjà ignoré.
Si la destination n’est pas disponible :
vérifiez le chemin ;
vérifiez le réseau ;
vérifiez les partages SMB ;
vérifiez les droits d’écriture ;
vérifiez que la machine distante est en ligne ;
vérifiez que le disque est monté.
Si Sync Repository ou Sync Project ne déclenche pas le bon job :
vérifiez l’Affectation Sync Dashboard ;
vérifiez que Repository ou Project/Composition est activé sur le bon Sync Job ;
vérifiez que le job n’est pas en Manual only ;
vérifiez les endpoints OSC si le déclenchement vient de Companion.
Si Companion ne voit pas les jobs FileSync :
vérifiez que le remote status est accessible ;
vérifiez que Companion utilise la bonne adresse IP ;
vérifiez que le polling status est actif ;
vérifiez que les Sync Jobs existent dans FileSync ;
vérifiez que la version du module Companion correspond à la version VBS Overlay.
Si un transfert échoue :
consultez les compteurs ;
ouvrez l’onglet Logging ;
vérifiez le fichier en erreur ;
vérifiez les droits Windows ;
vérifiez le réseau ;
vérifiez l’espace disque disponible ;
relancez d’abord en Dry run avant une nouvelle vraie synchronisation.