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

  1. Inicie sessão no seu domínio PixelUnion (por exemplo, https://oteunome.pixelunion.eu)
  2. Clique no ícone do seu perfil no canto superior direito
  3. Selecione Definições de Conta
  4. Vá a Chaves de API
  5. Clique em Nova Chave de API
  6. Dê-lhe um nome descritivo (por exemplo, “Ferramenta de descarga”)
  7. 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

  1. Vá à página de versões do immich-archiver
  2. 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 (ou linux_arm64 num Raspberry Pi ou semelhante)
  3. Mova o ficheiro descarregado para a pasta onde quer a sua cópia de segurança
  4. 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 cd seguido 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çãoO que faz
--dry-runMostra o que seria descarregado sem guardar nada
--verboseImprime 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-sharedDescarrega também os álbuns que outras pessoas partilham consigo, numa pasta separada shared-with-me
--concurrency 8Descarrega mais ficheiros ao mesmo tempo. Por predefinição são 4
--retries 5Repete 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

  1. Vá à página de versões do Immich Go
  2. Descarregue a versão para o seu sistema operativo:
    • Windows: descarregue o ficheiro .exe
    • macOS: descarregue o ficheiro com darwin no nome
    • Linux: descarregue o ficheiro com linux no nome
  3. Extraia o ficheiro .zip descarregado
  4. Coloque o executável immich-go numa 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.eu pelo seu domínio PixelUnion real
  • A_TUA_CHAVE_API pela chave de API que copiou no passo 1
  • ./PixelUnion-Backup pelo 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:

Was this article helpful? Let us know
Última atualização: 13 de novembro de 2026