La relación entre Gallery e Immich
Noodle Gallery es un fork respetuoso de Immich, la plataforma open source de gestión de fotos autoalojada creada por Alex Tran y una comunidad en crecimiento. Gallery se rebasa sobre cada versión upstream de Immich, de modo que las correcciones, las mejoras de rendimiento y las nuevas funcionalidades del equipo de Immich llegan automáticamente a Gallery.
La relación es deliberadamente sencilla: Immich es la base. Gallery se apoya en ella y añade un pequeño número de funcionalidades para casos de uso que no encajan en el alcance upstream. Misma base de datos, mismos contenedores, mismo camino de vuelta. Si cambias de opinión, volver atrás es un cambio de tres líneas.
Esta página existe porque los usuarios de Immich se hacen, con razón, la pregunta: «¿En qué se diferencia?». La respuesta merece ser clara, y no porque consideremos que upstream sea inferior.
Donde Immich llega a sus límites, y cómo Gallery los cubre
Cada funcionalidad exclusiva de Gallery empezó con la misma observación: alguien topó con un límite en Immich y buscaba una solución. Las categorías de abajo agrupan esos límites por tema, cada una acompañada de las funcionalidades de Gallery que les dan respuesta.
Personas e identidad
El límite. El reconocimiento facial de Immich se detiene en la cuenta. La misma persona real existe como entrada distinta en tu biblioteca, en la de tu pareja y en cada álbum compartido que ambos tocáis. Si la buscas, solo encuentras un tercio de sus fotos. Si la nombras en una cuenta, nada se propaga a las demás. La página Personas indica en qué contenedor aparece alguien, no quién forma realmente parte de tu vida.
Cómo lo resuelve Gallery.
- Personas globales — las personas, los filtros y los resultados de búsqueda que tienen en cuenta la identidad se deduplican en tu biblioteca privada y en cada espacio con timeline al que tienes acceso. Una sola fila en la página Personas, una sola sugerencia en los filtros, un solo resultado en la búsqueda, sin cruzar nunca un límite de permiso del que ya estás del lado correcto. Los nombres, las agrupaciones y las fechas de cumpleaños permanecen donde se introdujeron; la capa de identidad por debajo conecta lo que es claramente la misma persona.
Compartir y colaborar
El límite. Las dos primitivas de compartición de Immich —el compartir con una pareja y los álbumes— llegan a sus límites más allá de dos personas. El compartir con pareja es todo o nada. Los álbumes pertenecen a la persona que los creó. No existe una timeline familiar común, ni un registro de actividad, ni un «qué hay de nuevo desde mi última visita», ni una forma de compartir decenas de miles de fotos sin seleccionarlas a mano.
Cómo lo resuelve Gallery.
- Espacios compartidos — timelines colaborativas con roles de Propietario, Editor y Lector, reconocimiento facial entre cuentas, integración en la timeline, seguimiento de la última visita y registro de actividad.
- Filtrado de espacios — la suite completa de filtros dentro de un espacio individual.
- Grupos de usuarios — grupos con nombre y color para compartir con un solo clic.
- Añadir en masa a los espacios — añadir cientos de miles de fotos a un espacio mediante una tarea en segundo plano.
Búsqueda y descubrimiento
El límite. Cada página de Immich tiene su propia búsqueda; no existe una entrada global centrada en el teclado. Los resultados de la búsqueda inteligente llegan por orden de relevancia, sin orden por fecha ni umbral de similitud. Los filtros funcionan de forma aislada.
Cómo lo resuelve Gallery.
- Agrupación de la timeline — ¿te cuesta encontrar una foto cuando tu biblioteca abarca más de 20 años? Alterna cualquier timeline entre Años, Meses y Todo, y acerca y aleja hasta dar con las fotos que buscas. Toca una tarjeta de año o de mes para sumergirte en ese periodo sin restringir la consulta; tu posición de desplazamiento se conserva al volver a salir.
- Filtros de búsqueda integrados — personas, etiquetas, fechas, lugares, valoraciones, tipo de medio, favoritos, cámaras y filtros de álbumes para escribir directamente en la barra de búsqueda, con sugerencias en vivo antes de pulsar Intro.
- Búsqueda global — Cmd/Ctrl+K como interfaz de búsqueda central para fotos, personas, lugares, etiquetas, comandos y páginas.
- Paleta de búsqueda — paleta de comandos centrada en el teclado con prefijos y comandos contextuales.
- Orden de búsqueda y relevancia — ordenar por fecha o por relevancia y ajustar los umbrales de similitud.
- Filtros dependientes — cada filtro restringe todos los demás filtros en tiempo real.
- Búsqueda inteligente y filtros contextuales — búsqueda en lenguaje natural dentro de los espacios con sugerencias de filtros adaptativas.
- Filtrado en el mapa — panel de filtros directamente en la vista de mapa.
IA y automatización
El límite. La interfaz de IA de Immich se centra en las caras y en la búsqueda CLIP básica. Las mascotas no se reconocen. Los recuerdos solo muestran «Ese día». No existe una forma automática de retirar el desorden de la timeline.
Cómo lo resuelve Gallery.
- Clasificación automática — etiquetar y archivar el desorden como capturas de pantalla, memes y recibos mediante CLIP.
- Archivo de recuerdos — recorrer los recuerdos generados guardados y configurar su duración de conservación.
- Recuerdos más inteligentes — recuerdos de viajes y aniversarios con reglas del lado del servidor.
- Reconocimiento de mascotas — YOLO11 detecta perros, gatos, pájaros y otros animales.
- Detección de vídeos duplicados — encontrar vídeos duplicados pese al recodificado, el redimensionado o el cambio de formato.
Gestión de medios y migración
El límite. Recortar un vídeo en Immich significa: exportar, editar fuera, reimportar. Pasar de Google Fotos requiere herramientas CLI y scripts. El almacenamiento es un disco local o bibliotecas externas, pero sin un backend de almacenamiento compatible con S3 nativo.
Cómo lo resuelve Gallery.
- Recorte de vídeo — recortar los vídeos sin pérdida mediante copia de flujo.
- Bibliotecas conectadas — hacer que las bibliotecas externas sean visibles de inmediato en los Espacios compartidos.
- Importación de Google Fotos — importar los archivos de Google Takeout directamente en el navegador.
- Almacenamiento compatible con S3 — usar AWS S3, MinIO, Cloudflare R2, Backblaze B2, Wasabi o cualquier almacenamiento compatible con S3.
Móvil
El límite. Filtrar la timeline en la aplicación de Immich implica pasar a una pestaña de Búsqueda aparte y perder la posición de desplazamiento. Las interfaces avanzadas como el mapa, la búsqueda contextual y los Espacios compartidos están escondidas en la aplicación o ausentes.
Cómo lo resuelve Gallery.
- Filtros de fotos en móvil — un panel deslizante en la pestaña Fotos filtra por personas, lugares, etiquetas, fecha, valoración y tipo de medio, sin salir de la vista de cuadrícula.
- Noodle Gallery para iPhone — aplicación iOS nativa en la App Store con copia de seguridad de la cámara, búsqueda CLIP en el dispositivo, mapa y vista previa de los Espacios compartidos.
- Noodle Gallery para Android — aplicación Android nativa en Google Play con copia de seguridad de la cámara, búsqueda CLIP en el dispositivo, mapa y Espacios compartidos.
Los límites en comparación directa
Una vista condensada de las mismas carencias y sus soluciones, práctica si quieres ver el conjunto en una tabla.
image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}image: ghcr.io/open-noodle/gallery-server:${IMMICH_VERSION:-release}image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}image: ghcr.io/open-noodle/gallery-ml:${IMMICH_VERSION:-release}image: ghcr.io/open-noodle/gallery-server:${IMMICH_VERSION:-release}
image: ghcr.io/open-noodle/gallery-ml:${IMMICH_VERSION:-release} | Donde Immich llega a sus límites | Cómo los resuelve Gallery |
|---|---|
| Los filtros móviles salen de la pestaña Fotos y hacen perder la posición de desplazamiento | Panel de filtros directamente en la pestaña Fotos — personas, lugares, etiquetas, fecha, valoración, tipo de medio |
| El compartir con pareja es todo o nada; los álbumes pertenecen al creador; el reconocimiento facial se detiene en la cuenta | Espacios compartidos con timelines multipropietario, roles, reconocimiento facial entre cuentas, seguimiento de la última visita y registro de actividad |
| La misma persona puede aparecer como varias entradas en bibliotecas privadas y compartidas | Personas globales — filas de personas, filtros y resultados de búsqueda que tienen en cuenta la identidad en los espacios con timeline accesibles |
| Las mascotas no se reconocen | Reconocimiento de mascotas con YOLO11 y grupos de mascotas dedicados |
| Los recuerdos solo muestran “Ese día” | Recuerdos más inteligentes con retrospectivas de viajes y aniversarios |
| Los recuerdos generados desaparecen tras su ventana de carrusel diaria | Archivo de recuerdos con búsqueda y conservación configurable |
| Cada página tiene su propia búsqueda; no hay entrada global por teclado | Paleta de búsqueda mediante Cmd/Ctrl+K desde cualquier sitio |
| Los filtros avanzados obligan a salir del flujo del teclado para acceder al panel de filtros | Filtros de búsqueda integrados — escribir filtros estructurados directamente en la barra de búsqueda, con sugerencias en vivo y estado de URL compartible |
| Navegar por una biblioteca grande obliga a desplazarse por cada bloque diario — imposible saltar a un año o un mes de un vistazo | Agrupación de la timeline — selector Años / Meses / Todo en cada timeline; acerca y aleja tocando una tarjeta de año o de mes para encontrar rápido una foto en una biblioteca de décadas de antigüedad |
| La búsqueda inteligente no tiene orden por fecha ni umbral de relevancia | Orden por fecha, desplazamiento infinito por fecha, umbral de similitud ajustable |
| Los filtros funcionan de forma aislada | Los filtros dependientes se restringen mutuamente en tiempo real |
| El mapa no tiene su propio panel de filtros | Panel de filtros completo en el mapa, los marcadores se actualizan en vivo |
| Sin almacenamiento compatible con S3 nativo | AWS S3, MinIO, Cloudflare R2, Backblaze B2, Wasabi o cualquier almacenamiento compatible con S3 |
| La importación desde Google Fotos requiere herramientas CLI y scripts | Asistente de importación guiado para los archivos de Google Takeout en el navegador |
| Recortar un vídeo significa exportar y recodificar | Recorte sin pérdida mediante copia de flujo, casi instantáneo |
Importante: cada solución de arriba es aditiva. Gallery no reemplaza nada de lo que Immich hace. Las funcionalidades principales, la API REST, las apps oficiales de Immich, las integraciones de terceros, Frame, la domótica: todo sigue funcionando en un servidor Gallery.
¿Deberías quedarte en Immich upstream?
Existen razones de verdad para ejecutar Immich upstream en lugar del fork. No son argumentos de fachada, sino casos en los que upstream es la elección correcta.
Tamaño de la comunidad e historial
Immich lleva activo desde 2022, tiene decenas de miles de estrellas en GitHub, numerosos colaboradores y un gran Discord. Si quieres el confort de una gran comunidad, upstream es el lugar adecuado.
Pruebas en una mayor variedad de plataformas
Immich upstream funciona en una enorme cantidad de combinaciones de hardware y de NAS. Si tu configuración es inusual, esa mayor superficie de pruebas te resultará útil.
No necesitas los añadidos
Si no necesitas los Espacios compartidos, el reconocimiento de mascotas, el almacenamiento S3, las importaciones de Google Takeout o los filtros avanzados, Immich upstream ya hace todo lo que quieres.
Migrar desde Immich es un cambio de tres líneas
Si ya tienes Immich en marcha y quieres probar Gallery, el cambio
es trivial. Sustituye dos nombres de imágenes en tu docker-compose.yml
y pon IMMICH_VERSION en v4 dentro de tu .env.
image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release} image: ghcr.io/open-noodle/gallery-server:${IMMICH_VERSION:-release} image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release} image: ghcr.io/open-noodle/gallery-ml:${IMMICH_VERSION:-release} IMMICH_VERSION=release IMMICH_VERSION=v4 Después, descarga las nuevas imágenes y reinicia:
docker compose pull && docker compose up -dSin migración de datos. Sin conversión de base de datos. Sin copia de archivos. Tu biblioteca permanece exactamente donde está.
docker exec -t your-db-container pg_dumpall -U postgres > backup.sql La guía completa paso a paso está en la página de instalación. Ver la guía de migración →
Gallery incluye un SQL de limpieza que elimina todas las extensiones de base de datos propias de Gallery. Tus fotos y vídeos nunca se tocan. Basta con volver a poner los dos nombres de imágenes y estarás de vuelta en upstream.
Leer la guía para volver atrásLa misión de Gallery es poner a tu disposición un pequeño número de funcionalidades adicionales sin obligarte a elegir entre ellas y la hoja de ruta de Immich.
Preguntas frecuentes
¿Mis datos están seguros si paso de Immich a Noodle Gallery?
Sí. Gallery utiliza el mismo esquema de base de datos, la misma estructura de directorio de subidas y los mismos formatos de archivo que Immich upstream. La migración consiste en cambiar dos nombres de imágenes en tu docker-compose.yml. Tu biblioteca nunca se copia, transforma ni reescribe: Gallery lee y escribe exactamente los mismos archivos que Immich ya utiliza.
¿Puedo volver a Immich upstream más adelante?
Sí. Gallery incluye un script de limpieza que elimina de la base de datos cada tabla, columna y marcador de migración propios de Gallery. Tus fotos y vídeos nunca se tocan. Ejecuta el script, vuelve a poner los dos nombres de imágenes en ghcr.io/immich-app/immich-server y ghcr.io/immich-app/immich-machine-learning, lanza docker compose pull y estarás de vuelta en upstream.
¿Gallery se alejará de Immich con el tiempo?
No, el objetivo es justo lo contrario. Gallery se rebasa sobre cada versión upstream de Immich, de modo que las correcciones, las mejoras de rendimiento y las nuevas funcionalidades del equipo de Immich llegan automáticamente a Gallery. Las funcionalidades exclusivas de Gallery son aditivas: se apoyan en upstream, no lo reemplazan.
¿Con qué rapidez se rebasa Gallery tras una nueva versión de Immich?
Normalmente en pocos días. El proceso de rebase está automatizado donde tiene sentido y es manual donde hace falta. El objetivo es mantenernos lo bastante cerca como para que Gallery parezca un Immich ligeramente enriquecido, y no un proyecto distinto.
¿Gallery tiene aplicación móvil?
Sí. Noodle Gallery está disponible en la App Store para iPhone y en Google Play para Android, con copia de seguridad automática de la cámara en segundo plano, búsqueda CLIP en el dispositivo, vista de mapa y Espacios compartidos. Las apps de Immich upstream también funcionan con los servidores Gallery a través de la API común.
¿Las aplicaciones de terceros para Immich siguen funcionando con Noodle Gallery?
Sí, por completo. Gallery expone la misma API REST que Immich upstream: mismos endpoints, mismas rutas, mismas cargas útiles. Todo lo que funciona con Immich funciona sin cambios con Gallery: clientes móviles, apps oficiales de Immich, Immich Frame, integraciones domóticas, herramientas CLI y scripts.
¿Por qué forkear en lugar de aportar las funcionalidades a upstream?
Varias funcionalidades exclusivas de Gallery —como los Espacios compartidos, el reconocimiento de mascotas y los filtros contextuales— fueron rechazadas en upstream, consideradas fuera de alcance, o habrían requerido cambios arquitectónicos incompatibles con la hoja de ruta de Immich. El fork permite experimentar sin frenar al equipo upstream, y el rebase garantiza que no perdamos sus avances.
Una nota para el equipo de Immich upstream
Noodle Gallery existe porque Immich existe. Le debemos al equipo upstream la arquitectura, el diseño de la base de datos, las apps móviles, la integración CLIP y la impresionante cadencia de publicación. Si encuentras Gallery útil, considera dar una estrella, un patrocinio o una contribución a immich-app/immich.