Descarga Todas Tus Fotos y Videos con Immich Go

Immich Go es una herramienta poderosa que te permite descargar toda tu biblioteca de fotos y videos de PixelUnion a tu computadora. Esto es especialmente útil cuando quieres:

• Crear una copia de seguridad local de tus medios
• Descargar tus datos antes de eliminar tu cuenta
• Transferir tu biblioteca a otro servicio
• Mantener una copia offline de tus recuerdos

¿Qué es Immich Go?

Immich Go es una herramienta de línea de comandos que se conecta a tu instancia de PixelUnion y descarga todas tus fotos y videos preservando:

• Nombres de archivo originales
• Fechas de creación y metadatos
• Estructuras de álbumes
• Archivos de video

Paso 1: Obtén Tu Clave API

Antes de poder usar Immich Go, necesitas generar una clave API desde tu cuenta de PixelUnion:

1. Inicia sesión en tu dominio de PixelUnion (ej. https://tunombre.pixelunion.eu)
2. Haz clic en el icono de tu perfil en la esquina superior derecha
3. Selecciona Configuración de cuenta
4. Navega a Claves API
5. Haz clic en Nueva clave API
6. Dale un nombre descriptivo (ej. “Herramienta de descarga”)
7. Copia la clave API generada - la necesitarás en el siguiente paso

⚠️ Importante: Mantén tu clave API segura y no la compartas con nadie. Puedes revocarla más tarde si es necesario.

Paso 2: Descarga Immich Go

Immich Go es un archivo ejecutable independiente que no requiere instalación:

1. Ve a la página de versiones de Immich Go
2. Descarga la versión para tu sistema operativo:
   • Windows: Descarga el archivo .exe
   • macOS: Descarga el archivo con darwin en el nombre
   • Linux: Descarga el archivo con linux en el nombre
3. Extrae el archivo .zip descargado
4. Coloca el ejecutable immich-go en una carpeta donde quieras descargar tus fotos (ej. crea una carpeta llamada “Copia de Seguridad PixelUnion”)

Paso 3: Abre una Terminal

Necesitarás ejecutar Immich Go desde una terminal/prompt de comandos:

• Windows: Clic derecho en la carpeta donde está immich-go.exe → “Abrir en terminal” o “Abrir ventana de PowerShell aquí”
• macOS: Abre la aplicación Terminal (encontrada en Aplicaciones > Utilidades), luego escribe cd seguido de un espacio, arrastra la carpeta con immich-go a la ventana del terminal y presiona Enter
• Linux: Abre una terminal y navega a la carpeta que contiene immich-go

Paso 4: Ejecuta el Comando de Descarga

En la terminal, ejecuta el siguiente comando, reemplazando los marcadores de posición con tu información:

Windows:

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

macOS/Linux:

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

Reemplaza:

• tunombre.pixelunion.eu con tu dominio real de PixelUnion
• TU_CLAVE_API con la clave API que copiaste en el Paso 1
• ./PixelUnion-Backup con la ruta donde quieres guardar tus fotos (puedes usar una ruta absoluta como /Users/tunombre/Downloads/PixelUnion-Backup o una ruta relativa como ./PixelUnion-Backup)

¿Qué Sucede Después?

Immich Go:

1. Se conectará a tu instancia de PixelUnion
2. Descargará todas tus fotos y videos a la carpeta especificada (--write-to-folder)
3. Preservará los nombres de archivo y fechas originales
4. Mostrará el progreso mientras descarga

La descarga puede tomar algún tiempo dependiendo de:

• El tamaño de tu biblioteca
• La velocidad de tu conexión a Internet
• El número de archivos

Nota: La opción --write-to-folder es obligatoria. Asegúrate de especificar una ruta de carpeta donde quieras guardar tus fotos y videos.

Opciones de Descarga

Puedes personalizar tu descarga con opciones adicionales:

Descargar Solo Fotos (Omitir Videos)

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

Descargar Solo Videos (Omitir Fotos)

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

Descargar Solo Fotos Favoritas

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

Descargar Fotos de Álbumes Específicos

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

Descargar Fotos con Tags Específicos

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

Descargar Fotos de un Rango de Fechas

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

Solución de Problemas

Problemas de Conexión

• Asegúrate de que tu dominio de PixelUnion sea correcto (incluye https:// y la / final)
• Verifica que tu clave API sea correcta y no haya sido revocada
• Verifica tu conexión a Internet
• Asegúrate de haber especificado la opción --write-to-folder con una ruta válida

Descarga Interrumpida

• Immich Go reanudará desde donde se detuvo si ejecutas el comando nuevamente
• No volverá a descargar archivos que ya están presentes

Bibliotecas Grandes

• Para bibliotecas muy grandes (miles de archivos), la descarga puede tomar varias horas
• Asegúrate de que tu computadora no entre en modo de suspensión durante la descarga
• Considera ejecutar la descarga durante la noche

Después de Descargar

Una vez que la descarga esté completa:

• Tus fotos y videos estarán en la carpeta que especificaste con --write-to-folder
• Los archivos están organizados con sus nombres y fechas originales
• Ahora puedes hacer una copia de seguridad de estos archivos de forma segura o transferirlos a otro lugar

¿Necesitas Ayuda?

Si encuentras problemas al usar Immich Go:

• Consulta la documentación de Immich Go
• Contacta a nuestro equipo de soporte para obtener asistencia