ChronoFrame es una galería de fotos de código abierto pensada para alojarse en un servidor propio: al subir las imágenes extrae sus datos EXIF, genera vistas previas, identifica el lugar donde se tomaron y permite que los visitantes las recorran por fecha, por álbum o sobre un mapa. Se instala con un único contenedor Docker, reproduce Live Photos de Apple y fotos en movimiento, y se distribuye con licencia AGPL-3.0.
Las claves de ChronoFrame en 20 segundos
- Galería de fotos libre y autoalojada con licencia AGPL-3.0.
- Lee EXIF, ubica cada foto en un mapa y admite Live Photos.
- Un contenedor Docker y un volumen de datos bastan para arrancar.
- Guarda las fotos en disco local, S3 u OpenList.
El proyecto, mantenido en GitHub por el desarrollador HoshinoSuzumi, rondaba las 2.000 estrellas a principios de noviembre de 2026. Está escrito en TypeScript sobre Nuxt y Vue, y su enfoque es más el de un portafolio o una galería pública que el de una copia de seguridad del móvil. Para lo segundo existen otras herramientas; ChronoFrame se centra en mostrar bien las fotos, con zoom fluido sobre imágenes grandes, histogramas y datos de cámara.

Qué ofrece la galería
La vista principal usa un mosaico de tipo masonry con filtros y ordenación. Al abrir una foto, un visor con WebGL y renderizado por teselas permite ampliar imágenes de gran tamaño sin cargarlas enteras, junto al histograma, la descarga del original y una vista previa para compartir. Las Live Photos y Motion Photos se emparejan solas con su vídeo y se reproducen al pasar el ratón o con una pulsación larga en el móvil.
Los álbumes se pueden ordenar, ocultar o proteger con contraseña. Los mapas usan MapLibre o Mapbox, con geocodificación inversa y elección del idioma de los nombres de lugar. El panel de administración gestiona subidas en lote, edición de metadatos y valoraciones, descargas masivas y reindexado, con una cola de tareas, registros en directo y actividad reciente. El acceso es con correo y contraseña, con inicio de sesión opcional mediante GitHub, y admite scripts de analítica propios.
Instalación con Docker
Docker es la opción recomendada. Basta un docker-compose.yml como el de la documentación oficial:
services:
chronoframe:
image: ghcr.io/hoshinosuzumi/chronoframe:latest
container_name: chronoframe
restart: unless-stopped
ports:
- '3000:3000'
volumes:
- ./data:/app/dataLenguaje del código: JavaScript (javascript)
docker compose up -d
# O directamente con docker run
docker run -d --name chronoframe --restart unless-stopped
-p 3000:3000 -v "$(pwd)/data:/app/data"
ghcr.io/hoshinosuzumi/chronoframe:latestLenguaje del código: PHP (php)
La imagen también está en Docker Hub como hoshinosuzumi/chronoframe, y conviene fijar una versión concreta en lugar de latest en producción. Tras arrancar, en http://localhost:3000 un asistente crea el administrador y configura el almacenamiento; para disco local la ruta es /app/data/storage. El token del mapa puede añadirse después. El volumen ./data es crítico: guarda la base de datos, la configuración, el secreto de sesión y, con almacenamiento local, las propias fotos, así que debe entrar en el plan de copias. Para un despliegue público, el proyecto pide HTTPS, normalmente con un proxy inverso delante.
Almacenamiento, formatos y privacidad
Además del disco local, ChronoFrame trabaja con servicios compatibles con S3 y con OpenList, y permite definir URL de CDN desde el panel. Admite JPEG, PNG, WebP, GIF, BMP, TIFF y HEIC/HEIF. Para que una Live Photo de Apple se empareje, la imagen y el vídeo MOV deben compartir nombre, como IMG_1234.heic e IMG_1234.mov, sin importar cuál se suba primero.
Hay un matiz de privacidad que la documentación señala: las contraseñas de álbum controlan el acceso a través de ChronoFrame, pero si el bucket S3, OpenList o la CDN exponen URL públicas de las imágenes, el control de acceso también hay que configurarlo en ese servicio. También conviene recordar que los datos EXIF pueden incluir coordenadas GPS, útiles para el mapa pero sensibles en fotos tomadas en casa. Quien no quiera mantener un servidor tiene ChronoFrame Cloud, la versión alojada del mismo proyecto.
Preguntas frecuentes
¿Qué licencia tiene ChronoFrame?
AGPL-3.0-only para la aplicación, tanto autoalojada como en SaaS. Dos paquetes internos siguen con licencia MIT.
¿Qué debo incluir en las copias de seguridad?
El directorio montado en /app/data, que contiene la base de datos, la configuración, el secreto de sesión y las fotos si se usa almacenamiento local.
¿Cómo se suben las Live Photos de un iPhone?
Hay que subir la imagen y el vídeo MOV con el mismo nombre de archivo; ChronoFrame los empareja automáticamente.
¿Los álbumes con contraseña son totalmente privados?
Solo dentro de ChronoFrame. Si el almacenamiento S3 o la CDN publican URL abiertas, hay que restringir el acceso también en ese servicio.
Fuentes:







