Descarregar Todas as Fotos e Vídeos

Podes descarregar toda a tua biblioteca de fotos e vídeos da PixelUnion para o teu próprio computador. É útil quando queres:

• Manter uma cópia local dos teus ficheiros além da biblioteca PixelUnion
• Descarregar os teus dados antes de eliminares a conta
• Transferir a tua biblioteca para outro serviço
• Ter uma cópia offline das tuas memórias

Existem duas ferramentas para isto:

• immich-archiver é desenvolvida e mantida pela PixelUnion. Usa-a para uma cópia simples de toda a tua 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 começa por aí.

Passo 1: obtém a tua chave de API

1. Inicia sessão no teu domínio PixelUnion (por exemplo, https://oteunome.pixelunion.eu)
2. Clica no ícone do teu perfil no canto superior direito
3. Seleciona Definições da conta
4. Vai a Chaves de API
5. Clica em Nova chave de API
6. Dá-lhe um nome descritivo (por exemplo, “Ferramenta de descarga”)
7. Copia a chave de API gerada, vais precisar dela no passo seguinte

⚠️ Importante: mantém a tua chave de API em segurança e não a partilhes com ninguém. Podes revogá-la mais tarde, se for preciso.

immich-archiver (recomendada)

O immich-archiver copia cada foto e vídeo da tua linha temporal para pastas por data no teu 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 executares de novo mais tarde, só descarrega o que é novo, por isso manter a tua cópia atualizada é rápido.

Passo 2: descarrega o immich-archiver

1. Vai à página de versões do immich-archiver
2. Descarrega o ficheiro para o teu 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. Move o ficheiro descarregado para a pasta onde queres a tua cópia de segurança
4. Muda-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 atualizares 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 tens de tornar o ficheiro executável uma vez. Abre um terminal nessa pasta e executa:

chmod +x immich-archiver

Passo 3: executa-a

Abre um terminal na pasta que contém o ficheiro:

• Windows: clique direito na pasta → “Abrir no terminal”
• macOS: abre a aplicação Terminal, escreve cd seguido de um espaço, arrasta a pasta para a janela e prime Enter
• Linux: abre um terminal e navega até à pasta

Depois executa a ferramenta, substituindo os valores pelos teus:

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

Substitui oteunome.pixelunion.eu pelo teu domínio e A_TUA_CHAVE_API pela chave do passo 1.

Para não escreveres a chave de cada vez, podes 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

Executa a ferramenta com --help para veres 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. Vai à página de versões do Immich Go
2. Descarrega a versão para o teu sistema operativo:
   • Windows: descarrega o ficheiro .exe
   • macOS: descarrega o ficheiro com darwin no nome
   • Linux: descarrega o ficheiro com linux no nome
3. Extrai o ficheiro .zip descarregado
4. Coloca o executável immich-go numa pasta onde queiras descarregar as tuas fotos

Executa 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

Substitui:

• oteunome.pixelunion.eu pelo teu domínio PixelUnion real
• A_TUA_CHAVE_API pela chave de API que copiaste no passo 1
• ./PixelUnion-Backup pelo caminho onde queres guardar as tuas 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

• Confirma que o teu domínio PixelUnion está correto e inclui https://
• Verifica que a tua chave de API está correta e não foi revogada
• Verifica a tua ligação à internet

“Permission denied” no macOS ou Linux

• Tens de tornar o ficheiro executável primeiro: chmod +x immich-archiver

Descarga interrompida

• Ambas as ferramentas continuam de onde pararam se voltares 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
• Certifica-te de que o computador não entra em suspensão durante a descarga
• Considera deixar a descarga a correr durante a noite

Depois da descarga

Quando a descarga terminar:

• As tuas fotos e vídeos estão na pasta que indicaste
• Os ficheiros mantêm os nomes e datas originais
• Podes guardar estes ficheiros noutro lado ou transferi-los

Vale a pena verificares a tua cópia antes de confiares nela. Abre a pasta e confirma que algumas fotos abrem mesmo.

Precisas de ajuda?

Se tiveres problemas:

• Para o immich-archiver, consulta a página do projeto no GitHub
• Para o Immich Go, consulta a documentação do Immich Go
• Contacta a nossa equipa de apoio para obteres ajuda