Baixe Todas as Suas Fotos e Vídeos com Immich Go

Immich Go é uma ferramenta poderosa que permite baixar 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 arquivos de mídia
• Baixar 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 arquivo originais
• Datas de criação e metadados
• Estruturas de álbuns
• Arquivos 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 compartilhe com ninguém. Você pode revogá-la mais tarde, se necessário.

Passo 2: Baixe Immich Go

Immich Go é um arquivo 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 arquivo .exe
   • macOS: Baixe o arquivo com darwin no nome
   • Linux: Baixe o arquivo com linux no nome
3. Extraia o arquivo .zip baixado
4. Coloque o executável immich-go em uma pasta onde você quer baixar 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 aplicativo Terminal (encontrado em Aplicativos > 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. Baixar todas as suas fotos e vídeos para a pasta especificada (--write-to-folder)
3. Preservar nomes de arquivo 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 arquivos

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:

Baixar 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

Baixar 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

Baixar 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

Baixar 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"

Baixar 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"

Baixar 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
• Ele não baixará novamente arquivos que já estão presentes

Bibliotecas Grandes

• Para bibliotecas muito grandes (milhares de arquivos), 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 Baixar

Uma vez que o download esteja completo:

• Suas fotos e vídeos estarão na pasta que você especificou com --write-to-folder
• Os arquivos estão organizados com seus nomes e datas originais
• Agora você pode fazer backup desses arquivos 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 contato com nossa equipe de suporte para obter assistência