Inicio
Acerca de
Código abierto Aplicaciones móviles Preguntas frecuentes Migrar desde Google Fotos Acerca de PixelUnion
Tarifas Blog
Centro de Ayuda
Cuenta Immich Migración Otros Contactar soporte
Iniciar sesión Registrarse

Descargar Todas las Fotos y Vídeos

Descarga toda tu biblioteca de PixelUnion a tu ordenador con immich-archiver o Immich Go

Puedes descargar toda tu biblioteca de fotos y vídeos de PixelUnion a tu propio ordenador. Resulta útil cuando quieres:

  • Conservar una copia local de tus medios junto a tu biblioteca de PixelUnion
  • Descargar tus datos antes de eliminar tu cuenta
  • Trasladar tu biblioteca a otro servicio
  • Tener una copia sin conexión de tus recuerdos

Hay dos herramientas para esto:

  • immich-archiver está desarrollada y mantenida por PixelUnion. Úsala para una copia sencilla de toda tu biblioteca. Es la que recomendamos.
  • Immich Go es una herramienta de la comunidad con más opciones de filtrado, como descargar solo determinados álbumes, etiquetas o un rango de fechas. Actualmente le afecta un error, descrito más abajo.

Ambas herramientas necesitan una clave de API, así que empieza por ahí.

Paso 1: obtén tu clave de API

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

⚠️ Importante: mantén tu clave de API a salvo y no la compartas con nadie. Puedes revocarla más adelante si es necesario.

immich-archiver (recomendada)

immich-archiver copia cada foto y vídeo de tu línea de tiempo en carpetas por fecha en tu disco, y escribe junto a cada archivo un .json con todos los metadatos que tenemos: fecha de captura, cámara, ubicación GPS, pertenencia a álbumes, caras y valoraciones.

En tu disco queda así:

PixelUnion-Backup/2005/2005-06/IMG_0001.jpg
PixelUnion-Backup/2005/2005-06/IMG_0001.jpg.json

Si la ejecutas de nuevo más adelante, solo descarga lo nuevo, así que mantener tu copia al día es rápido.

Paso 2: descarga immich-archiver

  1. Ve a la página de versiones de immich-archiver
  2. Descarga el archivo para tu sistema:
    • Windows: immich-archiver_..._windows_amd64.exe
    • macOS (Apple Silicon): immich-archiver_..._darwin_arm64
    • macOS (Intel): immich-archiver_..._darwin_amd64
    • Linux: immich-archiver_..._linux_amd64 (o linux_arm64 en una Raspberry Pi o similar)
  3. Mueve el archivo descargado a la carpeta donde quieras tu copia de seguridad
  4. Renómbralo a immich-archiver (en Windows, immich-archiver.exe). El nombre descargado incluye el número de versión, y renombrarlo mantiene iguales los comandos de abajo cuando actualices más adelante.

Las versiones de macOS están firmadas y notarizadas con Apple, así que se ejecutan sin aviso de seguridad.

En macOS y Linux tienes que hacer el archivo ejecutable una vez. Abre un terminal en esa carpeta y ejecuta:

chmod +x immich-archiver

Paso 3: ejecútala

Abre un terminal en la carpeta que contiene el archivo:

  • Windows: clic derecho en la carpeta → “Abrir en el terminal”
  • macOS: abre la app Terminal, escribe cd seguido de un espacio, arrastra la carpeta a la ventana y pulsa Intro
  • Linux: abre un terminal y sitúate en la carpeta

Después ejecuta la herramienta, sustituyendo los valores por los tuyos:

Windows:

.\immich-archiver.exe --url https://tunombre.pixelunion.eu --api-key TU_CLAVE_API --dir .\PixelUnion-Backup

macOS/Linux:

./immich-archiver --url https://tunombre.pixelunion.eu --api-key TU_CLAVE_API --dir ./PixelUnion-Backup

Sustituye tunombre.pixelunion.eu por tu propio dominio y TU_CLAVE_API por la clave del paso 1.

Para no escribir la clave cada vez, puedes definirlas como variables de entorno: IMMICH_URL, IMMICH_API_KEY e IMMICH_DIR. Con esas definidas, basta con ejecutar immich-archiver a secas.

Opciones útiles

OpciónQué hace
--dry-runMuestra qué se descargaría sin guardar nada
--verboseImprime una línea por archivo en lugar de un contador
--path-template "{year}/{month}/{day}"Cambia la estructura de carpetas. Por defecto es {year}/{year}-{month}
--include-sharedDescarga también los álbumes que otros comparten contigo, en una carpeta aparte shared-with-me
--concurrency 8Descarga más archivos a la vez. Por defecto son 4
--retries 5Reintenta las descargas fallidas más veces. Por defecto son 3

Ejecuta la herramienta con --help para ver todo lo que admite.

Immich Go (para filtrado avanzado)

Immich Go es una herramienta de línea de comandos creada por la comunidad. Ofrece filtros que immich-archiver todavía no tiene, como limitar la descarga a álbumes, etiquetas o un rango de fechas concretos.

Error conocido en immich-go: nombres de archivo incorrectos

Hay un error conocido en immich-go que afecta al comando archive from-immich. Los archivos exportados pueden recibir nombres numéricos incorrectos (como -1, -2) sin extensión de archivo, y los metadatos de los álbumes pueden faltar en la exportación. Se está trabajando en una solución. Puedes seguir el progreso en GitHub (PR #1272). Recomendamos usar immich-archiver, descrita más arriba, o esperar a una versión actualizada de immich-go antes de usar este comando.

Descargar Immich Go

  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

Ejecuta el comando de descarga

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

Sustituye:

  • tunombre.pixelunion.eu por tu dominio real de PixelUnion
  • TU_CLAVE_API por la clave de API que copiaste en el paso 1
  • ./PixelUnion-Backup por la ruta donde quieras guardar tus fotos

Nota: la opción --write-to-folder es obligatoria.

Opciones de filtrado de Immich Go

Descargar solo fotos (omitir vídeos)

./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 vídeos (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 concretos

./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 de álbum 1" --from-albums="Nombre de álbum 2"

Descargar fotos con etiquetas concretas

./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"

Resolución de problemas

Problemas de conexión

  • Comprueba que tu dominio de PixelUnion es correcto e incluye https://
  • Verifica que tu clave de API es correcta y no ha sido revocada
  • Comprueba tu conexión a internet

“Permission denied” en macOS o Linux

  • Primero tienes que hacer el archivo ejecutable: chmod +x immich-archiver

Descarga interrumpida

  • Ambas herramientas continúan donde se quedaron si vuelves a ejecutar el comando
  • Los archivos ya descargados no se vuelven a bajar

Bibliotecas grandes

  • En bibliotecas muy grandes (miles de archivos), la descarga puede tardar varias horas
  • Asegúrate de que tu ordenador no entre en suspensión durante la descarga
  • Considera dejar la descarga en marcha durante la noche

Después de la descarga

Cuando la descarga termine:

  • Tus fotos y vídeos estarán en la carpeta que indicaste
  • Los archivos conservan sus nombres y fechas originales
  • Puedes respaldar estos archivos en otro sitio o transferirlos

Conviene comprobar tu copia antes de confiar en ella. Abre la carpeta y confirma que algunas fotos se abren de verdad.

¿Necesitas ayuda?

Si tienes problemas:

Was this article helpful? Let us know
Previous Next