Repolode
Enviar
simulot

simulot/immich-go

Ferramenta de linha de comando em Go para enviar coleções de fotos, incluindo arquivos Google Photos Takeout, para um servidor Immich auto-hospedado, sem Node.js.

Alternativa open source a:Google Photos

Ver no GitHub
Estrelas
7,065
Forks
273
Issues abertas
272
Último commit
anteontem

O que é?

Immich-go é uma ferramenta de linha de comando para transferir grandes bibliotecas de fotos para um servidor Immich auto-hospedado. É uma alternativa ao immich-cli oficial e é distribuída como um único binário, sem exigir Node.js ou Docker para funcionar.

A ferramenta oferece vários comandos de upload para diferentes origens: pastas locais, arquivos Google Photos Takeout, exportações do iCloud, pastas do Picasa, arquivos ZIP e outros servidores Immich. O comando do Google Photos associa as fotos aos metadados JSON para restaurar álbuns, descrições e localizações. Outros comandos podem criar álbuns a partir da estrutura de pastas, ler arquivos auxiliares XMP e agrupar pares RAW+JPEG ou sequências de fotos.

A ferramenta também detecta duplicatas para evitar o reenvio de arquivos existentes, ignora por padrão arquivos e pastas comuns do sistema, como pastas de miniaturas e arquivos .DS_Store, e permite filtrar arquivos com padrões personalizados de bloqueio. O projeto oferece suporte ao Immich V2 e V3 e funciona no Windows, macOS, Linux e FreeBSD.

Recursos principais

  • 01Envia arquivos de pastas locais, Google Photos Takeout, exportações do iCloud, pastas do Picasa e arquivos ZIP
  • 02Copia arquivos entre servidores Immich com filtragem
  • 03Preserva álbuns, tags, descrições e localizações dos metadados de origem
  • 04Detecta duplicatas e agrupa pares RAW+JPEG e sequências de fotos
  • 05É distribuído como um único binário, sem dependência de Node.js ou Docker

Casos de uso

  • Migrar uma biblioteca do Google Photos para um servidor Immich auto-hospedado
  • Importar exportações do iCloud Photos para o Immich
  • Transferir arquivos de uma instância do Immich para outra
  • Enviar em lote um grande arquivo local de fotos armazenado em um NAS ou disco

Início rápido

  1. 1

    Baixe o binário pré-compilado para o seu sistema na página de releases do GitHub

  2. 2

    Envie fotos de uma pasta local

    immich-go upload from-folder --server=http://your-ip:2283 --api-key=your-api-key /path/to/your/photos
  3. 3

    Envie uma exportação do Google Photos Takeout

    immich-go upload from-google-photos --server=http://your-ip:2283 --api-key=your-api-key /path/to/takeout-*.zip

Antes de usar

  • Segundo o autor, esta é uma versão inicial que ainda não foi amplamente testada.
  • Requer um servidor Immich em execução e uma chave de API com as permissões adequadas.
  • Licenciado sob a AGPL-3.0, uma licença copyleft com obrigações para uso em rede.

Tópicos

#immich#photo-management#self-hosted#golang#cli#google-photos#backup#migration#google#immich-cli

Perguntas frequentes

O que é immich-go?
Ferramenta de linha de comando em Go para enviar coleções de fotos, incluindo arquivos Google Photos Takeout, para um servidor Immich auto-hospedado, sem Node.js. Immich-go é uma ferramenta de linha de comando para transferir grandes bibliotecas de fotos para um servidor Immich auto-hospedado. É uma alternativa ao immich-cli oficial e é distribuída como um único binário, sem exigir Node.js ou Docker para funcionar.
immich-go é gratuito? Qual é a licença?
immich-go é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
immich-go ainda é mantido?
Manutenção ativa. O último commit de immich-go foi em 18 de out. de 2026.
Para que posso usar immich-go?
Migrar uma biblioteca do Google Photos para um servidor Immich auto-hospedado Importar exportações do iCloud Photos para o Immich Transferir arquivos de uma instância do Immich para outra Enviar em lote um grande arquivo local de fotos armazenado em um NAS ou disco
Como instalar immich-go?
Baixe o binário pré-compilado para o seu sistema na página de releases do GitHub Envie fotos de uma pasta local: immich-go upload from-folder --server=http://your-ip:2283 --api-key=your-api-key /path/to/your/photos Envie uma exportação do Google Photos Takeout: immich-go upload from-google-photos --server=http://your-ip:2283 --api-key=your-api-key /path/to/takeout-*.zip
Onde consigo immich-go?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/simulot/immich-go

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados