--- title: "Bibliotecas externas e ferramentas de terceiros" description: "Porque é que as bibliotecas externas não estão disponíveis na PixelUnion, que alternativas usar e o que esperar das ferramentas de terceiros para o Immich" url: "https://pixelunion.eu/pt/help/immich/external-libraries-and-tools/" weight: 11 --- 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](/pt/help/migrating/migrate-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](/pt/help/immich/mobile-app/). - **A interface web**: arraste e largue ficheiros ou pastas no seu navegador. Consulte [Fazer Upload de Fotos](/pt/help/immich/uploading-photos/). 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](/pt/help/migrating/migrate-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](/pt/help/other/data-backups/). 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](/pt/help/immich/download-photos-videos/). 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](/pt/support/) e ajudamos a verificar.