Duas formas de levar um Takeout para o Immich
O immich-go, uma ferramenta gratuita de linha de comando da comunidade do Immich, lê diretamente os arquivos ZIP do Takeout, associa os arquivos JSON e define as datas no seu servidor durante o envio (immich-go upload from-google-photos --server=… --api-key=… takeout-*.zip). Se você não se incomoda em usar o terminal e quer fazer tudo em uma etapa só, use-o — você não precisa desta página.
Esta página mais o envio oficial é a opção certa se você quer conferir os arquivos antes ou ter uma cópia corrigida da sua biblioteca com as datas gravadas nos próprios arquivos — útil para backups e para qualquer outro app no futuro.
Passo a passo
- Exporte: em takeout.google.com, selecione Google Photos, escolha .zip e baixe todas as partes.
- Corrija: solte todas as partes acima e clique em Corrigir e salvar.
- Extraia: descompacte o(s) ZIP(s) corrigido(s) em uma única pasta.
- Importe com a CLI do Immich: instale-a com
npm i -g @immich/cli, faça login comimmich login https://your-server/api YOUR_API_KEYe depois executeimmich upload --recursive /path/to/folder. - Ou no navegador: arraste a pasta extraída para a linha do tempo do Immich. Ao arrastar, as pastas e subpastas são lidas; o botão Upload aceita apenas arquivos avulsos.
Qual data o Immich mostra
- O Immich lê as datas dentro dos arquivos com o ExifTool: DateTimeOriginal em JPEG e HEIC e a data de criação nos cabeçalhos de MP4 e MOV. São esses os campos que a ferramenta preenche.
- Para um arquivo sem data interna — PNG, GIF, um HEIC sem EXIF —, o Immich usa a data de modificação do arquivo, que tanto a CLI quanto o app web enviam junto com cada arquivo. Essa é a data do arquivo que o ZIP corrigido restaura.
- O Immich não lê sozinho os arquivos JSON do Takeout; por isso, sem correção, esses arquivos ficam com a data do dia da exportação.
- As datas dos vídeos são lidas como UTC, que é o que os cabeçalhos de vídeo contêm.
Álbuns
A opção --album da CLI cria álbuns com o nome das pastas. As pastas de álbuns do Takeout viram álbuns — mas as pastas de ano, como Photos from 2019, também virariam. Para ter só os álbuns de verdade, envie as pastas de ano sem --album e as pastas de álbuns com essa opção. Não é preciso pular aqui as cópias da mesma foto nos álbuns: o Immich reconhece um arquivo que já tem pela soma de verificação (checksum).
Perguntas frequentes
É melhor usar o immich-go?
Se você só quer levar seu Takeout para o Immich e se sente à vontade com o terminal, o immich-go é o caminho mais curto: ele lê os arquivos ZIP e aplica as datas do JSON no servidor. Use esta página se preferir corrigir e guardar os próprios arquivos, conferir antes as correspondências em um relatório ou, mais tarde, importar a mesma biblioteca em outro app além do Immich.
Esta página envia as fotos para o meu servidor Immich?
Não. Ela nunca se conecta ao Immich e nunca pede uma chave de API. Você mesmo importa a pasta corrigida com a CLI ou o app web do Immich.
Quais arquivos recebem a data gravada internamente?
As fotos JPEG recebem a data (e, se faltar, a localização) gravada nos dados EXIF, o primeiro lugar que os apps de fotos leem. As fotos HEIC recebem o mesmo no bloco EXIF, quando têm um, como as fotos do iPhone; um HEIC sem bloco EXIF recebe apenas a data do arquivo. Os vídeos MP4, MOV, M4V e 3GP recebem a data nos cabeçalhos do vídeo e das faixas — a “data de criação” que os apps de vídeo leem —, alterada no próprio arquivo, sem recodificação. PNG, GIF, WebP, AVI, MKV e outros formatos não são modificados: recebem a data como data do arquivo (a data de “modificação”) quando você extrai o ZIP corrigido.
A ferramenta vai sobrescrever as datas que a minha câmera gravou?
Por padrão, não. Se um JPEG ou HEIC já tiver uma “data de captura” (DateTimeOriginal) ou uma posição de GPS, ela é mantida. Um vídeo mantém a data de gravação do cabeçalho quando ela é plausível; uma data de vídeo vazia, anterior a 1970 ou que seja apenas a hora de envio ou de processamento (igual ou posterior ao envio de um vídeo gravado antes) é substituída. Ative Substituir datas e locais já gravados pela câmera se você alterou datas no Google Photos e quer usar essas.
Minhas fotos são enviadas?
Não. Os arquivos ZIP são lidos pelo navegador no seu próprio computador, e o arquivo corrigido também é gravado nele. Nada é enviado a um servidor — você pode se desconectar da internet depois que a página carregar, e ela continua funcionando.