Bibliotecas externas e ferramentas de terceiros

Se já geriu o Immich por conta própria, pode estar habituado a funcionalidades que dependem do acesso direto ao servidor, como bibliotecas externas ou ferramentas que se ligam à base de dados do Immich. Como a PixelUnion é um serviço gerido, algumas delas funcionam de forma diferente. Este artigo explica o que é e o que não é possível.

As bibliotecas externas não estão disponíveis

Numa instalação do Immich alojada por conta própria, uma biblioteca externa permite que o Immich leia fotos de uma pasta que já existe no servidor ou numa unidade montada, por exemplo uma pasta partilhada de um NAS. O Immich indexa esses ficheiros onde estão, sem os copiar para o seu próprio armazenamento.

Esta funcionalidade não está disponível na PixelUnion. O seu ambiente PixelUnion é executado no nosso centro de dados e não tem acesso a pastas no seu próprio computador ou NAS. Pelo mesmo motivo, o endpoint da API /api/library, que gere as bibliotecas externas, está desativado.

Em vez disso, todas as fotos e vídeos na PixelUnion ficam numa biblioteca gerida normal: os ficheiros são carregados para o seu ambiente e armazenados pela PixelUnion. Isto também significa que tem controlo total sobre tudo o que lá está. Pode editar, mover para o lixo e eliminar qualquer foto, o que não é possível com os ficheiros só de leitura de uma biblioteca externa.

Alternativas

Para colocar fotos de uma pasta ou NAS na PixelUnion, faça o upload delas:

• Immich Go: uma ferramenta de linha de comandos que carrega uma pasta inteira de uma só vez. Se a executar novamente mais tarde, só carrega os ficheiros novos. Exemplo:

  ./immich-go upload from-folder --server=https://yourname.pixelunion.eu --api-key=YOUR_API_KEY /path/to/your/photos
  

  Consulte Migrar de outro servidor Immich para saber como descarregar o Immich Go e criar uma chave de API.

• A aplicação móvel: faça automaticamente a cópia de segurança do rolo da câmara do seu telemóvel e de outras pastas. Consulte Aplicação Móvel.

• A interface web: arraste e largue ficheiros ou pastas no seu navegador. Consulte Fazer Upload de Fotos.

Já tem o seu próprio servidor Immich com uma biblioteca externa? Pode mover essa biblioteca para a PixelUnion com o Immich Go, consulte Migrar de outro servidor Immich.

Utilizar a API do Immich e ferramentas de terceiros

Pode utilizar a API do Immich com as suas próprias chaves de API, por isso a maioria das ferramentas baseadas na API funciona com a PixelUnion. Crie uma chave de API em Definições da conta → Chaves de API. Apenas dois endpoints estão desativados: /api/library (bibliotecas externas) e /api/system-config (configuração do servidor).

Algumas ferramentas de terceiros precisam de mais do que a API. Ligam-se diretamente à base de dados do Immich ou leem o sistema de ficheiros do servidor. A PixelUnion não disponibiliza acesso direto a nenhum dos dois, por isso essas ferramentas, ou as funcionalidades que dependem disso, não vão funcionar.

O Immich Power Tools é um exemplo: várias das suas funcionalidades consultam diretamente a base de dados do Immich. As funcionalidades que usam apenas a API podem funcionar, mas conte com que parte da ferramenta não esteja disponível.

Antes de confiar numa ferramenta de terceiros, consulte a respetiva documentação para verificar se precisa de uma ligação à base de dados ou de acesso ao sistema de ficheiros.

Remover duplicados sem ferramentas adicionais

O Immich tem deteção de duplicados integrada. Na interface web, vá a Utilitários → Rever duplicados para comparar fotos semelhantes lado a lado e escolher quais quer manter. Os duplicados são detetados por utilizador, por isso as fotos carregadas por dois utilizadores diferentes não são comparadas entre si.

Manter a estrutura dos seus álbuns numa cópia local

Os seus dados têm cópia de segurança feita pela PixelUnion, consulte Como fazemos backup dos seus dados. Se também quiser a sua própria cópia local, tenha em conta que muitas ferramentas de download guardam os ficheiros em si, mas não os álbuns a que pertencem.

Existem algumas formas de manter os seus álbuns:

1. immich-archiver: a nossa própria ferramenta de download escreve um ficheiro .json ao lado de cada foto e vídeo, que inclui os álbuns a que pertence. Consulte Descarregar Todas as Fotos e Vídeos.
2. Descarregar por álbum: abra um álbum na interface web e descarregue-o. Obtém um ficheiro ZIP com todas as fotos e vídeos desse álbum, mas sem informação do álbum para além da própria pasta.
3. Utilizar a API: a API do Immich devolve todos os seus álbuns e as fotos de cada álbum, por isso pode escrever o seu próprio script se precisar de outra estrutura.

Precisa de ajuda?

Não tem a certeza se uma ferramenta ou um fluxo de trabalho vai funcionar com a PixelUnion? Contacte a nossa equipa de suporte e ajudamos a verificar.