PhotoEditor

PhotoEditor é um sistema livre (BSD 2-Clause), feito para otimizar a seleção e a edição rápida de fotos de eventos. Em vez de abrir centenas de arquivos um a um, você percorre o evento inteiro pelo teclado: descarta as fotos ruins com Del (lixeira) ou as arquiva com Backspace, aplica A (Auto) ou um preset, recorta com C, extrai uma pessoa ou objeto numa camada com S e exporta tudo de uma vez, já no formato de publicação. A edição nunca altera os originais.

Foi criado por Helvio Junior para agilizar o fluxo das coberturas fotográficas do PhotoE — da triagem logo depois do evento até a pasta pronta para publicar.

Funciona como um aplicativo normal no Windows, no macOS e no Linux: é só instalar e abrir — não precisa de internet, de navegador nem de conta. Tudo roda no seu computador, e as fotos nunca saem da pasta do evento.

Instalação

Baixe o instalador do seu sistema na página de Releases (a versão mais recente fica no topo):

Sistema	Arquivo	Como instalar
macOS (Apple Silicon — M1 ou mais novo)	PhotoEditor-<versão>-macos-arm64.dmg	abra o .dmg e arraste o PhotoEditor para Aplicativos
macOS (Intel)	PhotoEditor-<versão>-macos-x64.dmg	idem
Windows 10/11 (Intel/AMD)	PhotoEditor-<versão>-windows-x64.msi	abra o .msi; o atalho aparece no Menu Iniciar e na Área de Trabalho
Windows 11 em ARM	PhotoEditor-<versão>-windows-arm64.msi	idem
Linux x64 / arm64	PhotoEditor-<versão>-linux-*.tar.gz	descompacte e rode bin/PhotoEditor

Requisitos mínimos: macOS 14, Windows 10/11 64 bits, ou Linux com glibc 2.39 (Ubuntu 24.04).

Primeira abertura: os instaladores ainda não são assinados. No macOS, se aparecer "não foi possível verificar o desenvolvedor", vá em Ajustes do Sistema → Privacidade e Segurança → Abrir Mesmo Assim. No Windows, na tela do SmartScreen, clique em Mais informações → Executar assim mesmo. A primeira abertura também é mais lenta: o sistema verifica o app uma vez.

Para atualizar, instale a versão nova por cima — projetos e preferências são mantidos.

Primeiros passos

A tela inicial (Projetos, no trilho à esquerda) mostra Abrir projeto, Novo projeto e os projetos recentes em cards — com a capa, o número de fotos, o tamanho e a data da última abertura; o projeto aberto leva o selo Aberto:

Um projeto é a pasta de um evento:

<pasta do evento>/
    raw/            as fotos originais (JPEG) — o editor nunca as altera
    publicar/       as fotos prontas, geradas pelo botão Exportar
      instagram/    as versões Instagram (1080 px, no formato do feed)
    archived/       as fotos arquivadas (Backspace) — fora da filmstrip e do Exportar
    deleted/        a lixeira (Del): as fotos excluídas, movidas para cá
    project_data/   o catálogo e os ajustes do evento (não mexa)

• Novo projeto: escolha a pasta do evento. Se ela tiver fotos JPEG soltas, o app cria a raw/ e move as fotos para dentro; se já for um projeto, só o abre; se estiver vazia, oferece copiar as fotos de outro lugar.
• Abrir projeto: escolha uma pasta que já tenha a raw/ (ou clique num card dos recentes). Remover um card da lista nunca apaga a pasta.
• O trilho à esquerda leva às telas do app: Projetos abre o menu do projeto (Início, novo, abrir, recentes, mostrar a pasta, fechar, Exportar, Publicar, idioma e sair — cada item com o atalho ao lado), Editor volta ao projeto aberto, Idioma troca o idioma da interface, Instagram abre a conta do Publicar e Sobre reúne o Sobre, a pasta de logs e a tela cheia. Embaixo ficam os atalhos de teclado e o tema claro/escuro.

Atalhos

Tecla	Ação
← →	foto anterior / próxima (no recorte, gira o quadro de 15 em 15°)
Backspace (Mac: ⌫)	arquiva a foto (vai para archived/)
Del (Mac: fn+⌫)	manda a foto para a lixeira (deleted/)
Ctrl/Cmd+Shift+R	restaura a foto arquivada ou da lixeira
A	Auto
C	modo recorte
S	modo seleção (camadas); S de novo conclui
L	próxima camada
I	versão Instagram da foto (cria/abre); na versão, volta à foto
[ ]	diminui / aumenta o pincel
W	conta-gotas do balanço de branco
Alt+1 … Alt+4	abas Ajustes / Níveis / Curvas / Efeitos
Ctrl/Cmd+Z	desfaz a última ação
Ctrl/Cmd+Shift+Z (ou Ctrl/Cmd+Y)	refaz o que foi desfeito
Ctrl/Cmd+D	duplica a foto (cópia virtual)
Ctrl/Cmd+E	exporta
Ctrl/Cmd+K	busca de ações (paleta de comandos)
Ctrl/Cmd+/	atalhos de teclado

Buscar ações: a caixa no centro da barra superior (ou Ctrl/Cmd+K) abre a paleta de comandos — digite parte do nome e Enter executa. Ela acha qualquer ação do app, de "recorte" e presets a idioma e tema, e mostra o atalho de cada uma; também entende o nome em inglês ("crop", "export"):

Os atalhos são editáveis: o ícone de teclado no pé do trilho lateral (ou Ctrl/Cmd+/) abre a lista de ações por grupo. + grava uma tecla nova para a ação, o × remove uma, e Restaurar tudo volta aos padrões. Uma tecla que já era de outra ação passa para a nova, e o aviso diz quem a perdeu:

Exemplos

Original e editada lado a lado, painel de edição à direita (em abas: Ajustes, Níveis, Curvas e Efeitos) e a filmstrip do evento embaixo. Na barra superior ficam a busca de ações, Desfazer/Refazer e Exportar:

Modo recorte: o quadro fica sobre a original e a editada mostra o resultado ao vivo — aqui girado a -90°, trocando paisagem por retrato sem girar a imagem:

Ajustes profissionais

O painel de edição tem quatro abas (Alt+1 a Alt+4); a aba escolhida fica salva. Tudo vale para a camada ativa, entra no histórico e no desfazer, e arrastar mostra o resultado ao vivo na Editada.

• Ajustes: o histograma RGB da Editada, com os dados da câmera (ISO, focal, abertura e velocidade); Auto e Resetar; os presets; o balanço de branco; e os sliders de luz (exposição, contraste, realces, sombras, brancos, pretos) e de cor (vibração, saturação). Os presets são botões de uma vez só: somam os valores deles aos sliders, que continuam ajustáveis um a um — nada fica "ligado". Duplo clique no nome de um slider volta a zero.
• Balanço de branco: o conta-gotas (W) transforma o cursor numa cruz sobre a Original; clique numa área que deveria ser branca ou cinza (camisa, parede, rede) e o app acha a temperatura e a matiz que a deixam neutra. Um clique e o modo sai; Esc cancela. O ajuste fino fica nos sliders Temperatura e Matiz, com o trilho colorido:

• Níveis: entrada (preto, gama e branco, sobre o histograma) e saída, para o RGB ou para cada canal (R, G, B); Auto corta as pontas do histograma do canal:

• Curvas: clique no gráfico para criar um ponto (até 16 por canal) e arraste; duplo clique, ou arrastar para fora, remove. Uma curva para o RGB e uma para cada canal, com o histograma ao fundo — aqui, um S para dar contraste:

• Efeitos: P&B, Sépia, Vintage, Fade, Matte, Vinheta e Grão, combináveis — ligue quantos quiser, e cada um ganha o seu slider de intensidade:

Camadas (seleção de objetos)

S entra no modo seleção: pinte por cima de uma pessoa ou objeto na original e ele vira uma camada, com ajustes próprios — o resto da foto fica em outra, com os dela (ex.: fundo escuro e P&B, jogador em cor). Cada traço soma à seleção; Subtrair (ou Alt) remove; [ e ] diminuem e aumentam o pincel. L passa de uma camada para a outra; sliders, presets, Auto, níveis, curvas e efeitos editam a camada ativa.

Seleção: o traço do pincel (em vermelho, sobre a original) cobre o jogador e a IA estende a seleção ao objeto inteiro sob ele:

Resultado: o jogador virou a camada Seleção 1 e mantém a cor, enquanto o Restante da foto recebeu o preset P&B — o objeto é editado separado do fundo:

A IA que reconhece o objeto roda no seu computador, sem internet e sem placa de vídeo: a primeira seleção de cada foto leva ~1,5 s e cada traço seguinte, ~0,3 s. Com Detectar o objeto (IA) desligado, o pincel seleciona exatamente a área pintada. As camadas entram no histórico, no desfazer (Ctrl/Cmd+Z), no refazer e na exportação como qualquer ajuste.

Arquivar e lixeira

Na triagem há dois destinos para a foto que não vai ser publicada:

• Arquivar (Backspace; no Mac, ⌫): a foto sai da filmstrip e do Exportar, e o JPEG vai de raw/ para archived/. Serve para a foto boa que não entra nesta publicação, mas que vale guardar.
• Lixeira (Del; no Mac, fn+⌫): a foto vai para deleted/ — das fotos ou do arquivo. Nada é apagado: a lixeira só junta o que foi descartado.

Arquivar, mandar para a lixeira e restaurar entram no desfazer (Ctrl/Cmd+Z) e no refazer.

A barra da filmstrip troca a visualização: Fotos | Arquivadas (n) | Lixeira (n). Em Arquivadas e Lixeira as fotos só são vistas, não editadas; Restaurar (Ctrl/Cmd+Shift+R) devolve a foto à filmstrip.

Na lixeira, Excluir definitivamente apaga a foto atual e Esvaziar lixeira apaga todas — o arquivo e o registro, com as cópias virtuais, as versões Instagram, o histórico, a participação em merges e o que já foi exportado em publicar/. Essas duas não têm desfazer: a confirmação pede que você digite uma palavra (ou, ao esvaziar, o número de fotos da lixeira) antes de liberar o botão.

Duplicar (cópia virtual)

O botão Duplicar da barra da filmstrip cria uma cópia virtual da foto: uma entrada nova no catálogo, ao lado da original, que lê o mesmo JPEG (nada é gravado em raw/) e tem ajustes, crop e camadas próprios — começando pelos da foto duplicada. Serve para ter duas versões da mesma foto (ex.: uma em cor e outra em P&B, ou dois cortes).

O Exportar grava a cópia como publicar/<nome>_copy.jpg (_copy2, _copy3...). Excluir a cópia só a tira do catálogo; excluir a original tira as cópias da filmstrip junto (desfazer traz tudo de volta). Ctrl/Cmd+Z desfaz a duplicação.

Instagram

Conectar a conta: o item Instagram do trilho lateral abre as configurações do Instagram. Entre com usuário e senha; se a conta tiver verificação em duas etapas, ou se o Instagram pedir para confirmar o acesso, a tela pede o código. O app guarda só a sessão em ~/.photoe/ — nunca a senha — e ela vale para todos os eventos. Na mesma tela fica o modelo da legenda, com os campos {event} (nome da pasta do evento, sem a data), {date}, {photos} e {hashtag}.

O login é o do app do celular, fora da API oficial da Meta (que só aceita fotos hospedadas na internet). O Instagram pode pedir confirmação ou limitar a conta por um tempo; publicar num ritmo normal evita isso.

Editar para o Instagram: tecle I (ou o ícone do Instagram na barra da filmstrip) numa foto. O app cria a versão Instagram dela — uma cópia virtual com todos os ajustes, camadas e o merge que a foto já tem — e a abre no modo recorte, com o quadro preso aos formatos que o feed aceita: 4:5 (retrato), 1:1 ou 1,91:1 (paisagem). Escolha o formato no painel; o resto do painel funciona como sempre. Em 4:5 e 1:1 o quadro gira até 45° (só endireita); no 1,91:1 gira até 90°, como no recorte normal — passando de 45° ele deita e o recorte fica vertical (1:1,91). Esse formato é exportado, mas o feed não aceita: o painel avisa e o Publicar não deixa enviá-lo. Aqui, a versão 4:5 de uma foto: o quadro retrato sobre a original e, à direita, o recorte que vai para o feed:

I de novo volta à foto; na foto, I abre a versão que já existe. A versão não aparece na filmstrip — clicar numa foto ou andar com as setas abre sempre a foto, nunca o editor do Instagram; a foto que tem versão leva o ícone do Instagram no canto. Dentro da versão, Del a exclui (tira a foto da seleção do Instagram).

Exportar grava as versões em publicar/instagram/ com 1080 px de largura (1080×1350, 1080×1080 ou 1080×566), e não na raiz de publicar/.

Publicar: o botão Publicar da barra da filmstrip abre o envio: escolha as versões (até 10 — mais de uma vira carrossel, na ordem da filmstrip), revise a legenda — já preenchida com os dados do evento — e publique. O que vai para o Instagram é exatamente o arquivo de publicar/instagram/.

Exportar

O botão Exportar, no canto superior direito (ou Ctrl/Cmd+E, ou Projetos → Exportar…), grava as fotos ativas, com os ajustes, recortes, camadas e merges, em publicar/; as versões Instagram vão para publicar/instagram/. Só é regravado o que mudou desde a última exportação, e a foto excluída sai de publicar/. Fechar o diálogo não interrompe nada: a exportação segue e o botão mostra o andamento. No fim, o resumo:

Capa do evento

A estrela na barra da filmstrip marca a foto atual como capa (selo "Capa" no thumbnail; só uma por projeto — marcar outra tira a anterior; é desfazível com Ctrl/Cmd+Z). No Exportar a capa sai duas vezes em publicar/: com o nome original, como toda foto, e como capa.jpg — cópia idêntica (se a capa for base de um merge, a cópia é a do merge). Sem capa, um capa.jpg antigo é removido.

Painéis redimensionáveis

No desktop, as divisões do editor são arrastáveis: fotos × filmstrip, Original × Editada e a largura do painel de edição. Os tamanhos ficam salvos no app; duplo clique numa divisória volta ao padrão, e as setas do teclado também a movem (com ela em foco).

Merge (trajetória da bola)

Várias fotos da mesma jogada viram uma só, com o objeto de cada clique empilhado em camadas — a trajetória da bola sobre a cena parada.

1. Merge na barra da filmstrip liga a marcação: marque as fotos (a primeira, na ordem da faixa, é a base) e clique em Criar merge.
2. Na tela do merge, pinte com o pincel (S, o mesmo das camadas, com o SAM) a bola de cada foto. Só a área pintada entra no resultado. Na base, pinte a bola dela para esmaecê-la: o fundo por trás vem de uma foto seguinte, onde a bola já saiu dali.
3. Ajuste a opacidade de cada camada. Surgir (o padrão) deixa a bola da base bem clara e cada foto seguinte mais forte, até 100% na última.

Seleção da parte da imagem: com a camada IMG_5794 ativa, a original dela aparece à esquerda com a área pintada em vermelho — a bola chegando à cesta. Só esse recorte vai para o merge; o resto da foto serve apenas para alinhá-la à base. À direita, o Resultado já mostra a bola no lugar:

Camadas e opacidade: cada foto mostra como foi alinhada à base (Alinhada: -0.1, 1.8 px · 0.01° · 100.00% = deslocamento, rotação e escala) e a própria opacidade. Com Surgir, a bola da base (IMG_5788) fica a 47% e as seguintes sobem — 57%, 75% e 100% — até a da cesta, inteira. Esmaecer faz o contrário e Opacas deixa todas a 100%:

Efeito final: de volta ao editor, a base leva o selo MERGE na filmstrip e a Editada passa a ser o merge — a trajetória da bola, do arremesso até a cesta, numa foto só. Ajustes, recorte e Auto valem sobre ele, e o Exportar grava publicar/IMG_5788_merge.jpg:

Não precisa de tripé: cada foto é alinhada automaticamente à base pelo fundo — deslocamento, rotação e escala, já que a câmera na mão anda entre um clique e outro — e a exposição é igualada, para a bola de cada foto cair no lugar certo da cena.

Os originais nunca mudam. A base passa a representar o merge: no editor, a Editada mostra o merge (ajustes, crop e Auto valem sobre ele) e o Exportar grava publicar/<base>_merge.jpg. As fotos das camadas saem da filmstrip e do Exportar enquanto o merge existir. A lixeira de uma camada (Remover do merge) tira só aquela foto da composição e a devolve à filmstrip — na última camada, o merge inteiro é desfeito; Desfazer merge devolve todas.

Onde ficam seus arquivos

• As fotos e os ajustes ficam na pasta de cada evento (acima). Levar a pasta para outro computador leva o evento inteiro.
• As preferências do app (lista de projetos recentes, idioma, tamanho dos painéis, a sessão do Instagram) ficam em ~/.photoe/ — C:\Users\<você>\.photoe no Windows.
• Logs, para relatar um problema: Sobre (no trilho lateral) → Abrir pasta de logs (~/.photoe/logs/).

Para desenvolvedores

O app é C++20 + Qt 6 (QML), com OpenCV e ONNX Runtime; só a publicação no Instagram usa um pequeno auxiliar em Python. Compilar, testar e gerar os instaladores é pelo make (com Docker, sem instalar Qt na máquina):

make test        # testes
make run         # abre o app
make local       # instalador só deste sistema e arquitetura, em dist/
make help        # todos os alvos (make dmg, make windows, make linux, make dist...)

Arquitetura, empacotamento e versão estão em docs/ARCHITECTURE.md; as convenções obrigatórias do código, em CLAUDE.md. A versão anterior (Python + React) fica na branch legacy.

Licença

Distribuído sob a licença BSD 2-Clause — veja LICENSE. Criado por Helvio Junior para as coberturas do PhotoE.