[English](../README.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | Português | [Русский](README.ru.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md)
Lap é um gerenciador de fotos de código aberto e local-first, projetado para navegar em álbuns de família, encontrar fotos antigas rapidamente e gerenciar grandes bibliotecas de mídia pessoal offline.
É uma alternativa focada na privacidade aos serviços de fotos na nuvem: sem upload forçado, busca por IA local, fluxo de trabalho centrado em pastas e gratuito para usar.
## Baixar Lap
Abra a [página de lançamentos recentes](https://github.com/julyx10/lap/releases/latest) e baixe o arquivo que corresponde ao seu sistema:
| Plataforma | Pacote | Nota |
| :-- | :-- | :-- |
| **macOS (Apple Silicon / Intel)** | `_aarch64.dmg` / `_x64.dmg` | Notarizado pela Apple |
| **Windows 10/11 (x64 / ARM64)** | `_x64_en-US.msi` / `_arm64_en-US.msi` | Não assinado — se o SmartScreen bloquear o download, clique em **Manter mesmo assim** |
| **Linux (x64 / ARM64)** | `_amd64.deb` / `_arm64.deb` | Para distribuições baseadas em Debian (Ubuntu, Debian, Linux Mint, etc.) |
| **Linux (x64 / ARM64)** | `_amd64.AppImage` / `_aarch64.AppImage` | Torne o arquivo executável e clique duas vezes para iniciar |
### macOS com Homebrew
```bash
brew tap julyx10/lap
brew install --cask lap
```
## Capturas de tela
## Por que Lap
- **Local-first por design**: suas fotos ficam no seu próprio disco, sem conta na nuvem ou upload obrigatório.
- **Sem aprisionamento de biblioteca**: trabalhe diretamente com suas pastas existentes em vez de importar tudo para um banco de dados fechado.
- **Ferramentas privadas de IA**: busca, similaridade, tags inteligentes e recursos de rostos rodam localmente na sua máquina.
- **Feito para grandes coleções**: otimizado para navegar e organizar bibliotecas com mais de 100 mil arquivos.
- **Código aberto e gratuito**: sem assinatura, sem ecossistema obrigatório e com código que você pode inspecionar.
## Recursos
- **Navegação flexível** por data, pasta, local, câmera, lente, tags, avaliações e rostos, com ordem aleatória e filtro de imagens pequenas.
- **Mapa interativo** para explorar fotos e vídeos geolocalizados em grupos que seguem os filtros atuais.
- **Álbuns inteligentes** para salvar visualizações baseadas em regras com agrupamento e ordenação personalizados.
- **Coleções e tags** para organizar arquivos selecionados em lote sem mover ou duplicar os originais.
- **Busca com IA local** por texto, similaridade visual, temas e agrupamento de rostos, com busca opcional em mais de 50 idiomas.
- **Apple Live Photos e Google Motion Photos** com reprodução do movimento e um filtro comum nos álbuns inteligentes.
- **Pares RAW + JPEG/HEIC** exibidos como um único item, mantendo os arquivos associados juntos durante as operações.
- **Miniaturas e prévias RAW configuráveis** usando renderização RAW ou a prévia incorporada da câmera.
- **Fluxo baseado em pastas** com várias bibliotecas, importação por arrastar e soltar ou copiar e colar, sincronização e operações seguras com arquivos.
- **Importação organizada por data** em pastas por dia, mês, ano ou uma única pasta, preservando os nomes originais e ignorando duplicatas.
- **Ferramentas de seleção e comparação** com um visualizador de imagens de quatro painéis.
- **Limpeza de duplicatas** com resumo do espaço recuperável e remoção em lote entre grupos.
- **Visualização personalizável** com miniaturas de até 1024 px, tamanho da grade e cantos ajustáveis, além de prévia rápida ou janelas separadas.
- **Integração com o desktop** com vários aplicativos externos e seleção de papel de parede no macOS, Windows e GNOME Linux.
- **Edição integrada** para cortar, girar, inverter, redimensionar e fazer ajustes básicos.
- **Amplo suporte a formatos** para mais de 60 formatos de fotos, RAW e vídeo.
## Metadados, coleções e movimentação de arquivos
O Lap é centrado em pastas, mas nem todas as informações exibidas nele estão incorporadas ao arquivo original. Essa distinção é importante se você também gerencia as mesmas pastas no Finder, Explorer ou em outro aplicativo de fotos.
### O que permanece com o arquivo
- Suas fotos e vídeos originais permanecem sempre como arquivos comuns em suas pastas existentes.
- Metadados já incorporados a um arquivo, como data de captura EXIF, câmera, lente, GPS e orientação, são lidos desse arquivo quando o Lap o indexa.
- Salvar uma edição de imagem integrada grava a imagem resultante no destino escolhido.
- Quando você renomeia, move, copia ou exclui arquivos **no Lap**, ele atualiza simultaneamente seu catálogo local. Ele também mantém juntos os recursos agrupados compatíveis, como componentes de Apple Live Photo, arquivos auxiliares AAE e pares RAW + JPEG/HEIC ativados.
### O que o Lap armazena localmente
As informações a seguir são dados de biblioteca do Lap. Elas são armazenadas no banco de dados local ou na configuração da biblioteca do Lap, e não são gravadas em EXIF, IPTC ou arquivos auxiliares XMP:
- Coleções, tags, comentários, favoritos, classificações e estados de seleção (Selecionadas e Rejeitadas)
- Álbuns inteligentes e suas regras, agrupamento, ordenação e ordem
- Dados de pesquisa por IA, dados faciais, miniaturas e outros dados de índice ou cache
Esses dados não acompanham o arquivo quando ele é copiado, exportado ou movido para fora do Lap, nem ficam automaticamente disponíveis para outros aplicativos.
### Trabalhar com arquivos fora do Lap
O Lap pode reexaminar pastas e detectar muitas alterações no sistema de arquivos. No entanto, alterações feitas fora do Lap — como renomear, mover, substituir ou copiar arquivos — podem afetar a organização armazenada apenas no Lap.
Para obter resultados mais confiáveis, renomeie e mova arquivos no Lap quando usar coleções, tags, comentários, favoritos, classificações ou estados de seleção. Se também gerencia arquivos fora do Lap, mantenha um backup do banco de dados e da configuração do Lap junto com suas fotos. Você pode gerenciar o local do banco de dados e criar um backup em **Configurações → Armazenamento**.
Excluir o banco de dados ou a configuração do Lap remove essa organização local e os dados de índice, mas não exclui seus arquivos de mídia originais.
## Desinstalar Lap
O Lap trabalha diretamente com suas pastas de fotos existentes. Desinstalar o Lap ou excluir seus arquivos de banco de dados e cache **não** exclui suas fotos originais.
A desinstalação padrão remove o aplicativo. Para remover completamente o Lap, feche o Lap primeiro, desinstale o aplicativo e depois exclua o banco de dados local, o cache de miniaturas e os arquivos de configuração usando os comandos da sua plataforma.
### macOS
Se você instalou o Lap com o Homebrew:
```bash
brew uninstall --cask lap
```
Para uma instalação manual, feche o Lap e mova `Lap.app` da pasta `Applications` para a Lixeira.
Para remover todos os arquivos de banco de dados, cache e configuração do Lap:
```bash
rm -rf "$HOME/Library/Application Support/com.julyx10.lap" \
"$HOME/Library/Caches/com.julyx10.lap" \
"$HOME/Library/WebKit/com.julyx10.lap"
rm -f "$HOME/Library/Preferences/com.julyx10.lap.plist"
```
### Windows
Abra **Configurações > Aplicativos > Aplicativos instalados**, encontre **Lap** e selecione **Desinstalar**.
Depois abra o PowerShell e remova todos os arquivos de banco de dados, cache e configuração do Lap:
```powershell
Remove-Item -Recurse -Force -ErrorAction SilentlyContinue "$env:LOCALAPPDATA\com.julyx10.lap"
Remove-Item -Recurse -Force -ErrorAction SilentlyContinue "$env:APPDATA\com.julyx10.lap"
```
### Linux
Para instalações DEB, desinstale o pacote:
```bash
sudo apt remove lap
```
Para instalações AppImage, feche o Lap e exclua o arquivo `.AppImage` baixado.
Depois remova todos os arquivos de banco de dados, cache e configuração do Lap:
```bash
rm -rf "$HOME/.local/share/com.julyx10.lap" \
"$HOME/.cache/com.julyx10.lap" \
"$HOME/.config/com.julyx10.lap"
```
Se você selecionou um diretório personalizado para o banco de dados nas configurações do Lap, exclua esse diretório separadamente após confirmar que ele contém apenas arquivos de banco de dados do Lap.
## Compilar a partir do código fonte
Requisitos: Node.js 20+, pnpm, Rust estável.
```bash
# Dependências do sistema macOS
xcode-select --install
brew install nasm pkg-config autoconf automake libtool cmake
# Dependências do sistema Linux
# sudo apt install libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev \
# patchelf nasm clang pkg-config autoconf automake libtool cmake
# Clonar e compilar
git clone --recursive https://github.com/julyx10/lap.git
cd lap
git submodule update --init --recursive
cargo install tauri-cli --version "^2.0.0" --locked
./scripts/download_models.sh # Windows: .\scripts\download_models.ps1
./scripts/download_ffmpeg_sidecar.sh # Windows: .\scripts\download_ffmpeg_sidecar.ps1
cd src-vite && pnpm install && cd ..
cargo tauri dev
```
## Formatos Suportados
O Lap suporta mais de 60 formatos de foto, RAW e vídeo.
| Tipo | Formatos |
| :--- | :--- |
| Imagens | JPG/JPEG/JFIF, PNG, GIF, BMP, TIFF, WebP, HEIC/HEIF/HIF, AVIF, JXL, PSD, EXR, HDR/RGBE, TGA, JPEG 2000 (JP2/J2K/J2C/JPC/JPF/JPX), DDS, DPX, QOI |
| Fotos RAW | CR2, CR3, CRW, NEF, NRW, ARW, SRF, SR2, RAF, RW2, ORF, PEF, DNG, SRW, RWL, MRW, 3FR, MOS, DCR, KDC, ERF, MEF, RAW, MDC |
| Vídeos | MP4, MOV, M4V, MKV, AVI, FLV, TS/M2TS, WMV, WebM, 3GP/3G2, F4V, VOB, MPG/MPEG, ASF, DIVX e mais. A reprodução H.264 é suportada em todas as plataformas, com processamento de compatibilidade automático quando a reprodução nativa não estiver disponível. HEVC/H.265 e VP9 são suportados nativamente no macOS. |
### Reprodução de vídeo no Linux
O Lap usa os plugins GStreamer do sistema para reproduzir vídeos, inclusive no AppImage. Se os vídeos não forem reproduzidos no Ubuntu, Debian ou Linux Mint, instale:
```bash
sudo apt install gstreamer1.0-libav gstreamer1.0-plugins-good
```
## Arquitetura
- Core: Tauri + Rust
- Frontend: Vue + Vite + Tailwind CSS
- Dados: SQLite
### Bibliotecas Principais
| Biblioteca | Finalidade |
| :-- | :-- |
| [LibRaw](https://github.com/LibRaw/LibRaw) | Decodificação de imagem RAW e extração de miniaturas |
| [libheif](https://github.com/strukturag/libheif) | Decodificação de imagem HEIC/HEIF/HIF e geração de pré-visualização |
| [libjpeg-turbo](https://libjpeg-turbo.org/) | Decodificação rápida de JPEG e geração de miniaturas |
| [FFmpeg](https://ffmpeg.org/) | Processamento de vídeo e geração de miniaturas |
| [Video.js](https://videojs.com/) | Interface de reprodução de vídeo multiplataforma |
| [ONNX Runtime](https://onnxruntime.ai/) | Mecanismo de inferência de modelo de IA local |
| [CLIP](https://github.com/openai/CLIP) | Busca de similaridade imagem-texto |
| [InsightFace](https://github.com/deepinsight/insightface) | Detecção e reconhecimento facial |
| [Leaflet](https://leafletjs.com/) | Mapa interativo para fotos com geo-tags |
| [daisyUI](https://daisyui.com/) | Biblioteca de componentes de interface do usuário |
## Licença
GPL-3.0-ou-posterior. Veja [LICENSE](../LICENSE).
## Privacidade
Consulte a [Política de Privacidade](../PRIVACY.md) para saber mais sobre o tratamento de dados e os serviços online opcionais.
