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:

1. Crawler, em um site que ele conhece pelo nome.
2. Links diretos, Video Downloader ou Gallery Downloader. Entre dois que cuidam do endereço, vem primeiro o que não precisa de login.
3. 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 ou passe por uma verificação ainda pode ser o selecionado. Nesse caso, o assistente se detém neste passo em vez de pulá-lo, para que você leia Ação necessária e a linha abaixo do nome do plugin 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.