Transferir Todas as Fotos e Vídeos

Immich Go é uma ferramenta poderosa que permite transferir toda a sua biblioteca de fotos e vídeos PixelUnion para o seu computador. Isso é especialmente útil quando você quer:

• Criar um backup local dos seus ficheiros de mídia
• Transferir seus dados antes de excluir sua conta
• Transferir sua biblioteca para outro serviço
• Manter uma cópia offline das suas memórias

O que é Immich Go?

Immich Go é uma ferramenta de linha de comando que se conecta à sua instância PixelUnion e baixa todas as suas fotos e vídeos preservando:

• Nomes de ficheiro originais
• Datas de criação e metadados
• Estruturas de álbuns
• Ficheiros de vídeo

Passo 1: obtenha Sua Chave de API

Antes de poder usar Immich Go, você precisa gerar uma chave de API da sua conta PixelUnion:

1. Faça login no seu domínio PixelUnion (ex. https://seunome.pixelunion.eu)
2. Clique no ícone do seu perfil no canto superior direito
3. Selecione Configurações da conta
4. Navegue até Chaves de API
5. Clique em Nova chave de API
6. Dê um nome descritivo (ex. “Ferramenta de download”)
7. Copie a chave de API gerada - você precisará dela no próximo passo

⚠️ Importante: Mantenha sua chave de API segura e não a partilhe com ninguém. Você pode revogá-la mais tarde, se necessário.

Passo 2: baixe Immich Go

Immich Go é um ficheiro executável independente que não requer instalação:

1. Acesse a página de versões do Immich Go
2. Baixe a versão para o seu sistema operacional:
   • Windows: Baixe o ficheiro .exe
   • macOS: Baixe o ficheiro com darwin no nome
   • Linux: Baixe o ficheiro com linux no nome
3. Extraia o ficheiro .zip baixado
4. Coloque o executável immich-go em uma pasta onde você quer transferir suas fotos (ex. crie uma pasta chamada “Backup PixelUnion”)

Passo 3: abra um Terminal

Você precisará executar Immich Go a partir de um terminal/prompt de comando:

• Windows: Clique com o botão direito na pasta onde está immich-go.exe → “Abrir no terminal” ou “Abrir janela do PowerShell aqui”
• macOS: Abra o aplicação Terminal (encontrado em Aplicações > Utilitários), depois digite cd seguido de um espaço, arraste a pasta com immich-go para a janela do terminal e pressione Enter
• Linux: Abra um terminal e navegue até a pasta contendo immich-go

Passo 4: execute o Comando de Download

No terminal, execute o seguinte comando, substituindo os espaços reservados pelas suas informações:

Windows:

./immich-go.exe archive from-immich --from-server=https://seunome.pixelunion.eu/ --from-api-key=SUA_CHAVE_API --write-to-folder=./PixelUnion-Backup

macOS/Linux:

./immich-go archive from-immich --from-server=https://seunome.pixelunion.eu/ --from-api-key=SUA_CHAVE_API --write-to-folder=./PixelUnion-Backup

Substitua:

• seunome.pixelunion.eu pelo seu domínio PixelUnion real
• SUA_CHAVE_API pela chave de API que você copiou no Passo 1
• ./PixelUnion-Backup pelo caminho onde você quer salvar suas fotos (você pode usar um caminho absoluto como /Users/seunome/Downloads/PixelUnion-Backup ou um caminho relativo como ./PixelUnion-Backup)

O que Acontece Depois?

Immich Go irá:

1. Conectar-se à sua instância PixelUnion
2. Transferir todas as suas fotos e vídeos para a pasta especificada (--write-to-folder)
3. Preservar nomes de ficheiro e datas originais
4. Mostrar o progresso enquanto baixa

O download pode levar algum tempo dependendo de:

• O tamanho da sua biblioteca
• A velocidade da sua conexão com a Internet
• O número de ficheiros

Nota: A opção --write-to-folder é obrigatória. Certifique-se de especificar um caminho de pasta onde você quer salvar suas fotos e vídeos.

Opções de Download

Você pode personalizar seu download com opções adicionais:

Transferir Apenas Fotos (Ignorar Vídeos)

./immich-go archive from-immich --from-server=https://seunome.pixelunion.eu/ --from-api-key=SUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-include-type=IMAGE

Transferir Apenas Vídeos (Ignorar Fotos)

./immich-go archive from-immich --from-server=https://seunome.pixelunion.eu/ --from-api-key=SUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-include-type=VIDEO

Transferir Apenas Fotos Favoritas

./immich-go archive from-immich --from-server=https://seunome.pixelunion.eu/ --from-api-key=SUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-favorite

Transferir Fotos de Álbuns Específicos

./immich-go archive from-immich --from-server=https://seunome.pixelunion.eu/ --from-api-key=SUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-albums="Nome Álbum 1" --from-albums="Nome Álbum 2"

Transferir Fotos com Tags Específicos

./immich-go archive from-immich --from-server=https://seunome.pixelunion.eu/ --from-api-key=SUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-tags="tag1" --from-tags="tag2"

Transferir Fotos de um Intervalo de Datas

./immich-go archive from-immich --from-server=https://seunome.pixelunion.eu/ --from-api-key=SUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-date-range="2024-01-01:2024-12-31"

Solução de Problemas

Problemas de Conexão

• Certifique-se de que seu domínio PixelUnion está correto (inclua https:// e a / final)
• Verifique se sua chave de API está correta e não foi revogada
• Verifique sua conexão com a Internet
• Certifique-se de ter especificado a opção --write-to-folder com um caminho válido

Download Interrompido

• Immich Go retomará de onde parou se você executar o comando novamente
• Não voltará a transferir ficheiros que já estão presentes

Bibliotecas Grandes

• Para bibliotecas muito grandes (milhares de ficheiros), o download pode levar várias horas
• Certifique-se de que seu computador não entre em modo de suspensão durante o download
• Considere executar o download durante a noite

Depois de Transferir

Uma vez que o download esteja completo:

• Suas fotos e vídeos estarão na pasta que você especificou com --write-to-folder
• Os ficheiros estão organizados com seus nomes e datas originais
• Agora você pode fazer backup desses ficheiros com segurança ou transferi-los para outro lugar

Precisa de Ajuda?

Se você encontrar problemas ao usar Immich Go:

• Verifique a documentação do Immich Go
• Entre em contacto com nossa equipa de suporte para obter assistência