Plugins

NeoDownloader télécharge au moyen de plugins. Chaque projet est exécuté par un seul plugin, choisi à la création du projet. Quatre plugins sont fournis avec NeoDownloader ; cette page explique ce que chacun prend en charge, comment l'un d'eux est choisi pour une adresse, et ce que montre la page Plugins des paramètres.

Les quatre plugins

Le plugin Liens directs télécharge les adresses qui pointent directement sur un fichier. Les pages web ne sont pas pour lui : il les laisse aux autres plugins. Dans les Paramètres du plugin d'un projet, il propose entre autres Taille minimale et Taille maximale, en octets, et Regrouper par site, qui place les fichiers dans un dossier portant le nom du site d'où ils viennent.
Video Downloader prend la vidéo et le son sur les sites de vidéos qu'il connaît - une vidéo seule, une playlist ou une chaîne entière - avec un choix de qualité. Il ne cherche pas de vidéo sur les sites qu'il ne connaît pas. Plus de détails dans Video Downloader.
Gallery Downloader prend les galeries et les albums des sites qu'il connaît par leur nom, et range les fichiers comme le site les range. Il ne prend pas en charge les liens directs vers des fichiers. Plus de détails dans Gallery Downloader.
Le Crawler parcourt les pages d'un site et prend les fichiers qu'il y trouve. Il connaît quelques sites par leur nom ; toute autre page, il la lit de la façon que vous lui indiquez - comme une page seule, une galerie, un fil de forum, ou le site entier ou une partie de celui-ci. Plus de détails dans Crawler.

Une adresse peut aussi être un motif qui en représente plusieurs - photo[1-50].jpg, {red,green,blue} - et NeoDownloader le développe avant l'exécution, quel que soit le plugin du projet. Voir Motifs d'adresses.

Comment un plugin est choisi

Quand vous donnez une adresse à l'assistant, NeoDownloader demande à chaque plugin s'il peut la prendre en charge, et les cartes de l'étape Choisissez le plugin pour ce téléchargement affichent leurs réponses. Souvent, plusieurs plugins le peuvent, et l'assistant en sélectionne un dans cet ordre :

Le Crawler, sur un site qu'il connaît par son nom.
Liens directs, Video Downloader ou Gallery Downloader. De deux plugins qui prennent l'adresse en charge, celui qui n'a pas besoin de connexion passe en premier.
Le Crawler, sur toute autre page. Sa carte indique alors Fonctionne sur n'importe quelle page, mais ne sait rien de particulier sur ce site.

Un plugin qui a besoin que vous vous connectiez peut quand même être le plugin sélectionné. L'assistant s'arrête alors à cette étape au lieu de la sauter, pour que vous lisiez Connexion requise avant que quoi que ce soit ne se passe.

La sélection est une suggestion : cliquez sur une autre carte pour choisir ce plugin à la place. L'étape elle-même est décrite dans Nouveau projet.

Un projet garde le plugin avec lequel il a été créé : dans Propriétés, le plugin ne peut pas être changé. La prochaine fois que vous créerez un projet pour le même site, Comme la dernière fois choisira le plugin que vous aviez choisi.

Essayer un autre plugin

Quand une exécution ne récupère rien, ou pas ce que vous vouliez, lisez d'abord le Journal du projet. Il indique souvent pourquoi - par exemple, qu'une page a peut-être besoin d'un navigateur pour être lue.

Si le plugin n'a pas pu prendre ce que vous vouliez, créez un nouveau projet avec la même adresse et choisissez un autre plugin dont la carte indiquait Pris en charge.

Fichiers déjà présents dans le dossier

Liens directs, Gallery Downloader et le Crawler proposent Si un fichier de ce nom existe déjà sous Téléchargement dans les Paramètres du plugin du projet. Ce paramètre décide de ce que fait une exécution quand le dossier du projet contient déjà un fichier portant le nom qu'elle s'apprête à écrire - un fichier que ce projet a téléchargé auparavant, ou un fichier qui se trouve simplement là, laissé par un projet antérieur ou par ce même projet recréé :

Ne pas télécharger - la valeur par défaut. Le fichier sur le disque est repris tel quel, et le journal indique Déjà sur le disque, repris tels quels : … avec le nombre de fichiers.
Télécharger s'il a changé - le fichier est téléchargé de nouveau quand le site indique pour ce fichier une taille ou une date différente ; quand le site n'indique ni l'une ni l'autre, le fichier compte comme inchangé.
Garder les deux - le fichier est téléchargé et enregistré à côté de l'ancien sous un autre nom.

Si le nom est déjà pris par un autre fichier de ce projet, le nouveau fichier est enregistré sous un autre nom, quelle que soit la valeur de ce paramètre. Un fichier repris depuis le disque compte comme un fichier de ce projet et apparaît parmi ses fichiers.

La page « Plugins »

Paramètres… → Extensions → Plugins liste les plugins installés et indique si chacun peut fonctionner. C'est là qu'il faut regarder quand quelque chose ne marche pas ; rien ne peut y être modifié.

Chaque plugin a une carte avec son nom, sa version et un badge : Prêt, ou Pas prêt quand le plugin ne peut pas fonctionner pour le moment. Un plugin qui n'est pas prêt n'exécute aucun projet, et dans l'assistant sa carte indique Indisponible. Sous son nom, la carte dit pourquoi :

Ligne	Ce que cela signifie
Manquant : …	Il manque quelque chose dont le plugin a besoin ; la ligne le nomme.
Conçu pour une autre version du cœur	Le plugin a été fait pour une autre version de NeoDownloader. Le cœur est la partie de NeoDownloader qui exécute les plugins.

Vérifier de nouveau relit les plugins et vérifie une nouvelle fois ce dont chacun a besoin, sans redémarrer NeoDownloader.

Un plugin qui n'a pas pu être chargé du tout est affiché en rouge sous les cartes, avec Échec du chargement, son dossier et la raison. Il n'intervient pas dans l'assistant.

Si un plugin fourni avec NeoDownloader affiche Pas prêt ou Échec du chargement, écrivez-nous en indiquant ce que la page Plugins affiche à son sujet.

Licences tierces

Certains plugins reposent sur du code d'autres auteurs. Licences tierces, sous la carte d'un plugin, liste ce code : chaque paquet avec sa version et sa licence, ou non déclarée quand le paquet n'en indique aucune. Cliquez sur un paquet pour lire sa licence, quand le texte est fourni avec le paquet. Ce plugin ne transporte aucun paquet tiers signifie qu'il n'y en a pas.

Mises à jour

Les plugins sont fournis avec NeoDownloader et mis à jour en même temps que lui ; il n'existe pas de mise à jour séparée pour un plugin. Voir Mettre à jour NeoDownloader.