diff --git a/README.md b/README.md index 5ee56db..a8891c2 100644 --- a/README.md +++ b/README.md @@ -2,10 +2,12 @@

Guará

Free file recovery for hard drives, SSDs and USB sticks.
Terminal and graphical interface · Windows, Linux and macOS · read-only on the source.

-

What it supports · Terminal · Architecture · Roadmap · Changelog

+

What it supports · Interface · Terminal · Architecture · Roadmap · Changelog

English · Português

+

The Guará explorer showing recovered photos grouped by month, with a sidebar to filter and a details panel on the right
The real interface running on a synthetic test image (generated photos, no real data).

+ --- In a single scan, Guará does what tools like Recuva, PhotoRec, TestDisk and Disk Drill do separately: @@ -65,7 +67,9 @@ Other commands (`inspect`, `health`, `hash`, `search`, `export`, `report`, `veri ## Graphical interface -A desktop app (Tauri) in the style of a file manager, designed for when Guará finds thousands of items. The same front end runs in the browser with `guara ui`. +A desktop app (Tauri) in the style of a file manager, designed for when Guará finds thousands of items. The same front end runs in the browser with `guara ui`. More screenshots and details in **[docs/interface.md](docs/interface.md)**. + +

The explorer in the dark theme Settings with the language selector

- **Thumbnail grid** or **list**, grouping by day or month and virtual scrolling for tens of thousands of files. - **Sidebar navigation** by type, real photo date (EXIF), folder, camera, confidence and GPS, with an option to hide duplicates. diff --git a/README.pt-BR.md b/README.pt-BR.md index 7247e35..4c41f1f 100644 --- a/README.pt-BR.md +++ b/README.pt-BR.md @@ -2,10 +2,12 @@

Guará

Recuperação de arquivos livre e gratuita para HD, SSD e pendrive.
Terminal e interface gráfica · Windows, Linux e macOS · somente leitura na origem.

-

O que suporta · Terminal · Arquitetura · Roadmap · Changelog

+

O que suporta · Interface · Terminal · Arquitetura · Roadmap · Changelog

English · Português

+

O explorador do Guará mostrando fotos recuperadas agrupadas por mês, com a barra lateral para filtrar e o painel de detalhes à direita
A interface de verdade rodando sobre uma imagem de teste sintética (fotos geradas, sem dados reais).

+ --- O Guará junta, numa única varredura, o que ferramentas como Recuva, PhotoRec, TestDisk e Disk Drill fazem separadamente: @@ -65,7 +67,9 @@ Outros comandos (`inspect`, `health`, `hash`, `search`, `export`, `report`, `ver ## Interface gráfica -App desktop (Tauri) no estilo de um gerenciador de arquivos, pensado para quando o Guará acha milhares de itens. O mesmo front-end roda no navegador com `guara ui`. +App desktop (Tauri) no estilo de um gerenciador de arquivos, pensado para quando o Guará acha milhares de itens. O mesmo front-end roda no navegador com `guara ui`. Mais telas e detalhes em **[docs/pt-BR/interface.md](docs/pt-BR/interface.md)**. + +

O explorador no tema escuro Configurações com o seletor de idioma

- **Grade de miniaturas** ou **lista**, agrupamento por dia ou mês e rolagem virtual para dezenas de milhares de arquivos. - **Navegação lateral** por tipo, data real da foto (EXIF), pasta, câmera, confiança e GPS, com opção de ocultar duplicadas. diff --git a/docs/architecture.md b/docs/architecture.md index ed205ea..c46dd1e 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -76,7 +76,9 @@ The interface is a single page (`apps/gui/ui`). There are two ways to run it: - **Desktop app (Tauri):** the window loads the page and talks to the core directly. - **`guara ui`:** the binary starts a token-protected server on `127.0.0.1` and opens the browser. -Because the front end is the same, everything that exists in one exists in the other. +Because the front end is the same, everything that exists in one exists in the other. See [interface.md](interface.md) for what it looks like. + +

The Guará explorer

## Design decisions diff --git a/docs/img/explorer-dark-en.png b/docs/img/explorer-dark-en.png new file mode 100644 index 0000000..9c9fb56 Binary files /dev/null and b/docs/img/explorer-dark-en.png differ diff --git a/docs/img/explorer-dark-pt.png b/docs/img/explorer-dark-pt.png new file mode 100644 index 0000000..e372b4a Binary files /dev/null and b/docs/img/explorer-dark-pt.png differ diff --git a/docs/img/explorer-light-en.png b/docs/img/explorer-light-en.png new file mode 100644 index 0000000..b477534 Binary files /dev/null and b/docs/img/explorer-light-en.png differ diff --git a/docs/img/explorer-light-pt.png b/docs/img/explorer-light-pt.png new file mode 100644 index 0000000..58dfe84 Binary files /dev/null and b/docs/img/explorer-light-pt.png differ diff --git a/docs/img/settings-language-en.png b/docs/img/settings-language-en.png new file mode 100644 index 0000000..998654d Binary files /dev/null and b/docs/img/settings-language-en.png differ diff --git a/docs/img/settings-language-pt.png b/docs/img/settings-language-pt.png new file mode 100644 index 0000000..df3d82d Binary files /dev/null and b/docs/img/settings-language-pt.png differ diff --git a/docs/interface.md b/docs/interface.md new file mode 100644 index 0000000..131411e --- /dev/null +++ b/docs/interface.md @@ -0,0 +1,36 @@ +# Graphical interface + +[English](interface.md) · [Português](pt-BR/interface.md) + +Guará has a desktop app (Tauri) and the same front end in the browser with `guara ui`. Everything below exists in both. + +

The Guará explorer showing recovered photos grouped by month, with a sidebar to filter and a details panel on the right

+ +## The explorer + +After a scan, results open in a file-manager style explorer built for thousands of items: + +- **Left:** navigation by type, real photo date (EXIF, by year and month), folder, camera, confidence and GPS, with an option to hide small files and duplicates. +- **Center:** thumbnail grid or list, grouped by day or month, with virtual scrolling. A filter chip shows what is active and clears it in one click. +- **Right:** details panel with the preview, folder, dates (taken, modified, created, accessed), camera, resolution and the file metadata. The badge shows the **confidence** of the file (high, medium or low). +- **Bottom bar:** selection count and the recovery buttons. Recovery always goes to another folder and writes a manifest with MD5, SHA-1 and SHA-256. + +Arrow keys move through the files, and Space opens the full-screen quick look. Selection works like Finder or Explorer (Ctrl, Shift, keyboard). + +## Themes + +The switch at the bottom of the sidebar offers **Auto** (follows the system), **Light** and **Dark**. The choice is saved. + +

The same explorer in the dark theme

+ +## Language + +**Settings** (the gear at the bottom of the sidebar) has a **Language** selector: **Auto** follows the system language, or you can pick **Português** or **English**. The change applies right away. The same dialog controls notifications for long tasks and online maps for photos with GPS (off by default, because it downloads OpenStreetMap tiles). + +

The Settings dialog with the Language selector set to English

+ +Error messages that come from the core, and the terminal output, are still in Portuguese. + +## About these screenshots + +They show the real interface, not a mock-up, running on a synthetic test image: 72 generated JPEGs with fake EXIF (cameras, dates, GPS) that were deleted from a FAT32 image by `scripts/make-photo-fixture.py` and found by a normal `guara scan`. No real data appears. The device name in the sidebar was replaced with a generic one. diff --git a/docs/pt-BR/arquitetura.md b/docs/pt-BR/arquitetura.md index ce7cb57..944a571 100644 --- a/docs/pt-BR/arquitetura.md +++ b/docs/pt-BR/arquitetura.md @@ -76,7 +76,9 @@ A interface é uma página só (`apps/gui/ui`). Há duas formas de rodá-la: - **App desktop (Tauri):** a janela carrega a página e fala com o núcleo diretamente. - **`guara ui`:** o binário sobe um servidor em `127.0.0.1` protegido por token e abre o navegador. -Como o front-end é o mesmo, tudo que existe em um existe no outro. +Como o front-end é o mesmo, tudo que existe em um existe no outro. Veja como ele é em [interface.md](interface.md). + +

O explorador do Guará

## Decisões de projeto diff --git a/docs/pt-BR/interface.md b/docs/pt-BR/interface.md new file mode 100644 index 0000000..2d36743 --- /dev/null +++ b/docs/pt-BR/interface.md @@ -0,0 +1,36 @@ +# Interface gráfica + +[English](../interface.md) · **Português** + +O Guará tem um app desktop (Tauri) e o mesmo front-end no navegador com `guara ui`. Tudo o que está abaixo existe nos dois. + +

O explorador do Guará mostrando fotos recuperadas agrupadas por mês, com a barra lateral para filtrar e o painel de detalhes à direita

+ +## O explorador + +Depois da varredura, os resultados abrem num explorador no estilo de um gerenciador de arquivos, pensado para milhares de itens: + +- **Esquerda:** navegação por tipo, data real da foto (EXIF, por ano e mês), pasta, câmera, confiança e GPS, com opção de ocultar arquivos pequenos e duplicadas. +- **Centro:** grade de miniaturas ou lista, agrupadas por dia ou mês, com rolagem virtual. Uma etiqueta mostra o filtro ativo e o remove com um clique. +- **Direita:** painel de detalhes com a pré-visualização, pasta, datas (tirada, modificada, criada, acessada), câmera, resolução e os metadados do arquivo. O selo mostra a **confiança** do arquivo (alta, média ou baixa). +- **Barra inferior:** quantidade selecionada e os botões de recuperação. A recuperação sempre vai para outra pasta e grava um manifesto com MD5, SHA-1 e SHA-256. + +As setas navegam pelos arquivos e a barra de espaço abre a visualização rápida em tela cheia. A seleção funciona como no Finder ou no Explorer (Ctrl, Shift e teclado). + +## Temas + +O seletor no fim da barra lateral oferece **Auto** (acompanha o sistema), **Claro** e **Escuro**. A escolha fica salva. + +

O mesmo explorador no tema escuro

+ +## Idioma + +Em **Configurações** (a engrenagem no fim da barra lateral) há o seletor **Idioma**: **Auto** acompanha o idioma do sistema, ou você escolhe **Português** ou **English**. A troca vale na hora. A mesma janela controla as notificações de tarefas longas e os mapas online das fotos com GPS (desligados por padrão, porque baixam blocos do OpenStreetMap). + +

A janela de Configurações com o seletor de Idioma

+ +As mensagens de erro que vêm do núcleo e a saída do terminal continuam em português. + +## Sobre estas telas + +Mostram a interface de verdade, não uma maquete, rodando sobre uma imagem de teste sintética: 72 JPEGs gerados com EXIF falso (câmeras, datas, GPS), apagados de uma imagem FAT32 por `scripts/make-photo-fixture.py` e encontrados por um `guara scan` normal. Nenhum dado real aparece. O nome do dispositivo na barra lateral foi trocado por um genérico.