Pastas da Biblioteca

Configuração

Diz ao HolyArrs onde vivem os teus filmes, séries e música terminados.

Precisas da permissão Change settings (Alterar definições). A configuração da primeira execução adiciona uma pasta; adiciona as restantes aqui.

Antes de começares

A pasta existe e o HolyArrs consegue escrever nela.
No Docker, sabes o caminho dentro do contentor, como /movies. O caminho do host não funciona.

Adicionar uma pasta

Abre Settings > Library folders (Definições > Pastas da Biblioteca).
Clica em Add a folder (Adicionar uma pasta). O cartão Add a Library folder (Adicionar uma pasta da Biblioteca) abre-se.
Em Holds (Contém), escolhe Movies (Filmes), Shows (Séries) ou Music (Música).
Escreve o caminho completo, como o HolyArrs o vê, em Folder path (Caminho da pasta).
Escreve um Name (Nome), ou deixa vazio para usar a última parte do caminho, como movies.
Clica em Add (Adicionar). Deves ver a pasta no seu grupo, com o espaço livre e um estado de saúde.

O que a verificação te diz

A verificação confirma que a pasta existe, escreve e remove um pequeno ficheiro de teste, tenta um hardlink a partir de cada pasta de gestor de transferências ativo e procura pelo menos 100 MB livres. O botão de atualizar numa linha volta a executá-la.

Um hardlink é um segundo nome para o mesmo ficheiro no mesmo disco. É instantâneo e não usa espaço extra.

Estado mostrado	Significado	Importações
Healthy (Saudável)	Todas as verificações passaram	Movimentos instantâneos
Folder not found (Pasta não encontrada) ou Cannot write here (Não é possível escrever aqui)	A pasta desapareceu ou não tem permissão de escrita	Paradas até resolveres
Works, but files are copied (no hardlinks) (Funciona, mas os ficheiros são copiados, sem hardlinks)	As transferências estão noutro disco ou montagem	Funcionam, mas copiam o ficheiro: mais lentas, e o dobro do espaço até o gestor de transferências apagar a sua cópia

Menos de 100 MB livres acrescenta uma nota de pouco espaço. As importações funcionam até o disco encher.

Mudar o nome ou remover uma pasta

Rename (Mudar o nome) altera o nome que vês. Nada se move no disco.

O botão do lixo remove a pasta do HolyArrs e deixa todos os ficheiros no lugar. O HolyArrs recusa enquanto houver títulos na Biblioteca a usar a pasta. Move primeiro esses títulos. Os títulos que apagaste da Biblioteca não contam. Ficam no Histórico.

O HolyArrs também mantém a pasta enquanto os ficheiros apagados que ela contém ainda puderem ser restaurados em Recently deleted (apagados recentemente). Remove-a quando os dias de retenção deles passarem, ou apaga a pasta .holyarrs-replaced dela no disco. Uma pasta que já não existe no disco não tem nada para restaurar, por isso pode sempre ser removida quando nenhum título da Biblioteca a usar.

Se não funcionar

Sintoma: o estado diz que os ficheiros são copiados (sem hardlinks). Causa: as transferências e os ficheiros multimédia estão em montagens separadas. Solução: monta uma pasta-mãe partilhada que contenha ambos, no mesmo caminho em todos os contentores.

Sintoma: a importação diz que o caminho não é permitido. Causa: o caminho está fora de todos os locais permitidos (vê Extra import folders mais abaixo). A mensagem indica os locais permitidos. Os caminhos com .., as partilhas de rede como \\server\share, e as ligações ou junções que levam para fora também são recusados.

Sintoma: a importação não vê a pasta de transferências. Causa: HOLYARRS_SAVE_PATH não está definido e nenhum gestor de transferências tem um par de caminhos. Solução: define HOLYARRS_SAVE_PATH, ou adiciona a pasta de transferências, como /downloads, em Extra import folders (Pastas de importação extra).

Sintoma: não consigo remover uma pasta. Solução: move primeiro os seus títulos para outra pasta. Se disser que ainda se podem restaurar ficheiros apagados, espera que os dias de retenção deles passem, ou apaga a pasta .holyarrs-replaced da pasta no disco. Se uma lista externa adicionar a ela, aponta essa lista para outra pasta.

Para especialistas

Regras das pastas

Uma pasta da Biblioteca tem de existir, ser uma pasta, ser um caminho completo, ter permissão de escrita e não estar dentro nem à volta de outra pasta da Biblioteca. Cada tipo (Movies, Shows, Music) usa as suas próprias pastas.

Pastas de importação extra

Library > Import files by hand (Biblioteca > Importar ficheiros à mão) lê, copia e move ficheiros apenas dentro de:

as tuas pastas da Biblioteca,
as pastas onde os teus gestores de transferências guardam, como o HolyArrs as vê: HOLYARRS_SAVE_PATH e o lado do HolyArrs de cada par de caminhos do gestor de transferências,
as Extra import folders em Settings > Library folders.

Escreve um caminho completo por linha, como /imports ou D:\Imports. Até 32. Um disco inteiro como / ou C:\ é recusado.

Só o proprietário, ou um administrador com sessão iniciada com palavra-passe, pode alterar a lista. Uma chave de API também precisa do âmbito admin. Os outros veem Owner and admins only (Só proprietário e administradores).

Relacionado

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