Gestores de transferências

Configuração

Liga a tua app de transferências para o HolyArrs lhe enviar Lançamentos e importar o que terminar.

O HolyArrs não transfere por si. Entrega cada Lançamento a um Gestor de transferências, acompanha-o e importa os ficheiros.

Tipo	Apps
Torrent	qBittorrent, Transmission 4 ou mais recente, Deluge, rTorrent (com ou sem ruTorrent)
Usenet	SABnzbd, NZBGet

Antes de começares

És o proprietário ou um administrador.
A tua app de transferências está a funcionar e consegues abrir a página web dela.

Adicionar um Gestor de transferências

Abre Settings > Downloaders (Definições > Gestores de transferências).
Clica em Add a Downloader (adicionar um gestor de transferências).
Em Which app (Que app), escolhe a tua app.
Escreve um Name (nome).
Escreve o Address (endereço), a página web da app, como http://192.168.1.10:8090. Para o rTorrent, vê Endereço do rTorrent.
Preenche o início de sessão. Vê Início de sessão de cada app.
Clica em Save (guardar) e depois em Test (testar) na linha.

Deves ver Working (a funcionar) junto ao nome.

Início de sessão de cada app

App	O que escrever	Onde encontrar
qBittorrent	API key (chave de API) (qBittorrent 5.2 ou mais recente) ou Username and password (nome de utilizador e palavra-passe)	Options > Web UI
Transmission	Nome de utilizador e palavra-passe, vazios se não pedir nenhum	Definições do Transmission
Deluge	Palavra-passe da Web UI, sem nome de utilizador	Deluge Web UI
rTorrent	Nome de utilizador e palavra-passe do servidor web que está à frente do rTorrent, vazios se não pedir nenhum	As definições do teu servidor web ou da seedbox
SABnzbd	Chave de API	Config > General
NZBGet	Nome de utilizador e palavra-passe, vazios se o NZBGet deixar o HolyArrs entrar sem eles	Definições do NZBGet

O HolyArrs guarda as chaves e as palavras-passe cifradas e nunca as volta a mostrar. Deixa o campo como está para manter a que está guardada. Quando mudas o endereço para outro host, escreve a chave outra vez. O HolyArrs nunca envia uma chave guardada para um host novo.

Endereço do rTorrent

O HolyArrs fala com o rTorrent por XML-RPC. O Address é essa ligação, não a página do ruTorrent.

Configuração	Endereço
crazymax/rtorrent-rutorrent	`http://host:8000/RPC2`. A porta 8080 aí é a página do ruTorrent
Através do ruTorrent	`http://host:8080/plugins/httprpc/action.php`, ou `/rutorrent/plugins/httprpc/action.php` quando o ruTorrent está em `/rutorrent`. O `/plugins/rpc/rpc.php` também funciona
Seedbox	A ligação que a tua seedbox der, como `https://host/user/RPC2`

Um endereço sem caminho recebe /RPC2. Testado com o rTorrent 0.16.25 e o ruTorrent 5.3.18.

O HolyArrs vai buscar cada ficheiro .torrent por si e envia-o ao rTorrent, por isso o rTorrent nunca contacta a Fonte.

rTorrent numa seedbox

Quando o rTorrent corre noutra máquina, o HolyArrs não vê a pasta de transferências dele. Configura uma sincronização que copie os ficheiros terminados para uma pasta que o HolyArrs veja. Depois acrescenta um par de caminhos em Caminhos: Downloader’s path é a pasta da seedbox, como /home/user/downloads, e HolyArrs’ path é a pasta local que a sincronização enche.

Opções

No qBittorrent, estas ficam em More options (mais opções).

Categoria

O HolyArrs arquiva as suas transferências nesta categoria e só acompanha essa categoria.

App	Como funciona a categoria
qBittorrent	Criada por ti se não existir
SABnzbd	Tem de existir primeiro, em Config > Categories
Transmission, Deluge	Guardada como etiqueta
rTorrent	Guardada como etiqueta em `d.custom1`, mostrada na coluna Label do ruTorrent
NZBGet	Enviada como a categoria da transferência

Prioridade e etiquetas

A Priority (prioridade) vai de 1 a 50. O número mais baixo é usado primeiro, e números iguais alternam. Com Tags (etiquetas), só os títulos que partilham uma etiqueta usam este Gestor de transferências. Os títulos sem etiqueta usam Gestores de transferências sem etiquetas.

Caminhos

Preenche Downloader’s path (caminho do gestor de transferências) e HolyArrs’ path (caminho do HolyArrs) em Different folder names (nomes de pasta diferentes) só quando as duas apps veem a pasta de transferências com nomes diferentes. Exemplo: o Gestor de transferências guarda em /data/torrents e o HolyArrs vê-a como /downloads. Add a path pair (adicionar um par de caminhos) acrescenta outra linha.

A melhor solução é uma pasta-mãe partilhada, montada no mesmo caminho nos dois contentores. Vê Pastas.

Aceder à rede local

Ativado por predefinição, porque os Gestores de transferências costumam correr em casa. Desativa-o para um Gestor de transferências na internet.

O HolyArrs pode alterar este Gestor de transferências

Desativado quer dizer que as transferências novas continuam a ir para lá, mas o HolyArrs nunca pausa, altera nem remove nada que já lá esteja. Usa-o para um Gestor de transferências que partilhas com outras apps.

Acompanhar uma transferência

A página de um título mostra cada transferência: à espera da vez, a transferir com a velocidade e o tempo que falta, parada, ou falhada com o motivo.

Clica em Mark failed (marcar como falhada) para terminar uma transferência que não queres. O HolyArrs então:

Adiciona esse Lançamento à lista Turned down (Rejeitado) do título, para não voltar a ser escolhido.
Remove-o do Gestor de transferências, com os ficheiros.
Procura outra vez e envia o melhor Lançamento seguinte.

O rTorrent não consegue apagar ficheiros por XML-RPC, por isso o HolyArrs apaga-os ele próprio onde a pasta de gravação ou os pares de caminhos lá chegam. Caso contrário, os ficheiros ficam na máquina do rTorrent.

Se mais nenhum passar nas tuas regras, o título mostra Needs a decision (precisa de uma decisão).

Estados da linha

Estado	Significado
Working	Respondeu à última verificação
Paused (Em pausa)	Puseste em pausa. Não é enviado nada de novo; as transferências atuais continuam a ser acompanhadas
Resting (A descansar)	Não respondeu, por isso o HolyArrs espera até à hora indicada
Not answering (Sem resposta)	A última verificação não teve resposta
Sign-in refused (Início de sessão recusado)	A chave ou o início de sessão foi rejeitado

Pause (pausar) e Resume (retomar) na linha param e iniciam o envio. Um Gestor de transferências que deixa de responder é ignorado até 30 minutos.

Se não funcionar

Sintoma: O teste do SABnzbd falha quando o Address usa um nome de host. Causa: O SABnzbd recusa nomes de host que não conhece. Solução: Usa o endereço IP dele, ou adiciona o nome de host do HolyArrs a host_whitelist no SABnzbd, em Config > Special.

Sintoma: O SABnzbd diz que falta a categoria. Solução: Cria a categoria no SABnzbd, em Config > Categories, e clica em Test.

Sintoma: O Deluge não funciona. Solução: Na Deluge Web UI, liga-te tu ao teu daemon e ativa o plugin Label. O HolyArrs não escolhe um daemon.

Sintoma: O teste do rTorrent diz 404 ou não encontrado. Causa: A porta ou o caminho está errado. Com o crazymax/rtorrent-rutorrent, a 8000 é o XML-RPC e a 8080 é a página do ruTorrent. Solução: Usa http://host:8000/RPC2, ou um caminho do ruTorrent de Endereço do rTorrent.

Sintoma: O rTorrent diz not allowed for untrusted connections. Causa: O ruTorrent bloqueia um comando de que o HolyArrs precisa. Solução: Atualiza o ruTorrent, ou aponta o Address para o /RPC2 do rTorrent.

Sintoma: O rTorrent recusa um Lançamento com um erro de limite de tamanho. Solução: Aumenta network.xmlrpc.size_limit na configuração do rTorrent. No crazymax/rtorrent-rutorrent, define XMLRPC_SIZE_LIMIT.

Sintoma: Um .torrent ou .nzb de uma Fonte com proxy é recusado. Causa: O Transmission, o Deluge, o rTorrent e o NZBGet ainda não conseguem receber esses ficheiros através de uma Fonte com proxy. As ligações magnet funcionam.

Sintoma: Uma linha diz Check whether this download arrived (verifica se esta transferência chegou). Causa: A ligação caiu enquanto o Transmission, o Deluge, o rTorrent ou o NZBGet estava a receber um Lançamento. O HolyArrs não o volta a enviar sozinho. Solução:

Procura a transferência na app do Gestor de transferências.
No HolyArrs, clica em Give up on it (desistir). A transferência fica no Gestor de transferências. Escolhe outro Lançamento em Needs a decision se quiseres.

Sintoma: Sign-in refused. Solução: Copia a chave ou a palavra-passe do Gestor de transferências, escreve-a outra vez e clica em Test.

Mais em Resolução de problemas.

Para especialistas

Como o HolyArrs escolhe um Gestor de transferências

Os Lançamentos de torrent vão para Gestores de transferências de torrent, os de Usenet para os de Usenet.
Primeiro o número de prioridade mais baixo. Números iguais alternam.
Os Gestores de transferências em pausa e a descansar são ignorados.
Se um recusar um Lançamento, tenta-se o seguinte do mesmo tipo (Try the next Downloader).
Os envios para um Gestor de transferências são espaçados 2 s por predefinição.
As etiquetas têm de corresponder. Os títulos sem etiqueta vão para Gestores de transferências sem etiquetas.

Quando as transferências correm mal: o que conta, e as definições

O HolyArrs trata isto como Mark failed:

O Gestor de transferências desiste (partes em falta, reparação falhada). O motivo dele é mostrado.
A transferência contém programas como .exe, .bat, .scr ou .lnk, incluindo movie.mkv.exe.
A transferência parece falsa: uma nota com palavra-passe, só ficheiros comprimidos sem vídeo nem áudio, ou um atalho web sem multimédia ao lado. As listas de ficheiros dos torrents são lidas assim que chegam, por isso um falso falha antes de transferir.
Os ficheiros não correspondem ao nome do Lançamento. A importação é recusada e a transferência removida.
Nenhum progresso durante o tempo de desistência. À espera da vez, em pausa no Gestor de transferências, e a reparar ou descomprimir a 100% não contam.
A transferência foi removida fora do HolyArrs. É substituída pelo Lançamento seguinte.

Estas definições ficam em When downloads go wrong (quando as transferências correm mal) em Settings > Downloaders. Clica em Save na barra que aparece depois de uma alteração.

Definição	Predefinição	Altera quando
Remove failed downloads from the Downloader	ativada	Queres inspecionar as falhas (desativada). Ativada também apaga os ficheiros delas
Add matched titles to your Library	desativada	Queres que uma correspondência certa que já está num Gestor de transferências seja adicionada sem pesquisar
When you remove a download: Delete its files	ativada	Queres manter os ficheiros
When you remove a download: Turn down its Release	desativada	Nunca queres que esse Lançamento volte a ser escolhido para o título
When you remove a download: Search again	ativada	Desativada se escolheres tu o Lançamento seguinte. Precisa de Turn down its Release
Stalled after (hours)	6	As tuas transferências são lentas por natureza. Intervalo de 1 a 168
Try the next Release after (hours)	24	Preferes esperar a substituir. Conta desde o último progresso. Intervalo: o tempo de parada até 720
Fail downloads that hold programs or fakes	ativada	Raramente. Desativada deixa-os chegar à importação
Replace downloads removed outside HolyArrs	ativada	Removes transferências de propósito. Desativada faz o título esperar por ti
Try the next Downloader	ativada	Queres só um Gestor de transferências
Seconds between sends to one Downloader	2	O Gestor de transferências engasga com rajadas. 0 desliga o espaçamento. Intervalo de 0 a 60

Bloquear um Gestor de transferências só de leitura a partir do servidor

Define HOLYARRS_READONLY_DOWNLOADERS com uma lista separada por vírgulas de ids ou endereços de Gestores de transferências:

HOLYARRS_READONLY_DOWNLOADERS=http://your-server:8080

Um Gestor de transferências da lista fica só de leitura, diga o que disser o interruptor dele, mesmo depois de remover e voltar a adicionar. O interruptor aparece bloqueado, e a página Transferências esconde os controlos nas linhas dele.

Remover, remoções no NZBGet, API

Remove (remover) é recusado enquanto o Gestor de transferências tiver transferências ativas. Põe-no em pausa, deixa-as acabar e depois remove.
O NZBGet apaga os ficheiros sempre que uma transferência ou a entrada dela no histórico é removida, por isso o HolyArrs recusa remoções que peçam para manter os ficheiros.
O rTorrent não consegue apagar dados por XML-RPC. Quando uma remoção pede para apagar ficheiros, o HolyArrs apaga-os ele próprio onde a pasta de gravação ou os pares de caminhos lá chegam. Caso contrário, os ficheiros ficam na máquina do rTorrent e o HolyArrs regista o motivo.
Em Downloads, uma linha do rTorrent oferece Pause e Resume, mas não os outros controlos do qBittorrent.
Todas as rotas de Gestores de transferências estão em http://your-server:6262/api/v1/openapi.json.

Relacionado

O HolyArrs é gratuito. Se te poupou tempo, dá-lhe uma estrela no GitHub, patrocina-o ou oferece-me um café.