README.pt.md

TrID UI

English • Deutsch • Español • Français • Italiano • 日本語 • Polski • Português • Русский • 简体中文

O TrID UI é um aplicativo desktop leve que fornece uma interface amigável para o TrID, uma poderosa ferramenta para escanear e analisar arquivos. Com o TrID UI, você pode selecionar ou arrastar arquivos para a tela inicial para iniciar varreduras locais e detectar tipos de arquivo não reconhecidos.

O aplicativo usa uma implementação nativa em Go do algoritmo de identificação de arquivos TrID, oferecendo detecção rápida e precisa sem dependências externas.

Tip

Baixe o TridUI na página de releases

Recursos

• 🚀 Varredura rápida baseada em Go nativo
• 🎯 Identificação precisa de tipos de arquivo usando definições TrID
• 💻 Aplicativo multiplataforma (Windows, macOS, Linux) |- 🔒 Processamento 100% local – nenhum dado sai do seu computador
• 🎨 Interface moderna e intuitiva
• 📊 Resultados detalhados com pontuações de confiança
• 🔄 Suporte a arrastar e soltar arquivos
• 🔁 Atualizações automáticas de definições com um clique
• 📅 Acompanhe a data da última atualização e a contagem de definições

Sumário

Clique para expandir

• Recursos
• Sumário
• Demonstração e capturas
  • Vídeos de demonstração
  • Capturas
• Configuração
  • Pré-requisitos
    • Opção 1: Download automático (Recomendado)
    • Opção 2: Instalação manual
  • Compilar a partir do código-fonte
• Uso
• Detalhes técnicos
  • Arquitetura
  • Implementação do scanner TrID
• Licença e atribuição
• Contribuindo
  • Traduções

Demonstração e capturas

Vídeos de demonstração

Clique para expandir

demo.mp4

first.install.mp4

scan.mp4

unknown.mp4

settings.mp4

about.mp4

top.bar.mp4

Capturas

Mostrar mais

Configuração

Tip

Você encontra binários pré-compilados na página de releases.

Pré-requisitos

O aplicativo pode baixar e atualizar automaticamente o arquivo de definições do TrID.

Opção 1: Download automático (Recomendado)

1. Inicie o TrID UI
2. Abra as Configurações
3. Clique em “Download Definitions” ou “Check for Updates”
4. O app fará o download e instalará as últimas definições automaticamente

Opção 2: Instalação manual

1. Baixe o arquivo de definições do TrID (triddefs.trd) de Mark0.net
2. Coloque o triddefs.trd no diretório de dados do aplicativo:
   • Windows: %APPDATA%\TridUI\triddefs.trd
   • macOS: ~/Library/Application Support/TridUI/triddefs.trd
   • Linux: ~/.local/share/TridUI/triddefs.trd

Você pode usar o botão “Open App Dir” nas Configurações para abrir a pasta correta.

Compilar a partir do código-fonte

📖 Documentação completa de build: veja build/README.md para instruções detalhadas e solução de problemas.

Build rápido:

# Windows
.\build\build-windows.bat

# macOS
chmod +x build/build-darwin.sh && ./build/build-darwin.sh

# Linux
chmod +x build/build-linux.sh && ./build/build-linux.sh

O que os scripts fazem:

• ✅ Validam pré-requisitos (Go 1.22+, Wails CLI, Node.js, pnpm)
• ✅ Checam dependências do sistema
• ✅ Detectam ferramentas opcionais (UPX, NSIS, create-dmg)
• ✅ Detectam arquitetura automaticamente
• ✅ Criam pacotes distribuíveis

Requisitos mínimos:

• Go 1.22+ • Node.js 20+ • pnpm 10+ • Wails CLI

Instalar Wails CLI:

go install github.com/wailsapp/wails/v2/cmd/wails@latest

Locais de saída:

• Windows: build/bin/windows/TridUI-win-{arch}.exe
• macOS: build/bin/darwin/TridUI-macOS-{arch}.dmg (+ .app, .zip)
• Linux: build/bin/linux/TridUI-linux-{arch}

Uso

1. Inicie o TrID UI
2. Clique ou arraste e solte um arquivo na interface
3. Veja os resultados com pontuações de confiança
4. A melhor correspondência aparece destacada no topo
5. Outras correspondências possíveis aparecem abaixo

Detalhes técnicos

Arquitetura

• Backend: Go (framework Wails)
• Frontend: SvelteKit + TypeScript + DaisyUI (& Tailwind CSS)
• Motor TrID: Implementação pura em Go (pacote /trid)

Implementação do scanner TrID

O scanner TrID (/trid/trid.go) é uma implementação em Go “clean-room” que:

• Analisa arquivos TRD (definições TrID) conforme a especificação binária
• Realiza correspondência de padrões em offsets especificados
• Suporta correspondência de strings para maior precisão
• Calcula pontuações de confiança baseadas nos pesos dos padrões
• Retorna resultados ranqueados com informações detalhadas

A especificação do formato TRD está em Mark0.net.

Licença e atribuição

TrID UI é software open-source sob licença GNU AGPLv3. A UI foi desenvolvida por Cufiy (aka JMcrafter26) e é baseada no TrID de Marco Pontello. Consulte o arquivo LICENSE para mais detalhes.

O scanner trid.go é uma implementação “clean-room” em Go por JMcrafter26, sob GNU AGPLv3.

O ícone do app é baseado no ícone “eye” do icons8.com.

Contribuindo

Contribuições são bem-vindas! Para contribuir com o TrID UI, faça fork do repositório e envie um pull request. Para mudanças maiores, abra primeiro uma issue para discussão.

Traduções

O TrID UI precisa da sua ajuda para alcançar mais pessoas! As traduções atuais são geradas por máquina e podem conter imprecisões.

Para contribuir com traduções:

1. Faça fork do repositório
2. Crie um branch para a tradução
3. Adicione seus arquivos no diretório translations
4. Envie um pull request

Obrigado por ajudar a tornar o TrID UI acessível para mais usuários!