Bibliotecas externas y herramientas de terceros

Si has gestionado Immich por tu cuenta, puede que estés acostumbrado a funciones que dependen del acceso directo al servidor, como las bibliotecas externas o las herramientas que se conectan a la base de datos de Immich. Como PixelUnion es un servicio gestionado, algunas de ellas funcionan de otra manera. Este artículo explica qué es posible y qué no.

Las bibliotecas externas no están disponibles

En una instalación de Immich autoalojada, una biblioteca externa permite que Immich lea fotos de una carpeta que ya existe en el servidor o en una unidad montada, por ejemplo una carpeta compartida de un NAS. Immich indexa esos archivos donde están, sin copiarlos a su propio almacenamiento.

Esta función no está disponible en PixelUnion. Tu entorno de PixelUnion se ejecuta en nuestro centro de datos y no tiene acceso a carpetas de tu propio ordenador o NAS. Por el mismo motivo, el endpoint de la API /api/library, que gestiona las bibliotecas externas, está deshabilitado.

En su lugar, todas las fotos y vídeos en PixelUnion se encuentran en una biblioteca gestionada normal: los archivos se suben a tu entorno y PixelUnion los almacena. Esto también significa que tienes control total sobre todo su contenido. Puedes editar, mover a la papelera y eliminar cualquier foto, algo que no es posible con los archivos de solo lectura de una biblioteca externa.

Alternativas

Para pasar fotos de una carpeta o un NAS a PixelUnion, súbelas:

• Immich Go: una herramienta de línea de comandos que sube una carpeta entera de una sola vez. Si la vuelves a ejecutar más tarde, solo sube los archivos nuevos. Ejemplo:

  ./immich-go upload from-folder --server=https://yourname.pixelunion.eu --api-key=YOUR_API_KEY /path/to/your/photos
  

  Consulta Migrar desde otro servidor Immich para saber cómo descargar Immich Go y crear una clave API.

• La aplicación móvil: haz copia de seguridad automática del carrete de tu teléfono y de otras carpetas. Consulta Aplicación Móvil.

• La interfaz web: arrastra y suelta archivos o carpetas en tu navegador. Consulta Subir Fotos.

¿Ya tienes tu propio servidor Immich con una biblioteca externa? Puedes trasladar esa biblioteca a PixelUnion con Immich Go, consulta Migrar desde otro servidor Immich.

Usar la API de Immich y herramientas de terceros

Puedes usar la API de Immich con tus propias claves API, así que la mayoría de las herramientas basadas en la API funcionan con PixelUnion. Crea una clave API en Configuración de la cuenta → Claves API. Solo hay dos endpoints deshabilitados: /api/library (bibliotecas externas) y /api/system-config (configuración del servidor).

Algunas herramientas de terceros necesitan algo más que la API. Se conectan directamente a la base de datos de Immich o leen el sistema de archivos del servidor. PixelUnion no ofrece acceso directo a ninguno de los dos, por lo que esas herramientas, o las funciones que dependen de ello, no funcionarán.

Immich Power Tools es un ejemplo: varias de sus funciones consultan directamente la base de datos de Immich. Las funciones que solo usan la API pueden funcionar, pero cuenta con que parte de la herramienta no estará disponible.

Antes de confiar en una herramienta de terceros, consulta su documentación para comprobar si necesita una conexión a la base de datos o acceso al sistema de archivos.

Eliminar duplicados sin herramientas adicionales

Immich incluye detección de duplicados. En la interfaz web, ve a Utilidades → Revisar duplicados para comparar fotos similares una al lado de la otra y elegir cuáles conservar. Los duplicados se detectan por usuario, así que las fotos subidas por dos usuarios distintos no se comparan entre sí.

Conservar la estructura de tus álbumes en una copia local

PixelUnion hace copias de seguridad de tus datos, consulta Backups: cómo hacemos copias de seguridad de tus datos. Si además quieres tu propia copia local, ten en cuenta que muchas herramientas de descarga guardan los archivos, pero no a qué álbumes pertenecen.

Hay varias formas de conservar tus álbumes:

1. immich-archiver: nuestra propia herramienta de descarga escribe un archivo .json junto a cada foto y vídeo, que incluye los álbumes a los que pertenece. Consulta Descargar Todas las Fotos y Vídeos.
2. Descargar por álbum: abre un álbum en la interfaz web y descárgalo. Obtienes un archivo ZIP con todas las fotos y vídeos de ese álbum, pero sin información del álbum más allá de la propia carpeta.
3. Usar la API: la API de Immich devuelve todos tus álbumes y las fotos de cada álbum, así que puedes escribir tu propio script si necesitas otra estructura.

¿Necesitas ayuda?

¿No sabes si una herramienta o un flujo de trabajo funcionará con PixelUnion? Contacta con nuestro equipo de soporte y te ayudaremos a comprobarlo.