Repolode
simulot

simulot/immich-go

Herramienta de línea de comandos en Go para subir colecciones de fotos, incluidos archivos de Google Photos Takeout, a un servidor Immich autoalojado, sin Node.js.

Alternativa open source a:Google Photos

Estrellas
7,065
Forks
273
Issues abiertos
272
Último commit
anteayer

¿Qué es?

Immich-go es una herramienta de línea de comandos para trasladar bibliotecas de fotos grandes a un servidor Immich autoalojado. Es una alternativa a immich-cli oficial y se distribuye como un único binario, por lo que no necesita Node.js ni Docker para ejecutarse.

La herramienta ofrece varios comandos de carga para distintas fuentes: carpetas locales, archivos de Google Photos Takeout, exportaciones de iCloud, carpetas de Picasa, archivos ZIP y otros servidores Immich. El comando de Google Photos relaciona las fotos con sus metadatos JSON para restaurar álbumes, descripciones y ubicaciones. Otros comandos pueden crear álbumes a partir de la estructura de carpetas, leer archivos sidecar XMP y agrupar pares RAW+JPEG o ráfagas.

También detecta duplicados para evitar volver a subir archivos existentes, omite de forma predeterminada archivos y carpetas comunes del sistema, como las carpetas de miniaturas y los archivos .DS_Store, y permite filtrar archivos con patrones de exclusión personalizados. El proyecto es compatible con Immich V2 y V3, y funciona en Windows, macOS, Linux y FreeBSD.

Funciones clave

  • 01Carga archivos desde carpetas locales, Google Photos Takeout, exportaciones de iCloud, carpetas de Picasa y archivos ZIP
  • 02Copia recursos entre servidores Immich con opciones de filtrado
  • 03Conserva álbumes, etiquetas, descripciones y ubicaciones de los metadatos de origen
  • 04Detecta duplicados y agrupa pares RAW+JPEG y ráfagas
  • 05Se distribuye como un único binario, sin depender de Node.js ni Docker

Casos de uso

  • Migrar una biblioteca de Google Photos a un servidor Immich autoalojado
  • Importar exportaciones de iCloud Photos a Immich
  • Trasladar recursos de una instancia de Immich a otra
  • Subir en bloque un archivo fotográfico local grande desde un NAS o un disco

Inicio rápido

  1. 1

    Descarga el binario precompilado para tu sistema desde la página de versiones de GitHub

  2. 2

    Sube fotos desde una carpeta local

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

    Sube una exportación de 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 usarlo

  • Su autor lo describe como una versión inicial que aún no se ha probado exhaustivamente.
  • Requiere un servidor Immich en funcionamiento y una clave de API con los permisos adecuados.
  • Está bajo la licencia AGPL-3.0, una licencia copyleft con obligaciones para el uso en red.

Temas

Preguntas frecuentes

¿Qué es immich-go?
Herramienta de línea de comandos en Go para subir colecciones de fotos, incluidos archivos de Google Photos Takeout, a un servidor Immich autoalojado, sin Node.js. Immich-go es una herramienta de línea de comandos para trasladar bibliotecas de fotos grandes a un servidor Immich autoalojado. Es una alternativa a immich-cli oficial y se distribuye como un único binario, por lo que no necesita Node.js ni Docker para ejecutarse.
¿immich-go es gratuito? ¿Qué licencia tiene?
immich-go es open source bajo la licencia AGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿immich-go sigue mantenido?
Mantenimiento activo. El último commit de immich-go fue el 18 oct 2026.
¿Para qué puedo usar immich-go?
Migrar una biblioteca de Google Photos a un servidor Immich autoalojado Importar exportaciones de iCloud Photos a Immich Trasladar recursos de una instancia de Immich a otra Subir en bloque un archivo fotográfico local grande desde un NAS o un disco
¿Cómo se instala immich-go?
Descarga el binario precompilado para tu sistema desde la página de versiones de GitHub Sube fotos desde una carpeta local: immich-go upload from-folder --server=http://your-ip:2283 --api-key=your-api-key /path/to/your/photos Sube una exportación de Google Photos Takeout: immich-go upload from-google-photos --server=http://your-ip:2283 --api-key=your-api-key /path/to/takeout-*.zip
¿Dónde consigo immich-go?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/simulot/immich-go

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados