Plugins

O NeoDownloader baixa por meio de plugins. Cada projeto é executado por um plugin, escolhido quando o projeto é criado. Quatro plugins vêm com o NeoDownloader; esta página diz o que cada um deles pega, como um plugin é escolhido para um endereço e o que mostra a página Plugins nas configurações.

Os quatro plugins

O plugin Links diretos baixa endereços que apontam direto para um arquivo. Páginas da web não são para ele: ele as deixa para os outros plugins. Nas Configurações do plugin de um projeto, ele tem, entre outras, Tamanho mínimo e Tamanho máximo, em bytes, e Agrupar por site, que coloca os arquivos em uma pasta com o nome do site de onde vieram.
O Video Downloader pega vídeo e som dos sites de vídeo que conhece - um único vídeo, uma playlist ou um canal inteiro - com escolha de qualidade. Ele não procura vídeo em sites que não conhece. Mais detalhes em Video Downloader.
O Gallery Downloader pega galerias e álbuns dos sites que conhece pelo nome e organiza os arquivos do jeito que o site os organiza. Ele não aceita links diretos para arquivos. Mais detalhes em Gallery Downloader.
O Crawler percorre as páginas de um site e pega os arquivos que encontra nelas. Alguns sites ele conhece pelo nome; qualquer outra página ele lê do jeito que você indicar - como uma única página, uma galeria, um tópico de fórum, ou o site inteiro ou uma parte dele. Mais detalhes em Crawler.

Um endereço também pode ser um padrão que vale por muitos - photo[1-50].jpg, {red,green,blue} - e o NeoDownloader o expande antes da execução, seja qual for o plugin do projeto. Veja Padrões de endereço.

Como um plugin é escolhido

Quando você dá um endereço ao assistente, o NeoDownloader pergunta a cada plugin se ele pode cuidar desse endereço, e os cartões em Escolha o plugin para este download mostram as respostas. Muitas vezes mais de um plugin pode, e o assistente seleciona um nesta ordem:

Crawler, em um site que ele conhece pelo nome.
Links diretos, Video Downloader ou Gallery Downloader. Entre dois que cuidam do endereço, vem primeiro o que não precisa de login.
Crawler, em qualquer outra página. O cartão dele diz então Funciona em qualquer página, mas não sabe nada em particular sobre este site.

Um plugin que precisa que você entre no site ainda pode ser o selecionado. Nesse caso, o assistente se detém neste passo em vez de pulá-lo, para que você leia Login necessário antes que qualquer coisa aconteça.

A seleção é uma sugestão: clique em outro cartão para escolher esse plugin em vez do selecionado. O passo em si está descrito em Novo projeto.

Um projeto fica com o plugin com que foi criado: em Propriedades, o plugin não pode ser trocado. Da próxima vez que você criar um projeto para o mesmo site, Como da última vez escolhe o plugin que você escolheu.

Tentar outro plugin

Quando uma execução não traz nada, ou não traz o que você queria, leia primeiro o Diário do projeto. Muitas vezes ele diz por quê - por exemplo, que uma página pode precisar de um navegador para ser lida.

Se o plugin não conseguiu pegar o que você queria, crie um novo projeto com o mesmo endereço e escolha outro plugin cujo cartão dizia Compatível.

Arquivos que já estão na pasta

Os plugins Links diretos, Gallery Downloader e Crawler têm Se já existe um arquivo com esse nome na seção Download das Configurações do plugin do projeto. Essa configuração decide o que uma execução faz quando a pasta do projeto já contém um arquivo com o nome que ela está prestes a gravar - um que este projeto baixou antes, ou um que simplesmente está lá, deixado por um projeto anterior ou por este mesmo projeto criado de novo:

Não baixar - a opção padrão. O arquivo que está no disco é aproveitado como está, e o diário informa Já no disco, pegos como estão: … com o número desses arquivos.
Baixar se tiver mudado - o arquivo é baixado de novo quando o site informa um tamanho ou uma data diferente para ele; quando o site não informa nem um nem outro, o arquivo conta como não modificado.
Ficar com os dois - o arquivo é baixado e salvo ao lado do antigo, com outro nome.

Se o nome já está ocupado por outro arquivo deste projeto, o novo arquivo é salvo com outro nome, seja qual for a configuração. Um arquivo aproveitado do disco conta como parte deste projeto e aparece entre os arquivos dele.

A página “Plugins”

Configurações… → Extensões → Plugins lista os plugins instalados e diz se cada um deles pode ser executado. É onde olhar quando algo não funciona; nada ali pode ser alterado.

Cada plugin tem um cartão com o nome, a versão e um selo: Pronto, ou Não está pronto quando o plugin não pode ser executado agora. Um plugin que não está pronto não executa nenhum projeto, e no assistente o cartão dele diz Indisponível. Abaixo do nome, o cartão diz por quê:

Linha	O que significa
Está faltando: …	Falta algo de que o plugin precisa; a linha diz o quê.
Feito para outra versão do núcleo	O plugin foi feito para outra versão do NeoDownloader. O núcleo é a parte do NeoDownloader que executa os plugins.

Verificar de novo lê os plugins outra vez e verifica de novo do que cada um deles precisa, sem reiniciar o NeoDownloader.

Um plugin que não pôde ser carregado de jeito nenhum aparece abaixo dos cartões, em vermelho, como Falha ao carregar, com a pasta dele e o motivo. Ele não participa do assistente.

Se um plugin que veio com o NeoDownloader mostrar Não está pronto ou Falha ao carregar, escreva para nós e inclua o que a página Plugins mostra sobre ele.

Licenças de terceiros

Alguns plugins são construídos sobre código de outros autores. Licenças de terceiros, abaixo do cartão de um plugin, lista esse código: cada pacote com a versão e a licença, ou não declarada quando o pacote não indica nenhuma. Clique em um pacote para ler a licença dele, quando o pacote veio com o texto. Este plugin não traz consigo pacotes de terceiros significa que não há nenhum.

Atualizações

Os plugins vêm com o NeoDownloader e são atualizados junto com ele; não existe atualização separada para um plugin. Veja Atualizar o NeoDownloader.