SmilyOrg/photofield

O que é?

Recursos principais

• 01Interface com zoom e carregamento progressivo em várias resoluções
• 02Vários layouts, incluindo uma visualização em linha do tempo
• 03Busca semântica, detecção de rostos e marcação opcionais via photofield-ai
• 04Tratamento somente de leitura, sem interferir nos arquivos originais
• 05Indexação rápida de arquivos, com extração de EXIF e de cores predominantes em etapas posteriores
• 06Pode ser implantado como um único binário ou uma imagem Docker

Casos de uso

• Navegar por uma grande biblioteca pessoal de fotos armazenada em um NAS ou servidor doméstico
• Executar uma galeria somente de leitura sobre um diretório de fotos existente, junto com outras ferramentas
• Substituir uma visualização de linha do tempo na nuvem por uma alternativa auto-hospedada para uma única família

Início rápido

1. 1

   Execute o contêiner Docker com suas fotos montadas como somente leitura

   docker run -p 8080:8080 -v "$PWD/data:/app/data" -v "$PWD/photos:/app/photos:ro" ghcr.io/smilyorg/photofield
2. 2

   Abra http://localhost:8080 no navegador para ver a coleção de fotos

Antes de usar

• !Não é otimizado para muitos clientes simultâneos. O estado fica no servidor, então a CPU e a memória podem ficar sobrecarregadas com mais de alguns usuários.
• !Não oferece suporte a contas de usuário, autenticação nem autorização.
• !A disposição inicial de uma coleção pode demorar em CPUs lentas ou com o cache de disco frio.
• !A marcação e a detecção de rostos ainda estão em fase alfa.

Em coleções

Tópicos

Perguntas frequentes

O que é photofield?

Galeria de fotos auto-hospedada em um único binário, feita em Go e Vue para exibir muitas fotos de uma vez sem alterar os arquivos originais. Photofield é um visualizador de fotos criado para exibir o maior número possível de imagens na tela ao mesmo tempo e carregá-las rapidamente. Ele roda como um único binário estático em Go ou como uma imagem Docker e considera o sistema de arquivos a fonte da verdade. Os arquivos originais nunca são modificados, e o app mantém um cache SQLite de miniaturas e metadados. As coleções são criadas a partir de diretórios, e há um layout de linha do tempo opcional, semelhante ao do Google Photos.

photofield é gratuito? Qual é a licença?

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

photofield ainda é mantido?

Manutenção ativa. O último commit de photofield foi em 12 de out. de 2026.

Para que posso usar photofield?

Navegar por uma grande biblioteca pessoal de fotos armazenada em um NAS ou servidor doméstico Executar uma galeria somente de leitura sobre um diretório de fotos existente, junto com outras ferramentas Substituir uma visualização de linha do tempo na nuvem por uma alternativa auto-hospedada para uma única família

Como instalar photofield?

Execute o contêiner Docker com suas fotos montadas como somente leitura: docker run -p 8080:8080 -v "$PWD/data:/app/data" -v "$PWD/photos:/app/photos:ro" ghcr.io/smilyorg/photofield Abra http://localhost:8080 no navegador para ver a coleção de fotos

Onde consigo photofield?

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