Importar de outras apps

Traz a configuração das tuas apps anteriores para o HolyArrs sem a escreveres outra vez.

O HolyArrs só lê as apps anteriores. Nada muda nelas e os teus ficheiros multimédia nunca saem do sítio.

Antes de começares

• Inicia sessão como proprietário ou administrador.
• Tem à mão o endereço e a chave de API de cada app anterior.
• Garante que o HolyArrs consegue ver as tuas pastas multimédia. Vê Pastas e hardlinks.

Importa a tua configuração

1. Abre Settings > Import from other apps (Definições > Importar de outras apps). Deves ver quatro passos numa linha no topo.
2. Read your apps (ler as suas apps): clica em Add an app (adicionar uma app) para cada app anterior. Deves ver cada app na lista, com um interruptor.
3. What to import (o que importar): ativa os grupos que queres trazer.
4. Import (importar): o HolyArrs verifica primeiro o que vai ser adicionado. Ainda nada muda. Responde a cada linha em Needs a choice (precisa de uma escolha) e depois clica em Import e confirma. Podes sair da página enquanto corre.
5. Done (concluído): deves ver os resultados por grupo e Undo this import (desfazer esta importação).

As chaves e as palavras-passe nunca vêm. Vê Depois da importação.

Ordem a seguir

Ordem	App	Porquê esta ordem
1	Radarr, Sonarr	Primeiro vêm as pastas da Biblioteca e os títulos. Vê Sonarr e Radarr.
2	Lidarr, Prowlarr, Bazarr	Música, Fontes e idiomas das legendas. Vê Lidarr, Bazarr e Prowlarr.
3	qBittorrent, SABnzbd	Gestores de transferências. Lê-os na mesma importação das apps acima.
4	Seerr, Overseerr	Pessoas e pedidos, associados aos títulos que já estão aqui. Vê Apps de pedidos.

Podes ler todas as apps e importá-las de uma vez. A ordem só conta se importares por lotes.

Depois da importação

Cada item abaixo chega em pausa ou desativado. Escreve o segredo, confirma e ativa.

Item	Onde	O que fazer
Fontes	Settings > Sources	Escreve a chave e retoma.
Gestores de transferências	Settings > Downloaders	Escreve a palavra-passe ou a chave e retoma.
Avisos	Settings > Alerts	Escreve a ligação ou a palavra-passe do email e ativa.
Listas externas	Settings > Outside lists	Confirma a pasta e as Regras de escolha e ativa. Uma lista do Trakt precisa primeiro da tua chave do Trakt.
Pessoas	Settings > Users and roles	Envia os convites.

Uma Fonte, um gestor de transferências ou um aviso que tinha etiquetas na app anterior passa a servir todos os títulos do seu tipo. Confirma antes de ativar.

As Fontes e os gestores de transferências chegam com May reach the local network desativado. Ativa-o só para um que esteja na tua rede de casa. As ligações locais (link-local) e os endereços de metadados da cloud ficam sempre bloqueados.

Para escrever muitas chaves de uma vez, vê Importar chaves de um ficheiro.

O que fica para trás

• Ficheiros multimédia. A importação nunca move, renomeia, copia nem apaga um ficheiro.
• Chaves, palavras-passe, tokens e cookies. O passo Import e o relatório listam cada um em Keys to type again.
• Definições sem equivalente aqui. Cada uma aparece na lista not imported com o motivo.
• Histórico. O histórico das apps anteriores não é lido. A pessoa que pediu um título vem na mesma.

Se não funcionar

Sintoma	Causa	Solução
Os títulos aparecem como não encontrados	A pasta deles não corresponde a nenhuma pasta da Biblioteca aqui.	Adiciona uma regra de caminho em Advanced dentro de What to import e importa outra vez.
A importação diz que algo mudou	Algo mudou desde a verificação.	O HolyArrs verifica outra vez sozinho. Revê a lista e depois importa.
O botão Import está desativado	Uma pessoa precisa de uma escolha, ou o HolyArrs está em modo de segurança.	Lê o texto ao lado do botão.
Alguns itens falharam	Por exemplo, o servidor de metadados estava em baixo.	Espera e importa outra vez. As chaves das tuas apps anteriores ficam guardadas.

Para especialistas

Importar outra vez, desfazer, partes e modo de segurança

Importar outra vez. Uma importação lembra-se do que adicionou. Ao importar de novo, só adiciona o que é novo e diz already here (já está aqui) para o resto. Corre uma importação ou um desfazer de cada vez. Se o HolyArrs parar a meio de uma importação, esta fica marcada como falhada no arranque seguinte, ou retoma se a tarefa ainda estiver na fila. Nunca bloqueia a importação seguinte.

Earlier imports (importações anteriores), por baixo das leituras, lista todas as importações e o seu estado. Open (abrir) mostra uma importação no passo 4, ou no passo 3 enquanto corre.

Desfazer. Clica em Undo this import no passo 4 (numa importação mais antiga, faz primeiro Open). O desfazer corre em segundo plano e remove só o que essa importação adicionou, das mais recentes para as mais antigas:

• os títulos saem da Biblioteca; os ficheiros deles ficam onde estão,
• as Fontes, os gestores de transferências, os avisos, os sites de legendas, as pessoas, os pedidos e as entradas da Lista de nunca adicionar que adicionou são removidos,
• as Listas externas que adicionou são removidas se ainda estiverem em pausa,
• a nomenclatura, os idiomas de legendas predefinidos e as esperas nas Regras de escolha voltam ao que eram.

O que configuraste ou alteraste depois da importação fica, e o relatório do desfazer lista-o: um segredo que escreveste, uma pessoa ou Lista externa que ativaste, nomenclatura, idiomas ou esperas que alteraste. As pastas da Biblioteca que tinham títulos ficam, porque os títulos removidos mantêm o seu Histórico.

Partes. Uma Parte desativada fica de fora. Filmes desativados: sem pasta de filmes, sem filmes e sem Listas externas de filmes. Legendas desativadas: sem definições de legendas. Pedidos desativados: sem pedidos.

Modo de segurança. Podes ler as tuas apps e escolher o que importar, mas não importar nem desfazer.

API

As chaves de API precisam do âmbito admin.

Rota	O que faz
POST /api/v1/migrate/plan	O plano para as leituras escolhidas, com contagens e regras de caminho sugeridas.
POST /api/v1/migrate/dry-run	O relatório do teste e o seu plan_hash. Nada muda. Uma pessoa que precisa de uma escolha tem choose definido como same_name, numeric_id ou merge_gone.
POST /api/v1/migrate/moves	Inicia uma importação. Precisa do plan_hash do teste. Responde 409 quando o plano mudou.
GET /api/v1/migrate/moves	Lista as importações, das mais recentes para as mais antigas.
GET /api/v1/migrate/moves/{id}	Uma importação, o seu relatório e o progresso.
GET /api/v1/migrate/moves/{id}/report	O relatório como ficheiro Markdown.
POST /api/v1/migrate/moves/{id}/undo	Põe o desfazer na fila (202). Acompanha-o com GET /api/v1/migrate/moves/{id}.

Corpo de plan, dry-run e moves (moves também aceita "plan_hash"):

{
  "snapshots": [1, 2],
  "path_rules": [{"from": "/data/media/movies", "to": "/movies"}],
  "skip": ["alerts"],
  "people": {"person:seerr:1": "owner", "person:seerr:3": "admin", "person:seerr:2": "merge"}
}

A escolha para uma pessoa é owner (só o proprietário da app anterior), admin, merge ou skip. Grupos que podes saltar: folders, pick_rules, titles, never_add, outside_lists, sources, downloaders, naming, subtitles, people, wishlist, alerts.

Páginas desta secção

Página	Usa-a para
Sonarr e Radarr	Trazer pastas, séries, filmes e as suas regras. Faz isto primeiro.
Lidarr, Bazarr e Prowlarr	Trazer música, idiomas de legendas e Fontes.
Seerr e Overseerr	Trazer pessoas e pedidos em aberto.
Ler as tuas apps anteriores	Ver exatamente o que o HolyArrs lê e guarda.
Importar chaves de um ficheiro	Escrever muitas chaves de uma vez.

Relacionado

• Primeira execução
• Glossário