HoshinoSuzumi/chronoframe

O que é?

Recursos principais

• 01Extração automática de EXIF, geração de prévias e identificação do local de captura após o upload.
• 02Associação de Live Photos e Motion Photos, com reprodução ao passar o cursor ou pressionar e segurar.
• 03Zoom WebGL e renderização em blocos para imagens grandes.
• 04Álbuns com opções para reordenar, ocultar e proteger por senha.
• 05Visualização de mapa com MapLibre ou Mapbox e opção de idioma dos nomes de lugares.
• 06Armazenamento em disco local, serviços compatíveis com S3 ou OpenList.

Casos de uso

• Publicar um portfólio fotográfico pessoal no próprio servidor.
• Compartilhar álbuns protegidos por senha com familiares ou clientes.
• Navegar por uma biblioteca de fotos usando a localização no mapa.
• Manter fotos em um bucket S3 e servi-las por meio de uma interface de galeria.

Início rápido

1. 1

   Crie o docker-compose.yml com a definição do serviço ChronoFrame

2. 2

   Inicie o contêiner em segundo plano

   docker compose up -d
3. 3

   Acesse http://localhost:3000 e conclua o assistente de configuração para criar um administrador e escolher o armazenamento

Antes de usar

• !A implantação com Docker é recomendada; para executar a partir do código-fonte, é necessário ter Node.js 22 e pnpm 10.34.6.
• !Implantações públicas devem ser servidas por HTTPS atrás de um proxy.
• !Alguns recursos dependem de um token de mapa (MapLibre/Mapbox) e de serviços opcionais, como S3 ou OpenList.

Tópicos

Perguntas frequentes

O que é chronoframe?

Galeria de fotos self-hosted que extrai EXIF, identifica locais de captura, reproduz Live Photos e oferece álbuns e uma visualização de mapa. ChronoFrame é uma galeria de fotos self-hosted para publicar suas próprias fotos. Após o upload, extrai metadados EXIF, gera prévias e identifica locais de captura por geocodificação reversa. Os visitantes podem navegar por data, álbum ou mapa e ampliar imagens grandes com um visualizador WebGL.

chronoframe é gratuito? Qual é a licença?

chronoframe é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

chronoframe ainda é mantido?

Manutenção ativa. O último commit de chronoframe foi em 21 de out. de 2026.

Para que posso usar chronoframe?

Publicar um portfólio fotográfico pessoal no próprio servidor. Compartilhar álbuns protegidos por senha com familiares ou clientes. Navegar por uma biblioteca de fotos usando a localização no mapa. Manter fotos em um bucket S3 e servi-las por meio de uma interface de galeria.

Como instalar chronoframe?

Crie o docker-compose.yml com a definição do serviço ChronoFrame Inicie o contêiner em segundo plano: docker compose up -d Acesse http://localhost:3000 e conclua o assistente de configuração para criar um administrador e escolher o armazenamento

Onde consigo chronoframe?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/HoshinoSuzumi/chronoframe