Descarregar Todas as Fotos e Vídeos
Descarregue toda a sua biblioteca PixelUnion para o seu computador com o immich-archiver ou o Immich Go
Pode descarregar toda a sua biblioteca de fotos e vídeos da PixelUnion para o seu próprio computador. É útil quando quer:
- Manter uma cópia local dos seus ficheiros além da biblioteca PixelUnion
- Descarregar os seus dados antes de eliminar a conta
- Transferir a sua biblioteca para outro serviço
- Ter uma cópia offline das suas memórias
Existem duas ferramentas para isto:
- immich-archiver é desenvolvida e mantida pela PixelUnion. Use-a para uma cópia simples de toda a sua biblioteca. É a que recomendamos.
- Immich Go é uma ferramenta da comunidade com mais opções de filtragem, como descarregar apenas determinados álbuns, etiquetas ou um intervalo de datas. Está atualmente afetada por um bug, descrito mais abaixo.
Ambas as ferramentas precisam de uma chave de API, por isso comece por aí.
Passo 1: obtenha a sua chave de API
- Inicie sessão no seu domínio PixelUnion (por exemplo,
https://oteunome.pixelunion.eu) - Clique no ícone do seu perfil no canto superior direito
- Selecione Definições de Conta
- Vá a Chaves de API
- Clique em Nova Chave de API
- Dê-lhe um nome descritivo (por exemplo, “Ferramenta de descarga”)
- Copie a chave de API gerada, vai precisar dela no passo seguinte
⚠️ Importante: mantenha a sua chave de API em segurança e não a partilhe com ninguém. Pode revogá-la mais tarde, se for preciso.
immich-archiver (recomendada)
O immich-archiver copia cada foto e vídeo da sua linha temporal para pastas por data no seu disco, e escreve ao lado de cada ficheiro um .json com todos os metadados que temos: data de captura, câmara, localização GPS, pertença a álbuns, rostos e classificações.
No disco fica assim:
PixelUnion-Backup/2005/2005-06/IMG_0001.jpg
PixelUnion-Backup/2005/2005-06/IMG_0001.jpg.json
Se a executar de novo mais tarde, só descarrega o que é novo, por isso manter a sua cópia atualizada é rápido.
Passo 2: descarregue o immich-archiver
- Vá à página de versões do immich-archiver
- Descarregue o ficheiro para o seu sistema:
- Windows:
immich-archiver_..._windows_amd64.exe - macOS (Apple Silicon):
immich-archiver_..._darwin_arm64 - macOS (Intel):
immich-archiver_..._darwin_amd64 - Linux:
immich-archiver_..._linux_amd64(oulinux_arm64num Raspberry Pi ou semelhante)
- Windows:
- Mova o ficheiro descarregado para a pasta onde quer a sua cópia de segurança
- Mude-lhe o nome para
immich-archiver(no Windows,immich-archiver.exe). O nome descarregado inclui o número da versão, e mudá-lo mantém os comandos abaixo iguais quando atualizar mais tarde.
As versões para macOS estão assinadas e notarizadas junto da Apple, por isso são executadas sem aviso de segurança.
No macOS e Linux tem de tornar o ficheiro executável uma vez. Abra um terminal nessa pasta e execute:
chmod +x immich-archiver
Passo 3: execute-a
Abra um terminal na pasta que contém o ficheiro:
- Windows: clique direito na pasta → “Abrir no terminal”
- macOS: abra a aplicação Terminal, escreva
cdseguido de um espaço, arraste a pasta para a janela e prima Enter - Linux: abra um terminal e navegue até à pasta
Depois execute a ferramenta, substituindo os valores pelos seus:
Windows:
.\immich-archiver.exe --url https://oteunome.pixelunion.eu --api-key A_TUA_CHAVE_API --dir .\PixelUnion-Backup
macOS/Linux:
./immich-archiver --url https://oteunome.pixelunion.eu --api-key A_TUA_CHAVE_API --dir ./PixelUnion-Backup
Substitua oteunome.pixelunion.eu pelo seu domínio e A_TUA_CHAVE_API pela chave do passo 1.
Para não escrever a chave de cada vez, pode defini-las como variáveis de ambiente: IMMICH_URL, IMMICH_API_KEY e IMMICH_DIR. Com essas definidas, basta executar immich-archiver sozinho.
Opções úteis
| Opção | O que faz |
|---|---|
--dry-run | Mostra o que seria descarregado sem guardar nada |
--verbose | Imprime uma linha por ficheiro em vez de um contador |
--path-template "{year}/{month}/{day}" | Muda a estrutura de pastas. Por predefinição é {year}/{year}-{month} |
--include-shared | Descarrega também os álbuns que outras pessoas partilham consigo, numa pasta separada shared-with-me |
--concurrency 8 | Descarrega mais ficheiros ao mesmo tempo. Por predefinição são 4 |
--retries 5 | Repete mais vezes as descargas falhadas. Por predefinição são 3 |
Execute a ferramenta com --help para ver tudo o que suporta.
Immich Go (para filtragem avançada)
O Immich Go é uma ferramenta de linha de comandos criada pela comunidade. Oferece filtros que o immich-archiver ainda não tem, como limitar a descarga a determinados álbuns, etiquetas ou a um intervalo de datas.
Descarregar o Immich Go
- Vá à página de versões do Immich Go
- Descarregue a versão para o seu sistema operativo:
- Windows: descarregue o ficheiro
.exe - macOS: descarregue o ficheiro com
darwinno nome - Linux: descarregue o ficheiro com
linuxno nome
- Windows: descarregue o ficheiro
- Extraia o ficheiro
.zipdescarregado - Coloque o executável
immich-gonuma pasta onde queira descarregar as suas fotos
Execute o comando de descarga
Windows:
./immich-go.exe archive from-immich --from-server=https://oteunome.pixelunion.eu/ --from-api-key=A_TUA_CHAVE_API --write-to-folder=./PixelUnion-Backup
macOS/Linux:
./immich-go archive from-immich --from-server=https://oteunome.pixelunion.eu/ --from-api-key=A_TUA_CHAVE_API --write-to-folder=./PixelUnion-Backup
Substitua:
oteunome.pixelunion.eupelo seu domínio PixelUnion realA_TUA_CHAVE_APIpela chave de API que copiou no passo 1./PixelUnion-Backuppelo caminho onde quer guardar as suas fotos
Nota: a opção --write-to-folder é obrigatória.
Opções de filtragem do Immich Go
Descarregar apenas fotos (ignorar vídeos)
./immich-go archive from-immich --from-server=https://oteunome.pixelunion.eu/ --from-api-key=A_TUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-include-type=IMAGE
Descarregar apenas vídeos (ignorar fotos)
./immich-go archive from-immich --from-server=https://oteunome.pixelunion.eu/ --from-api-key=A_TUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-include-type=VIDEO
Descarregar apenas fotos favoritas
./immich-go archive from-immich --from-server=https://oteunome.pixelunion.eu/ --from-api-key=A_TUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-favorite
Descarregar fotos de álbuns específicos
./immich-go archive from-immich --from-server=https://oteunome.pixelunion.eu/ --from-api-key=A_TUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-albums="Nome do álbum 1" --from-albums="Nome do álbum 2"
Descarregar fotos com etiquetas específicas
./immich-go archive from-immich --from-server=https://oteunome.pixelunion.eu/ --from-api-key=A_TUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-tags="tag1" --from-tags="tag2"
Descarregar fotos de um intervalo de datas
./immich-go archive from-immich --from-server=https://oteunome.pixelunion.eu/ --from-api-key=A_TUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-date-range="2024-01-01,2024-12-31"
Resolução de problemas
Problemas de ligação
- Confirme que o seu domínio PixelUnion está correto e inclui
https:// - Verifique que a sua chave de API está correta e não foi revogada
- Verifique a sua ligação à internet
“Permission denied” no macOS ou Linux
- Tem de tornar o ficheiro executável primeiro:
chmod +x immich-archiver
Descarga interrompida
- Ambas as ferramentas continuam de onde pararam se voltar a executar o comando
- Ficheiros já descarregados não são obtidos uma segunda vez
Bibliotecas grandes
- Em bibliotecas muito grandes (milhares de ficheiros), a descarga pode demorar várias horas
- Certifique-se de que o computador não entra em suspensão durante a descarga
- Considere deixar a descarga a correr durante a noite
Depois da descarga
Quando a descarga terminar:
- As suas fotos e vídeos estão na pasta que indicou
- Os ficheiros mantêm os nomes e datas originais
- Pode guardar estes ficheiros noutro lado ou transferi-los
Vale a pena verificar a sua cópia antes de confiar nela. Abra a pasta e confirme que algumas fotos abrem mesmo.
Precisa de ajuda?
Se tiver problemas:
- Para o immich-archiver, consulte a página do projeto no GitHub
- Para o Immich Go, consulte a documentação do Immich Go
- Contacte a nossa equipa de apoio para obter ajuda