Scripts

Cette section présente les différentes méthodes de script et d'automatisation disponibles dans Siril.

Astuce

Le scripting Python a été introduit dans la version de développement 1.3.5. Il est actuellement marqué comme EXPÉRIMENTAL. Cela ne signifie pas qu'il va détruire vos données : l'interface elle-même est robuste et a été testée tout au long du développement : la nature expérimentale actuelle tient plutôt au fait que nous ne savons pas encore ce que les utilisateurs feront de cette nouvelle fonctionnalité, ni s'il pourrait y avoir des problèmes ou des limitations que nous n'avons pas anticipés, peut-être en raison des contraintes d'empaquetage ou de cohérence entre les différents systèmes d'exploitation.

N'hésitez pas à l'essayer, que ce soit en tant qu'utilisateur en utilisant des scripts publiés sur le dépôt de scripts, ou en tant qu'auteur de scripts. Nous accueillons tous vos retours et nous nous efforcerons d'affiner l'interface tout au long de la série stable 1.4 et de la série de développement 1.5.

Si vous souhaitez déboguer vos scripts Python à l'exécution, cochez la case en regard de Activer le mode de débogage Python. Un tutoriel détaillant les étapes pour s'attacher au processus Python est disponible sur la page de tutoriels Siril.

Avertissement

Tous les scripts ne sont pas rédigés, ou ne relèvent de la responsabilité, de l'équipe de développement de Siril !

Avec l'introduction des scripts Python, les possibilités offertes aux auteurs de scripts Siril se sont considérablement élargies. Un grand pouvoir implique de grandes responsabilités !

Vous, en tant qu'utilisateur, devez vous assurer de faire confiance aux auteurs des scripts que vous utilisez. La version 1.4.0 introduit le dépôt de scripts. Certains des scripts qui s'y trouvent ont été écrits par l'équipe de développement de Siril, mais d'autres ont été écrits par des contributeurs tiers. Veuillez lire la section Informations clés concernant les recommandations pour les auteurs de scripts, les utilisateurs finaux et les règles du dépôt de scripts.

Obtenir des scripts

Un petit nombre de fichiers de script de base sont fournis avec Siril, mais vous pouvez en ajouter d'autres depuis le dépôt de scripts. Pour ce faire, allez dans menu Scripts -> Obtenir des scripts. Cela ouvrira l'onglet Scripts de la boîte de dialogue Préférences. Là, sous la liste des répertoires de scripts locaux, vous trouverez une liste des scripts du dépôt.

Les scripts peuvent être triés par catégorie, par nom, par type ou selon qu'ils sont sélectionnés ou non.

Comme il pourrait éventuellement y avoir un grand nombre de scripts, dont tous ne seront pas pertinents pour votre flux de travail, vous pouvez configurer les scripts que vous souhaitez voir apparaître dans le menu Scripts. Il suffit de cocher la case à côté d'eux et de cliquer sur Appliquer pour mettre à jour le menu.

Astuce

Il n'est pas nécessaire de sélectionner les scripts pour qu'ils apparaissent dans le menu afin qu'ils soient utilisables avec la commande pyscript : celle-ci recherchera dans tous les répertoires de scripts locaux ainsi que dans l'ensemble du dépôt de scripts local.

Avertissement

Les auteurs de scripts peuvent proposer des mises à jour. Occasionnellement, inévitablement, une mauvaise mise à jour peut casser le script pour vous. Les bogues doivent être signalés à l'auteur du script : pour les scripts écrits par l'équipe Siril, vous pouvez les signaler sur le dépôt GitLab des scripts, et pour ceux écrits par des contributeurs tiers, vous devriez les signaler aux coordonnées de contact indiquées dans le script.

Le script peut être ouvert dans l'éditeur de script en double-cliquant dessus dans la liste. Ceci est important pour plusieurs raisons :

Cela vous permet de trouver les coordonnées de l'auteur du script afin de lui signaler un bug.
Lorsque vous double-cliquez sur le script, une option vous permet de revenir aux versions précédentes.
Cela signifie que si une mise à jour a cassé le script, vous pouvez ouvrir la version précédente et en enregistrer une copie locale dans l'un de vos dossiers de scripts locaux, pour l'utiliser jusqu'à ce que l'auteur du script corrige la mauvaise mise à jour. (La version enregistrée dans un dossier local sera prioritaire sur une version du dépôt portant le même nom, mais elle apparaîtra dans un sous-dossier différent du menu, portant le nom de votre dossier de scripts locaux.)