Selecione o idioma / Select language:
PortuguΓͺs (BR) |
English (US)
ObservaΓ§Γ£o: Este repositΓ³rio refere-se Γ versΓ£o oficial v2026.10.19.0 do projeto Munin App. Apoie o projeto e adquira a versΓ£o para Windows por meio do link oficial: Instalar via Microsoft Store
Clique para expandir / recolher
Munin App β Leitor de Logs Massivos
VersΓ£o: v2026.10.19.0
Data tΓ©cnica desta revisΓ£o: 19 de outubro de 2026
Autor: Fernando Nillsson Cidade
Resumo
O Munin App Γ© um visualizador e analisador de arquivos de log massivos de altΓssimo desempenho para Windows 11, projetado e construΓdo nativamente em C++20 com interface grΓ‘fica moderna em Qt 6.
Projetado especificamente para eliminar o clΓ‘ssico gargalo onde editores e visualizadores convencionais congelam, demoram minutos para indexar ou esgotam a memΓ³ria RAM ao tentar abrir arquivos de centenas de megabytes a dezenas de gigabytes, o Munin App utiliza uma arquitetura estritamente virtualizada de ponta a ponta:
-
Arquivos Mapeados em MemΓ³ria Win32 (Memory-Mapped Files): leitura zero-copy sob demanda controlada diretamente pelo subsistema de paginaΓ§Γ£o do kernel do Windows NT (
CreateFileMappingWeMapViewOfFile), permitindo abrir arquivos de 1 GB, 10 GB ou centenas de gigabytes em fraΓ§Γ΅es de segundo com consumo mΓnimo de memΓ³ria fΓsica; -
IndexaΓ§Γ£o Vetorial por InstruΓ§Γ΅es SIMD (AVX2 e SSE4.2): algoritmo otimizado de escaneamento de delimitadores de linha (
\n) atingindo taxas de transferΓͺncia superiores a 3 GB/s; -
Monitoramento em Tempo Real (Live Tail): acompanhamento contΓnuo de registros anexados concorrentemente usando notificaΓ§Γ΅es assΓncronas do kernel (
ReadDirectoryChangesW) sem loops de polling; - Busca Paralela Multi-Core: partiΓ§Γ£o do arquivo em blocos distribuΓdos por todas as threads lΓ³gicas da CPU, com suporte a ExpressΓ΅es Regulares (Regex JIT), diferenciaΓ§Γ£o de maiΓΊsculas/minΓΊsculas e filtragem dinΓ’mica de linhas correspondentes;
- Histograma Temporal de Volume (Time-Slice Scanner): identificaΓ§Γ£o automΓ‘tica de carimbos de data/hora (ISO 8601) com grΓ‘fico de densidade para detecΓ§Γ£o instantΓ’nea de picos de eventos e surtos de erro;
- Inspetor Estruturado de Registros e JSON: anΓ‘lise sintΓ‘tica e exibiΓ§Γ£o em Γ‘rvore hierΓ‘rquica para logs estruturados modernos;
- Interface e Tema Adaptativo: integraΓ§Γ£o nativa com o Windows 11 (Mica, barras de tΓtulo escuras/claras DWM) e internacionalizaΓ§Γ£o dinΓ’mica em tempo de execuΓ§Γ£o entre PortuguΓͺs (Brasil) e InglΓͺs (Estados Unidos).
Funcionalidades Principais
| Recurso | DescriΓ§Γ£o TΓ©cnica |
|---|---|
| Abertura InstantΓ’nea de Logs | Abertura imediata de arquivos gigantescos sem carregamento prΓ©vio na RAM heap, utilizando mapeamento virtual de pΓ‘ginas em memΓ³ria Win32. |
| IndexaΓ§Γ£o SIMD de Linhas | Processamento vetorial de 256 bits (AVX2) e 128 bits (SSE4.2) com fallback escalar para indexar offsets de linhas a mais de 3 GB/s. |
| Indexador por Chunks (ChunkIndex) | DivisΓ£o esparsa em blocos de 64 KB com tabela de ponteiros, permitindo acesso aleatΓ³rio |
| NavegaΓ§Γ£o Virtualizada (LogView) | Tabela customizada baseada em QAbstractItemView e QTableView do Qt6, que instancia graficamente apenas as linhas visΓveis na viewport. |
| Minimapa de Densidade (MinimapScrollBar) | Barra de rolagem interativa com renderizaΓ§Γ£o de densidade de linhas e marcadores visuais de resultados de pesquisa e nΓveis de erro. |
| Monitoramento Live Tail | Modo de acompanhamento em tempo real (Ctrl+L) com rolagem automΓ‘tica sincronizada via eventos do subsistema de arquivos do Windows. |
| Busca Paralela Multithread | Mecanismo de busca (Ctrl+F) que particiona o arquivo entre todos os nΓΊcleos lΓ³gicos, com suporte a literais, regex e modo de filtragem. |
| AnΓ‘lise Temporal (Time-Slice) | Histograma de distribuiΓ§Γ£o temporal (Ctrl+T) para isolamento de perΓodos crΓticos de atividade e incidentes operacionais. |
| Inspetor de JSON e Detalhes | Painel retrΓ‘til (Ctrl+J) para inspeΓ§Γ£o de linhas complexas, formatando payloads JSON estruturados em Γ‘rvore navegΓ‘vel com realce sintΓ‘tico. |
| Gerador SintΓ©tico de Logs | Ferramenta embutida para criar arquivos sintΓ©ticos padronizados de 100 MB, 500 MB e 1 GB para testes de carga e benchmarks. |
| UtilitΓ‘rio de Terminal (CLI) | Ferramenta standalone de linha de comando (munin-app-cli.exe) para inspeΓ§Γ£o de mΓ©tricas, busca paralela e streaming de logs via terminal. |
| Tema AutomΓ‘tico Windows 11 | DetecΓ§Γ£o e alternΓ’ncia dinΓ’mica em tempo de execuΓ§Γ£o dos modos Claro e Escuro, com barra de tΓtulos nativa estilizada via Windows DWM. |
| InternacionalizaΓ§Γ£o em Tempo Real | Troca instantΓ’nea entre PortuguΓͺs (Brasil) e English (United States) sem reiniciar a aplicaΓ§Γ£o. |
| Privacidade e Soberania de Dados | OperaΓ§Γ£o 100% autΓ΄noma e offline. Nenhum dado, caminho, termo de busca ou arquivo Γ© enviado para servidores externos. |
πΈ Capturas de Tela da Interface (UI)
π DocumentaΓ§Γ£o TΓ©cnica Adicional
- π Arquitetura do Sistema: Engenharia Win32 zero-copy, SIMD AVX2/SSE4.2 e modelos virtuais Qt 6.
- π» ReferΓͺncia da Linha de Comando: ExecuΓ§Γ£o via terminal, parΓ’metros de inicializaΓ§Γ£o e utilitΓ‘rio de benchmark
MuninBench. - π‘οΈ Modelo de SeguranΓ§a e AmeaΓ§as: Garantias de integridade somente leitura, prevenΓ§Γ£o de buffer overflow e operaΓ§Γ£o 100% offline.
- βοΈ Mapeamento de Conformidade: Conformidade com NIST SP 800-92, PCI-DSS v4.0, ISO 27001, LGPD e GDPR.
- π Licenciamento e Modelo Comercial: LicenΓ§a MIT do cΓ³digo-fonte, distribuiΓ§Γ£o na Microsoft Store e liberdade total para desenvolvedores.
- π Guia do UsuΓ‘rio e OperaΓ§Γ£o: Manual operacional passo a passo para visualizaΓ§Γ£o, Live Tail e anΓ‘lise estruturada.
- π¦ Notas de LanΓ§amento: HistΓ³rico da versΓ£o, hashes SHA-256 e artefatos de distribuiΓ§Γ£o.
- π‘ SugestΓ΅es de Issues Iniciais: Propostas estruturadas para colaboraΓ§Γ£o e desenvolvimento da comunidade.
- π€ Guia de ContribuiΓ§Γ£o | π CΓ³digo de Conduta | π PolΓtica de SeguranΓ§a
Destaques TΓ©cnicos da VersΓ£o 2026.10.19.0
-
Arquitetura da Engine C++20 Desacoplada (
MuninEngine):- Isolamento completo da lΓ³gica de I/O de baixo nΓvel, indexaΓ§Γ£o vetorial e busca em uma biblioteca estΓ‘tica independente de bibliotecas grΓ‘ficas.
- Suporte a ponteiros diretos de memΓ³ria mapeada com tratamento seguro de exceΓ§Γ΅es de acesso a arquivos.
-
IndexaΓ§Γ£o Vetorial de AltΓssimo Desempenho (
SimdUtils.cpp):- DetecΓ§Γ£o automΓ‘tica de suporte a instruΓ§Γ΅es AVX2 em tempo de execuΓ§Γ£o.
- UtilizaΓ§Γ£o de registradores
__m256ie mΓ‘scaras de bits (_mm256_movemask_epi8) para localizar quebras de linha (\n) 32 bytes por ciclo de CPU. - Fallback de alta fidelidade para SSE4.2 (
_mm_movemask_epi8com 16 bytes por ciclo) e rotina escalar otimizada.
-
Busca Paralela Multi-Core (
ParallelSearch.cpp):- CriaΓ§Γ£o de pool de threads adaptado ao nΓΊmero de nΓΊcleos lΓ³gicos disponΓveis (
std::thread::hardware_concurrency()). - Cada thread processa um intervalo de blocos prΓ©-alocados de 64 KB, reduzindo a contenΓ§Γ£o de memΓ³ria e evitando bloqueios de lock contention.
- CriaΓ§Γ£o de pool de threads adaptado ao nΓΊmero de nΓΊcleos lΓ³gicos disponΓveis (
-
Monitoramento Live Tail via Win32 Nativo (
LiveTailWatcher.cpp):- Acompanhamento passivo de crescimento de arquivos por meio da API Win32
ReadDirectoryChangesWem thread dedicada. - AtualizaΓ§Γ£o contΓnua de offsets de novas linhas sem reinicializar o Γndice do arquivo jΓ‘ mapeado.
- Acompanhamento passivo de crescimento de arquivos por meio da API Win32
-
Gerenciamento de DiΓ‘logos Modeless e Z-Order Independente (
GerenciadorDialogos.cpp):- ImplementaΓ§Γ£o de janelas de diΓ‘logo independentes (
SobreDialogeManualDialog) desacopladas perante o gerenciador de janelas do sistema operacional. - Permite alternar livremente o foco e a sobreposiΓ§Γ£o (Z-Order) entre a interface principal e os diΓ‘logos abertos, garantindo mΓ‘xima usabilidade em estaΓ§Γ΅es de trabalho multi-monitor.
- ImplementaΓ§Γ£o de janelas de diΓ‘logo independentes (
-
SincronizaΓ§Γ£o Completa com o UtilitΓ‘rio Version Editor (
mocks/find_VersionEditor.cpp):- ValidaΓ§Γ£o e atualizaΓ§Γ£o automatizada e consistente de versΓ£o e data em todos os arquivos de cΓ³digo, polΓticas de privacidade, termos de uso e documentaΓ§Γ£o do projeto.
-
UtilitΓ‘rio de Linha de Comando AutΓ΄nomo (
munin-app-cli):- ExecutΓ‘vel independente para processar arquivos de log diretamente via PowerShell, CMD ou Windows Terminal sem carregar a pilha grΓ‘fica do Qt;
- Suporte completo a comandos de inspeΓ§Γ£o (
info), busca multi-core acelerada por SIMD (search), streaming ao vivo sem polling (tail) e benchmarks integrados (bench); - VinculaΓ§Γ£o com
AppExecutionAliasno pacote MSIX e instaladores Inno Setup para invocaΓ§Γ£o global em qualquer diretΓ³rio do sistema.
Atalhos de Teclado Principais
| Atalho | AΓ§Γ£o Correspondente |
|---|---|
Ctrl+O |
Abrir arquivo de log no visualizador |
Ctrl+F |
Alternar exibiΓ§Γ£o da barra de busca rΓ‘pida |
Ctrl+T |
Alternar exibiΓ§Γ£o da linha do tempo / Time-Slice |
Ctrl+J |
Alternar exibiΓ§Γ£o do inspetor de JSON estruturado |
Ctrl+L |
Ativar ou desativar o modo Live Tail (acompanhamento ao vivo) |
Ctrl+G |
Abrir diΓ‘logo de geraΓ§Γ£o de logs sintΓ©ticos de teste |
Esc |
Limpar filtros ativos de busca ou fechar painΓ©is retrΓ‘teis |
F1 |
Abrir o Manual de InstruΓ§Γ΅es completo da aplicaΓ§Γ£o |
Alt+A |
Abrir o menu "Arquivo" |
Alt+E |
Abrir o menu "Exibir" |
Alt+C |
Abrir o menu "ConfiguraΓ§Γ΅es" |
Alt+B ou Alt+S
|
Abrir o menu "Sobre" |
Requisitos do Sistema
- Sistema Operacional: Windows 10 (64-bit) versΓ£o 21H2 ou Windows 11 (64-bit, recomendado).
- Processador: Intel Core i3/i5/i7/i9 ou AMD Ryzen x64 com suporte a instruΓ§Γ΅es SSE4.2 (AVX2 altamente recomendado para mΓ‘ximo rendimento SIMD).
- MemΓ³ria RAM: 4 GB no mΓnimo (a arquitetura de arquivos mapeados em memΓ³ria requer apenas fraΓ§Γ΅es de megabytes de RAM mesmo para arquivos de dezenas de gigabytes).
- Armazenamento: 150 MB livres em disco para instalaΓ§Γ£o da distribuiΓ§Γ£o binΓ‘ria completa.
CompilaΓ§Γ£o e Build
Ferramentas NecessΓ‘rias
- CMake: versΓ£o 3.21 ou superior.
- Ninja: gerador de build de alta velocidade.
- Qt 6: Qt 6.11.1 (mΓ³dulos Core, Gui, Widgets).
-
Compiladores homologados:
- MinGW 64-bit (GCC 13.1.0+);
- Microsoft Visual C++ (MSVC 2022 v143+).
1. Build com MinGW (Preset host-qt6-mingw-release)
# Configurar o projeto com preset MinGW
cmake --preset host-qt6-mingw-release
# Compilar e executar o deploy completo do runtime
cmake --build --preset host-qt6-mingw-release --target MuninDeploy --parallelO executΓ‘vel e dependΓͺncias serΓ£o disponibilizados em:
build/build_Munin_mingw/Munin.exe- DistribuiΓ§Γ£o limpa externa:
D:\MISCELANEAS\VSCode\Munin\Munin_mingw\
2. Build com MSVC (Preset host-qt6-msvc-release)
# Configurar o projeto com preset MSVC via script de ambiente
cmd.exe /c "cmake\run_msvc.bat cmake --preset host-qt6-msvc-release"
# Compilar e executar o deploy completo do runtime
cmd.exe /c "cmake\run_msvc.bat cmake --build --preset host-qt6-msvc-release --target MuninDeploy --parallel"O executΓ‘vel e dependΓͺncias serΓ£o disponibilizados em:
build/build_Munin_msvc/Munin.exe- DistribuiΓ§Γ£o limpa externa:
D:\MISCELANEAS\VSCode\Munin\Munin_msvc\
3. UtilitΓ‘rios e Mocks (mocks/find_VersionEditor)
Para compilar e verificar o utilitΓ‘rio gerenciador de versΓ΅es:
# CompilaΓ§Γ£o dos Mocks com MSVC
cmd.exe /c "cmake\run_msvc.bat cmake --build --preset host-qt6-mocks-msvc-release --parallel"
# VerificaΓ§Γ£o de integridade dos arquivos (CLI)
build\build_Mocks_msvc\find_VersionEditor.exe --checkEstrutura do RepositΓ³rio
Munin_App_cpp/
βββ .github/ # Workflows de CI/CD do GitHub Actions e templates
β βββ workflows/build.yml # Pipeline de compilaΓ§Γ£o automatizada (MinGW e MSVC)
β βββ ISSUE_TEMPLATE/ # Templates para reporte de bugs e solicitaΓ§Γ΅es de recursos
β βββ PULL_REQUEST_TEMPLATE.md # Modelo padronizado para submissΓ£o de pull requests
βββ .vscode/ # ConfiguraΓ§Γ΅es do ambiente de desenvolvimento VS Code
β βββ tasks.json # Tarefas de compilaΓ§Γ£o individual e agregada (MinGW e MSVC)
βββ docs/ # DocumentaΓ§Γ£o tΓ©cnica modular e especificaΓ§Γ΅es de conformidade
β βββ architecture.md # Arquitetura Win32 zero-copy, SIMD AVX2/SSE4.2 e Qt6
β βββ cli-reference.md # ReferΓͺncia completa da CLI munin-app-cli e MuninBench
β βββ compliance.md # Mapeamento de conformidade NIST SP 800-92, LGPD e GDPR
β βββ licensing.md # Modelo de licenciamento MIT e autorizaΓ§Γ£o Microsoft Store
β βββ release-v2026.10.19.0.md # Notas tΓ©cnicas de lanΓ§amento, hashes SHA-256 e artefatos
β βββ security-model.md # Modelo de seguranΓ§a, anΓ‘lise de ameaΓ§as e integridade
β βββ suggested-issues.md # Backlog estruturado de issues para a comunidade
β βββ user-guide.md # Guia operacional passo a passo do usuΓ‘rio
βββ cmake/ # Scripts auxiliares de deploy, Γcones e ambiente MSVC/MinGW
β βββ deploy_optional_qt_binary.cmake # Deploy automatizado do runtime Qt6 via windeployqt
β βββ gerar_distribuicoes_limpas.ps1 # Script PowerShell de build, deploy e distribuiΓ§Γ£o limpa
β βββ run_mingw.bat / run_msvc.bat # Wrappers de inicializaΓ§Γ£o de toolchains MinGW e MSVC
β βββ windows_app_icon.rc.in # Template de recursos Win32 com Γcone da aplicaΓ§Γ£o
βββ repo/ # Scripts de instalaΓ§Γ£o Inno Setup, manifesto MSIX e assets
β βββ AppxManifest.xml # Manifesto MSIX com AppExecutionAlias para a CLI
β βββ Munin.iss # Script mestre unificado Inno Setup (MinGW/MSVC)
β βββ Munin_MinGW.iss / Munin_MSVC.iss# Instaladores dedicados para cada compilador
β βββ MANUAL_TECNICO_CONFIGURACAO_AMBIENTE_CPP_QT6.txt # Guia de setup do ambiente Qt6
β βββ limpar_artefatos_regeneraveis_qt.ps1 # HigienizaΓ§Γ£o de artefatos temporΓ‘rios e cache
β βββ LISTAGEM/ # Capturas de tela oficiais da Microsoft Store (pt_BR/en_US)
βββ mocks/ # UtilitΓ‘rios de desenvolvimento e ferramentas auxiliares
β βββ CMakeLists.txt # ConfiguraΓ§Γ£o de build dos alvos auxiliares
β βββ CompileTranslationsGUI.hpp/.cpp # Interface grΓ‘fica de compilaΓ§Γ£o de catΓ‘logos .ts -> .qm
β βββ CompileTranslationsTerminal.hpp/.cpp # Compilador de traduΓ§Γ΅es em linha de comando
β βββ find_VersionEditor.hpp/.cpp # UtilitΓ‘rio de sincronizaΓ§Γ£o e validaΓ§Γ£o de versΓ΅es
β βββ INSTRUCOES_find_VersionEditor.txt # InstruΓ§Γ΅es e escopo operacional do editor de versΓ΅es
β βββ launch_detached_gui.cmake # Script de inicializaΓ§Γ£o desacoplada de GUI
β βββ icons/ # Γcones e recursos visuais dos utilitΓ‘rios
βββ source/ # CΓ³digo-fonte principal da aplicaΓ§Γ£o
β βββ main.cpp # Ponto de entrada do executΓ‘vel Munin (GUI)
β βββ cli/ # UtilitΓ‘rio Standalone de Linha de Comando (CLI Headless)
β β βββ main_cli.cpp # Ponto de entrada de munin-app-cli.exe
β βββ engine/ # Motor de processamento de baixo nΓvel Win32/SIMD
β β βββ MemoryMappedFile.hpp/.cpp # Mapeamento de arquivos em memΓ³ria Win32 (zero-copy)
β β βββ SimdUtils.hpp/.cpp # VetorizaΓ§Γ£o AVX2/SSE4.2 para escaneamento de linhas
β β βββ ChunkIndex.hpp/.cpp # Γndice esparso por blocos virtuais de 64 KB
β β βββ LiveTailWatcher.hpp/.cpp # Monitoramento de escrita concorrente em tempo real
β β βββ ParallelSearch.hpp/.cpp # Busca paralela multithread multi-core
β β βββ TimeSliceScanner.hpp/.cpp # Parser de carimbos temporais e histograma
β β βββ TestEngine.cpp # Target de benchmark MuninBench
β βββ model/ # Modelo de dados virtualizado
β β βββ LogModel.hpp/.cpp # QAbstractTableModel sob demanda para o Qt6
β βββ ui/ # Interface grΓ‘fica Qt6 moderna e responsiva
β β βββ MainWindow.hpp/.cpp # Janela principal, orquestraΓ§Γ£o e barra de status
β β βββ LogView.hpp/.cpp # Visualizador customizado de tabela virtualizada
β β βββ LogItemDelegate.hpp/.cpp # Delegado customizado de renderizaΓ§Γ£o e realce de cΓ©lulas
β β βββ MinimapScrollBar.hpp/.cpp # Barra de rolagem com minimapa de densidade
β β βββ SearchBarWidget.hpp/.cpp # Painel de busca com regex e contadores de ocorrΓͺncias
β β βββ TimeSliceWidget.hpp/.cpp # Widget de histograma temporal interativo
β β βββ JsonInspectorWidget.hpp/.cpp# Inspetor de JSON estruturado em Γ‘rvore
β β βββ LogGeneratorDialog.hpp/.cpp # Gerador de arquivos de log sintΓ©ticos para testes
β β βββ StickyMenu.hpp/.cpp # Menus modernos com comportamento fluido
β β βββ ThemeManager.hpp/.cpp # Gerenciador de temas Claro / Escuro Windows 11
β β βββ Win32DwmHelper.hpp/.cpp # IntegraΓ§Γ£o com Windows DWM (Mica e Dark Title Bar)
β β βββ GerenciadorDialogos.hpp/.cpp# Gerenciador de diΓ‘logos desacoplados (Z-Order)
β β βββ SobreDialog.hpp/.cpp # Caixa de diΓ‘logo Sobre com histΓ³rico e licenΓ§as
β β βββ OpcoesSobre.hpp/.cpp # Seletor de opΓ§Γ΅es avanΓ§adas do diΓ‘logo Sobre
β β βββ ButtonUtils.hpp/.cpp # UtilitΓ‘rios e estilos de botΓ΅es da interface
β β βββ Manual.hpp/.cpp # DiΓ‘logo interativo do Manual de InstruΓ§Γ΅es
β βββ language/ # CatΓ‘logos e gerenciador de traduΓ§Γ£o dinΓ’mica
β β βββ GerenciadorTraducao.hpp/.cpp# Carregamento e troca dinΓ’mica de arquivos .qm
β β βββ translations/ # Arquivos de traduΓ§Γ£o (munin_pt_BR.ts/.qm, munin_en_US.ts/.qm)
β βββ assets/ # Textos informativos, termos de licenΓ§a, polΓticas e Γcones
β β βββ ABOUT/ # Textos do Sobre e histΓ³rico institucional
β β βββ CLC/ # Contratos de licenΓ§a comercial corporativa (CLC)
β β βββ COPYRIGHT/ # Avisos formais de copyright e marca registrada
β β βββ EULA/ # LicenΓ§as de uso de usuΓ‘rio final em PT-BR e EN-US
β β βββ LICENSES/ # Textos integrais das licenΓ§as upstream e componentes
β β βββ NOTICES/ # Avisos de software de terceiros e atribuiΓ§Γ΅es
β β βββ PRIVACY_POLICY/ # PolΓticas de privacidade em conformidade com LGPD/GDPR
β β βββ RELEASE/ # Notas tΓ©cnicas de lanΓ§amento oficial da versΓ£o
β β βββ icons/ # Γcones em formato .ico e .png em mΓΊltiplas resoluΓ§Γ΅es
β βββ utils/ # UtilitΓ‘rios de sistema, caminhos e logging interno
β βββ ApplicationPathUtils.hpp/.cpp # ResoluΓ§Γ£o segura de caminhos da aplicaΓ§Γ£o
β βββ CaminhoPersistenteUtils.hpp/.cpp # Gerenciamento de histΓ³rico de caminhos persistentes
β βββ LogManager.hpp/.cpp # Logging de diagnΓ³stico interno da aplicaΓ§Γ£o
βββ CMakeLists.txt # Script mestre do CMake (Targets: MuninEngine, Munin, munin-app-cli, MuninBench, MuninDeploy)
βββ CMakePresets.json # Presets de configuraΓ§Γ£o e build para MinGW e MSVC
βββ CODE_OF_CONDUCT.md # CΓ³digo de Conduta para colaboradores e comunidade
βββ CONTRIBUTING.md # Diretrizes de contribuiΓ§Γ£o, padrΓ΅es de cΓ³digo e fluxo de PR
βββ LICENSE # LicenΓ§a de cΓ³digo aberto MIT do projeto
βββ main.cpp # Ponto de entrada alternativo/raiz do projeto
βββ MANUAL.md # Manual completo de utilizaΓ§Γ£o e operaΓ§Γ£o tΓ©cnica
βββ OBSERVACAO.md # Registro do estado tΓ©cnico e arquitetural da versΓ£o
βββ README.md # DocumentaΓ§Γ£o multilΓngue oficial do repositΓ³rio
βββ SECURITY.md # PolΓtica de seguranΓ§a, reporte de vulnerabilidades e modelo de ameaΓ§as
6. DocumentaΓ§Γ£o TΓ©cnica Modular
- ποΈ Arquitetura do Sistema β Design da engine, mapeamento de memΓ³ria Win32, vetorizaΓ§Γ£o SIMD e Qt6.
- π‘οΈ Modelo de SeguranΓ§a e Integridade β Filosofia local-first, integridade de memΓ³ria virtual e prevenΓ§Γ£o ReDoS.
- π Conformidade e GovernanΓ§a β Mapeamentos NIST SP 800-92, PCI-DSS v4.0, ISO 27001, LGPD e GDPR.
- βοΈ Licenciamento e AutorizaΓ§Γ£o Comercial β Termos MIT, diretrizes Microsoft Store e autorizaΓ§Γ£o do autor.
- π Guia de OperaΓ§Γ΅es do UsuΓ‘rio β OperaΓ§Γ΅es passo a passo, busca paralela, timeline e inspetor JSON.
- βοΈ ReferΓͺncia de Linha de Comando β ParΓ’metros de execuΓ§Γ£o do Munin.exe, munin-app-cli, MuninBench e find_VersionEditor.
- π¦ Notas de VersΓ£o v2026.10.19.0 β Hashes forenses SHA-256, artefatos de instalaΓ§Γ£o e changelog.
- π‘ SugestΓ΅es de EvoluΓ§Γ£o e Issues Abertas β Backlog tΓ©cnico e melhorias sugeridas pela comunidade.
- π Manual Completo de InstruΓ§Γ΅es & ObservaΓ§Γ΅es TΓ©cnicas β DocumentaΓ§Γ£o aprofundada de engenharia.
7. LicenΓ§a e AutorizaΓ§Γ£o Comercial Expressa
Este projeto estΓ‘ licenciado sob os termos da LicenΓ§a MIT. Consulte o arquivo LICENSE para obter a Γntegra dos termos e condiΓ§Γ΅es.
7.1. DeclaraΓ§Γ£o do Autor e Liberdade para Desenvolvedores
DeclaraΓ§Γ£o do Titular dos Direitos:
Eu, Fernando Nillsson Cidade, autor e criador do Munin App, asseguro plena liberdade aos desenvolvedores sob os termos da LicenΓ§a MIT:
- DocumentaΓ§Γ£o em
source/assets/: Foi elaborada exclusivamente para comercializaΓ§Γ£o e conformidade na Microsoft Store. O autor autoriza expressamente desenvolvedores e colaboradores a realizarem alteraΓ§Γ΅es, exclusΓ΅es, adiΓ§Γ΅es e modificaΓ§Γ΅es gerais nesta documentaΓ§Γ£o e no cΓ³digo associado, fornecendo total liberdade para adaptΓ‘-los desde que respeitem as diretrizes e legislaΓ§Γ£o de seus paΓses e plataformas.- CΓ³digo-Fonte Aberto (LicenΓ§a MIT): O cΓ³digo-fonte integral estΓ‘ disponibilizado publicamente sob a LicenΓ§a MIT. Qualquer pessoa pode auditar, compilar, modificar, criar forks e gerar seus prΓ³prios pacotes livremente.
- RestriΓ§Γ£o Exclusiva sobre o BinΓ‘rio Oficial do Autor: Apenas o binΓ‘rio prΓ©-compilado e assinado oficialmente pelo autor e distribuΓdo na Microsoft Store nΓ£o possui autorizaΓ§Γ£o para comercializaΓ§Γ£o ou revenda por terceiros, tampouco para engenharia reversa (prΓ‘tica que ademais Γ© desnecessΓ‘ria, visto que o cΓ³digo-fonte integral jΓ‘ Γ© aberto neste repositΓ³rio).
7.2. FundamentaΓ§Γ£o JurΓdica da DocumentaΓ§Γ£o em source/assets/
A presenΓ§a do conjunto formal de documentaΓ§Γ£o institucional e regulatΓ³ria mantido no diretΓ³rio source/assets/ (abrangendo os mΓ³dulos ABOUT, CLC, EULA, NOTICES, PRIVACY_POLICY, LICENSES e COPYRIGHT) fundamenta-se nas seguintes exigΓͺncias regulatΓ³rias, operacionais e de mercado, operando em total viabilidade e seguranΓ§a jurΓdica:
- HabilitaΓ§Γ£o para DistribuiΓ§Γ£o Comercial e Marketplaces: Plataformas corporativas de software, lojas de aplicativos (como a Microsoft Store) e ecossistemas de distribuiΓ§Γ£o comercial B2B exigem a presenΓ§a de um Contrato de LicenΓ§a de UsuΓ‘rio Final (EULA / Application Developer Agreement - ADA) e de uma PolΓtica de Privacidade transparente para homologaΓ§Γ£o, publicaΓ§Γ£o, proteΓ§Γ£o e venda regular do produto.
- Conformidade Estrita com Leis de Privacidade (LGPD e GDPR): A PolΓtica de Privacidade e o EULA estabelecem de forma irrefutΓ‘vel e auditΓ‘vel o compromisso da arquitetura Local-First do Munin App (operaΓ§Γ£o 100% autΓ΄noma e offline, sem telemetria, sem coleta de dados cadastrais ou comportamentais e sem transmissΓ£o externa de informaΓ§Γ΅es de arquivos ou identidades), resguardando juridicamente empresas usuΓ‘rias em conformidade com a Lei Geral de ProteΓ§Γ£o de Dados (Lei nΒΊ 13.709/2018) e o GDPR da UniΓ£o Europeia.
-
AtribuiΓ§Γ£o de Terceiros e Licenciamento Upstream (LGPL v3 e DomΓnio PΓΊblico): Os diretΓ³rios
NOTICESeLICENSEScumprem rigorosamente os deveres de atribuiΓ§Γ£o e as clΓ‘usulas das licenΓ§as de componentes integrados de terceiros (em especial o framework Qt 6.11.1 sob GNU LGPL v3 e o motor embutido SQLite3 em domΓnio pΓΊblico), garantindo integridade de propriedade intelectual e conformidade de governanΓ§a corporativa. - Harmonia JurΓdica entre CΓ³digo Aberto e Uso Comercial: Os termos do EULA e do CLC regulam as condiΓ§Γ΅es operacionais, garantias e responsabilidades de suporte da aplicaΓ§Γ£o compilada distribuΓda ao usuΓ‘rio final, operando em perfeita harmonia com as liberdades outorgadas pela LicenΓ§a MIT ao cΓ³digo-fonte, conferindo seguranΓ§a jurΓdica integral tanto Γ comunidade de software livre quanto aos clientes comerciais corporativos.
Munin App β’ Β© 2026 Fernando Nillsson Cidade
8. Autor
Fernando Nillsson Cidade
Contato: linceu_lighthouse@outlook.com
GitHub: https://github.com/fernandoncidade
9. ContribuiΓ§Γ£o e Comunidade
[!NOTE] Sobre o Desenvolvimento e ContribuiΓ§Γ΅es Externas:
Este projeto Γ© concebido, desenvolvido e mantido primariamente como uma iniciativa pessoal e educacional pelo autor, que Γ© iniciante e estΓ‘ em contΓnuo aprendizado em programaΓ§Γ£o. O envio de sugestΓ΅es, abertura de Issues e submissΓ£o de Pull Requests (PRs) sΓ£o sempre bem-vindos! No entanto, ressalta-se que a anΓ‘lise de cΓ³digo, interaΓ§Γ£o em tΓ³picos tΓ©cnicos e incorporaΓ§Γ£o de contribuiΓ§Γ΅es ocorrem de forma voluntΓ‘ria e no prΓ³prio ritmo do autor. Caso um chamado ou PR demore para ser respondido ou nΓ£o seja incorporado, nΓ£o reaja com alarde ou frustraΓ§Γ£o. A licenΓ§a MIT garante a vocΓͺ total liberdade para criar um Fork independente e evoluir suas prΓ³prias versΓ΅es.
ContribuiΓ§Γ΅es sΓ£o bem-vindas! Consulte nosso Guia de ContribuiΓ§Γ£o e CΓ³digo de Conduta.
Note: This repository refers to the official v2026.10.19.0 release of the Munin App project. Support the project and get the Windows version through the official link: Install via Microsoft Store
Click to expand / collapse
Munin App β Massive Log Reader
Version: v2026.10.19.0
Technical revision date: October 19, 2026
Author: Fernando Nillsson Cidade
Summary
Munin App is a high-performance massive log file reader and analytical workbench for Windows 11, natively engineered in modern C++20 with an interactive user interface built on Qt 6.
Designed specifically to eliminate the traditional bottleneck where conventional editors and viewers freeze, take several minutes to build line indexes, or run out of memory when opening files ranging from hundreds of megabytes to tens of gigabytes, Munin App employs a fully virtualized, zero-copy architecture from disk to display:
-
Win32 Memory-Mapped Files: On-demand zero-copy paging managed directly by the Windows NT kernel memory subsystem (
CreateFileMappingWandMapViewOfFile), opening 1 GB, 10 GB, or larger files in fractions of a second with negligible physical RAM usage; -
Hardware SIMD Vectorized Indexing (AVX2 & SSE4.2): High-throughput newline scanning (
\n) achieving throughput rates exceeding 3 GB/s; -
Real-Time Live Tail Engine: Continuous tracking of concurrently appended records using kernel-level asynchronous notifications (
ReadDirectoryChangesW) without CPU polling loops; - Multi-Core Parallel Search: Partitioned chunk-based multithreaded searching across all logical CPU cores, supporting JIT Regular Expressions, case-matching, and matched-line filter modes;
- Temporal Volume Histogram (Time-Slice Scanner): Automatic ISO-8601 timestamp parsing paired with interactive density histograms to identify activity surges and error spikes immediately;
- Structured JSON & Record Inspector: Detailed syntax-highlighted hierarchy tree for modern structured JSON logs;
- Adaptive Interface & Themes: Native Windows 11 integration (Mica, DWM dark/light title bar) and runtime dynamic localization between English (United States) and PortuguΓͺs (Brasil).
Key Features
| Feature | Technical Description |
|---|---|
| Instant Log Opening | Opens massive log files in fractions of a second without buffer duplications, leveraging Win32 memory-mapped virtual paging. |
| SIMD Line Indexing | Vectorized 256-bit (AVX2) and 128-bit (SSE4.2) processing with scalar fallback to scan line delimiters at > 3 GB/s. |
| Sparse Chunk Indexer | 64 KB sparse block partitioning with offset lookups, enabling |
| Virtualized Log View | Custom table view based on Qt6's QAbstractItemView and QTableView, only instantiating rows visible within the viewport. |
| Density Minimap Scrollbar | Interactive scrollbar displaying overall log distribution, search matches, and severity markers across the entire document. |
| Live Tail Monitoring | Real-time append tracking (Ctrl+L) with smooth auto-scrolling powered by native Windows file system notifications. |
| Parallel Search Engine | Multithreaded search (Ctrl+F) dividing chunks across CPU cores, with support for exact phrases, regex, and filter mode. |
| Time-Slice Analysis | Event density histogram (Ctrl+T) allowing one-click filtering of critical operational timeframes and anomalies. |
| JSON Record Inspector | Retractable panel (Ctrl+J) dissecting structured JSON log entries into an interactive tree with one-click copying. |
| Synthetic Log Generator | Built-in test generator to create realistic 100 MB, 500 MB, and 1 GB synthetic log files for load testing and benchmarks. |
| Terminal CLI Utility | Standalone command-line executable (munin-app-cli.exe) for metadata inspection, parallel search, and live log streaming via console. |
| Windows 11 Theme Sync | Automatic runtime synchronization with Windows 11 Dark and Light modes, complete with native DWM title bar styling. |
| Runtime Retranslation | Dynamic switching between English (US) and Portuguese (BR) without requiring an application restart. |
| 100% Offline & Private | Strictly autonomous and local execution. No logs, terms, paths, or analytics are ever transmitted over the network. |
πΈ User Interface Screenshots
π Modular Technical Documentation
- π System Architecture: Win32 zero-copy design, AVX2/SSE4.2 SIMD mechanics, and Qt 6 virtual models.
- π» Command Line Reference: CLI syntax, launch arguments, and
MuninBenchbenchmark utility. - π‘οΈ Security Model & Threat Analysis: Read-only memory mapping, buffer overflow prevention, and 100% offline security.
- βοΈ Compliance Mapping: NIST SP 800-92, PCI-DSS v4.0, ISO 27001, LGPD, and GDPR log governance.
- π Licensing & Commercial Model: MIT open-source license, Microsoft Store release, and complete developer freedom.
- π User Guide & Operations Manual: Step-by-step instructions for viewing, Live Tail, and structured analysis.
- π¦ Release Notes: Release highlights, SHA-256 hashes, and distribution artifacts.
- π‘ Starter Community Issues: Curated task templates ready for contributors.
- π€ Contributing Guide | π Code of Conduct | π Security Policy
Technical Highlights of Version 2026.10.19.0
-
Decoupled C++20 Core Engine (
MuninEngine):- Clean architectural isolation of low-level I/O, SIMD algorithms, and search mechanics into an independent static library.
- Zero dependency on GUI headers in the processing engine for maximum reusability and benchmark accuracy.
-
SIMD Vector Acceleration (
SimdUtils.cpp):- Runtime CPU feature detection ensuring AVX2 instructions are executed when supported, utilizing
__m256iregisters and byte masks (_mm256_movemask_epi8) to inspect 32 bytes per clock cycle. - Full compatibility with SSE4.2 hardware (16 bytes per cycle) and a highly optimized scalar fallback.
- Runtime CPU feature detection ensuring AVX2 instructions are executed when supported, utilizing
-
Multi-Core Parallel Search (
ParallelSearch.cpp):- Dynamic worker thread pool scaled to
std::thread::hardware_concurrency(). - Work units partitioned into pre-allocated 64 KB chunks, minimizing inter-thread memory contention and lock wait states.
- Dynamic worker thread pool scaled to
-
Kernel-Level Live Tail (
LiveTailWatcher.cpp):- Passive tracking of active writes using the Windows
ReadDirectoryChangesWkernel API on a dedicated background thread. - Dynamic expansion of line offset arrays without needing to reindex previously mapped regions.
- Passive tracking of active writes using the Windows
-
Modeless Dialog Hierarchy and Z-Order Control (
GerenciadorDialogos.cpp):- Top-level modeless dialog design (
SobreDialogandManualDialog) uncoupled from the main window's window-manager hierarchy. - Enables seamless Z-order layering and focus switching between dialogs and the main viewer on multi-monitor setups.
- Top-level modeless dialog design (
-
Unified Synchronization via Version Editor (
mocks/find_VersionEditor.cpp):- Automated validation and synchronous bumping of version strings and release dates across all codebases, legal documents, and installers.
-
Standalone Command-Line Interface (
munin-app-cli):- Independent terminal utility executing high-speed log processing directly from PowerShell, CMD, or Windows Terminal without loading the Qt GUI runtime;
- Full support for inspection (
info), SIMD-accelerated parallel query (search), zero-polling live streaming (tail), and benchmarks (bench); - Integrated with
AppExecutionAliasin MSIX and Inno Setup installers for direct global execution from any directory.
Essential Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Ctrl+O |
Open a log file in the viewer |
Ctrl+F |
Toggle the quick search bar |
Ctrl+T |
Toggle the Time-Slice distribution timeline |
Ctrl+J |
Toggle the structured JSON inspector |
Ctrl+L |
Toggle Live Tail monitoring mode |
Ctrl+G |
Open the synthetic test log generator |
Esc |
Clear active search filters or close retractable panels |
F1 |
Open the Instruction Manual |
Alt+A |
Open the "File" menu |
Alt+E |
Open the "View" menu |
Alt+C |
Open the "Settings" menu |
Alt+B or Alt+S
|
Open the "About" menu |
System Requirements
- Operating System: Windows 10 (64-bit) Version 21H2 or Windows 11 (64-bit, recommended).
- Processor: Intel Core i3/i5/i7/i9 or AMD Ryzen x64 with SSE4.2 support (AVX2 recommended for optimal SIMD indexing).
- Memory (RAM): 4 GB minimum (memory-mapped architecture requires negligible RAM even when working with 10+ GB log files).
- Disk Storage: 150 MB free disk space for complete binary distribution.
Build and Compilation
Prerequisites
- CMake: version 3.21 or higher.
- Ninja: high-speed build generator.
- Qt 6: Qt 6.11.1 (Core, Gui, Widgets).
-
Supported Compilers:
- MinGW 64-bit (GCC 13.1.0+);
- Microsoft Visual C++ (MSVC 2022 v143+).
1. Building with MinGW (Preset host-qt6-mingw-release)
# Configure project using MinGW preset
cmake --preset host-qt6-mingw-release
# Compile and perform full runtime deployment
cmake --build --preset host-qt6-mingw-release --target MuninDeploy --parallelBinaries and deployed dependencies are available at:
build/build_Munin_mingw/Munin.exe- Clean external distribution:
D:\MISCELANEAS\VSCode\Munin\Munin_mingw\
2. Building with MSVC (Preset host-qt6-msvc-release)
# Configure project using MSVC preset via runner script
cmd.exe /c "cmake\run_msvc.bat cmake --preset host-qt6-msvc-release"
# Compile and perform full runtime deployment
cmd.exe /c "cmake\run_msvc.bat cmake --build --preset host-qt6-msvc-release --target MuninDeploy --parallel"Binaries and deployed dependencies are available at:
build/build_Munin_msvc/Munin.exe- Clean external distribution:
D:\MISCELANEAS\VSCode\Munin\Munin_msvc\
Repository Structure
Munin_App_cpp/
βββ .github/ # GitHub Actions CI/CD workflows and repository templates
β βββ workflows/build.yml # Automated multi-toolchain build pipeline (MinGW and MSVC)
β βββ ISSUE_TEMPLATE/ # Issue reporting templates for bug reports and feature requests
β βββ PULL_REQUEST_TEMPLATE.md # Standard pull request submission template
βββ .vscode/ # Visual Studio Code development environment configuration
β βββ tasks.json # Individual and aggregated build tasks (MinGW and MSVC)
βββ docs/ # Modular technical documentation and compliance specifications
β βββ architecture.md # Win32 zero-copy architecture, SIMD AVX2/SSE4.2, and Qt6
β βββ cli-reference.md # Complete CLI reference for munin-app-cli and MuninBench
β βββ compliance.md # Compliance mapping for NIST SP 800-92, LGPD, and GDPR
β βββ licensing.md # MIT licensing model and Microsoft Store authorization
β βββ release-v2026.10.19.0.md # Technical release notes, SHA-256 hashes, and distribution artifacts
β βββ security-model.md # Security model, threat analysis, and integrity guarantees
β βββ suggested-issues.md # Structured community contribution backlog
β βββ user-guide.md # Step-by-step user operational guide
βββ cmake/ # Deployment scripts, icon resources, and MSVC/MinGW wrappers
β βββ deploy_optional_qt_binary.cmake # Automated Qt6 runtime deployment via windeployqt
β βββ gerar_distribuicoes_limpas.ps1 # PowerShell build, deploy, and clean packaging automation
β βββ run_mingw.bat / run_msvc.bat # Environment initialization wrappers for MinGW and MSVC
β βββ windows_app_icon.rc.in # Win32 resource template embedding application icon
βββ repo/ # Inno Setup installation scripts, MSIX manifest, and assets
β βββ AppxManifest.xml # MSIX package manifest with AppExecutionAlias for CLI
β βββ Munin.iss # Master unified Inno Setup script (MinGW/MSVC)
β βββ Munin_MinGW.iss / Munin_MSVC.iss# Dedicated installer scripts for each compiler flavor
β βββ MANUAL_TECNICO_CONFIGURACAO_AMBIENTE_CPP_QT6.txt # Qt6 environment and toolchain setup guide
β βββ limpar_artefatos_regeneraveis_qt.ps1 # Cleanup script for cache and transient build artifacts
β βββ LISTAGEM/ # Official Microsoft Store screenshot assets (pt_BR/en_US)
βββ mocks/ # Development utilities and auxiliary mock tools
β βββ CMakeLists.txt # Build configuration for auxiliary mock targets
β βββ CompileTranslationsGUI.hpp/.cpp # Interactive GUI for compiling and validating .ts -> .qm catalogs
β βββ CompileTranslationsTerminal.hpp/.cpp # Command-line batch translation compiler
β βββ find_VersionEditor.hpp/.cpp # Automated version synchronization and integrity checker
β βββ INSTRUCOES_find_VersionEditor.txt # Operating instructions and architecture of the version editor
β βββ launch_detached_gui.cmake # Detached GUI launch script
β βββ icons/ # Application icon assets for developer utilities
βββ source/ # Primary application source tree
β βββ main.cpp # Application entry point for Munin (GUI)
β βββ cli/ # Standalone Headless Command Line Interface (CLI)
β β βββ main_cli.cpp # Entry point for munin-app-cli.exe
β βββ engine/ # Low-level Win32 / SIMD processing engine
β β βββ MemoryMappedFile.hpp/.cpp # Win32 Memory-Mapped Files (zero-copy)
β β βββ SimdUtils.hpp/.cpp # AVX2/SSE4.2 vectorized line scanning
β β βββ ChunkIndex.hpp/.cpp # Sparse 64 KB block indexer
β β βββ LiveTailWatcher.hpp/.cpp # Real-time asynchronous append monitoring
β β βββ ParallelSearch.hpp/.cpp # Multi-core multithreaded parallel search
β β βββ TimeSliceScanner.hpp/.cpp # Timestamp extraction and histogram scanner
β β βββ TestEngine.cpp # MuninBench performance benchmark target
β βββ model/ # Virtualized data models
β β βββ LogModel.hpp/.cpp # On-demand QAbstractTableModel for Qt6
β βββ ui/ # Modern Qt6 user interface components
β β βββ MainWindow.hpp/.cpp # Main window, docking splitters, and status bar
β β βββ LogView.hpp/.cpp # Customized virtualized table viewer
β β βββ LogItemDelegate.hpp/.cpp # Custom item delegate for syntax highlighting and cell rendering
β β βββ MinimapScrollBar.hpp/.cpp # Density minimap vertical scrollbar
β β βββ SearchBarWidget.hpp/.cpp # Search bar widget with regex and occurrence counts
β β βββ TimeSliceWidget.hpp/.cpp # Interactive temporal histogram widget
β β βββ JsonInspectorWidget.hpp/.cpp# Structured JSON inspector and tree viewer
β β βββ LogGeneratorDialog.hpp/.cpp # Synthetic benchmark log generator dialog
β β βββ StickyMenu.hpp/.cpp # Fluent sticky menu bar implementation
β β βββ ThemeManager.hpp/.cpp # Windows 11 Light/Dark theme synchronization
β β βββ Win32DwmHelper.hpp/.cpp # Windows DWM integration (Mica & dark title bars)
β β βββ GerenciadorDialogos.hpp/.cpp# Modeless dialog manager (Z-Order control)
β β βββ SobreDialog.hpp/.cpp # About dialog with historical notes and licenses
β β βββ OpcoesSobre.hpp/.cpp # Advanced options selector for the About dialog
β β βββ ButtonUtils.hpp/.cpp # UI button styling and standardization helpers
β β βββ Manual.hpp/.cpp # Interactive Instruction Manual dialog
β βββ language/ # Translation catalogs and dynamic locale manager
β β βββ GerenciadorTraducao.hpp/.cpp# Dynamic .qm translation catalog loader
β β βββ translations/ # Translation files (munin_pt_BR.ts/.qm, munin_en_US.ts/.qm)
β βββ assets/ # Informational texts, EULAs, notices, policies, and icons
β β βββ ABOUT/ # About text and architectural history
β β βββ CLC/ # Corporate Commercial License Contracts (CLC)
β β βββ COPYRIGHT/ # Formal copyright and trademark notices
β β βββ EULA/ # End User License Agreements in PT-BR and EN-US
β β βββ LICENSES/ # Full text for upstream and third-party open-source licenses
β β βββ NOTICES/ # Third-party notices and open-source attributions
β β βββ PRIVACY_POLICY/ # Privacy policies conforming to LGPD and GDPR
β β βββ RELEASE/ # Technical release notes and launch history
β β βββ icons/ # Multi-resolution icons in .ico and .png formats
β βββ utils/ # System utilities, persistence, and internal logging
β βββ ApplicationPathUtils.hpp/.cpp # Safe application and portable path resolution
β βββ CaminhoPersistenteUtils.hpp/.cpp # Persistent path history and recent file manager
β βββ LogManager.hpp/.cpp # Internal application diagnostics logging
βββ CMakeLists.txt # Master CMake configuration (MuninEngine, Munin, munin-app-cli, MuninBench, MuninDeploy)
βββ CMakePresets.json # Configuration and build presets for MinGW and MSVC
βββ CODE_OF_CONDUCT.md # Code of Conduct for contributors and community
βββ CONTRIBUTING.md # Contribution guidelines, coding standards, and PR workflows
βββ LICENSE # Repository MIT open-source license
βββ main.cpp # Alternative/root application entry point
βββ MANUAL.md # Comprehensive user manual and operational guide
βββ OBSERVACAO.md # Detailed technical architecture and snapshot notes
βββ README.md # Official multilanguage repository documentation
βββ SECURITY.md # Security policy, vulnerability reporting, and threat model
6. Modular Technical Documentation
- ποΈ System Architecture β Engine design, Win32 memory-mapped files, SIMD vectorization, and Qt6.
- π‘οΈ Security & Integrity Model β Local-first philosophy, virtual memory integrity, and anti-ReDoS.
- π Compliance & Governance β NIST SP 800-92, PCI-DSS v4.0, ISO 27001, LGPD, and GDPR mappings.
- βοΈ Licensing & Commercial Clarification β MIT terms, Microsoft Store guidelines, and author's rights grant.
- π User Operations Guide β Step-by-step operations, parallel search, timeline, and JSON inspector.
- βοΈ CLI Reference β Command-line syntax for Munin.exe, munin-app-cli, MuninBench, and find_VersionEditor.
- π¦ Release Notes v2026.10.19.0 β Forensic SHA-256 hashes, release artifacts, and changelog.
- π‘ Evolution Roadmap & Suggested Issues β Technical backlog and community contributions.
- π Comprehensive Manual & Technical Observations β In-depth engineering references.
7. License and Express Commercial Authorization
This project is licensed under the terms of the MIT License. Refer to LICENSE for the complete terms and conditions.
7.1. Author's Declaration and Developer Freedom
Rights Holder Statement:
I, Fernando Nillsson Cidade, author and creator of Munin App, guarantee full freedom to developers under the terms of the MIT License:
- Documentation under
source/assets/: Authored exclusively for Microsoft Store commercial compliance and marketplace onboarding. The author expressly authorizes developers and contributors to modify, delete, add, and adapt this documentation and source code with complete freedom, provided they respect local laws and the regulations of their target publishing platforms.- Open-Source Codebase (MIT License): The full source code is publicly available under the MIT License. Anyone is free to audit, compile, modify, build custom executables, and maintain independent forks.
- Exclusive Restriction on the Author's Official Binary: Only the precompiled, digitally signed binary package provided directly by the author on the Microsoft Store is not authorized for resale or commercial redistribution by third parties, nor for reverse engineering (which is unnecessary anyway, since the author openly provides the unabridged source code in this repository).
7.2. Legal Justification for Documentation in source/assets/
The formal collection of institutional and regulatory documentation maintained under the source/assets/ directory (encompassing ABOUT, CLC, EULA, NOTICES, PRIVACY_POLICY, LICENSES, and COPYRIGHT) is grounded in the following legal, operational, and commercial distribution mandates:
- Commercial Distribution & Enterprise Marketplaces: Enterprise app stores (such as the Microsoft Store), enterprise application catalogs, and commercial B2B procurement channels strictly mandate the inclusion of formal End User License Agreements (EULA / Application Developer Agreement - ADA) and clear Privacy Policies for product onboarding, certification, and commercial billing.
- Data Privacy and Protection Compliance (GDPR & LGPD): The Privacy Policy and EULA provide auditable, legally binding guarantees that Munin App's Local-First architecture operates strictly offline (zero telemetry, zero data collection, no background tracking, and no external server communications), safeguarding enterprise users and ensuring compliance with the European Union GDPR and Brazilian LGPD (Federal Law No. 13,709/2018).
-
Upstream Licensing Compliance & Third-Party Attribution (LGPL v3 & Public Domain): The
NOTICESandLICENSESfolders meticulously fulfill all attribution and compliance obligations required by integrated third-party libraries (notably the Qt 6.11.1 framework under GNU LGPL v3 and the embedded SQLite3 engine in public domain), ensuring complete intellectual property hygiene. - Legal Harmony Between Open-Source Code and Commercial Delivery: The EULA and CLC establish the terms of distribution, warranty limitations, and operational usage for the compiled and packaged end-user binary application without constraining or diminishing the perpetual rights granted under the MIT License for the source code, creating a seamless and secure legal environment for both open-source contributors and commercial customers.
Munin App β’ Β© 2026 Fernando Nillsson Cidade
8. Author
Fernando Nillsson Cidade
Contact: linceu_lighthouse@outlook.com
GitHub: https://github.com/fernandoncidade
9. Contributing & Community
[!NOTE] About Project Development, Support, and External Contributions:
This project is designed, developed, and maintained primarily as a personal and educational initiative by the author, who is a beginner and in continuous learning in software engineering. Suggestions, feedback, Issues, and Pull Requests (PRs) are always welcomed from the community! However, please note that code reviews, technical discussions, and upstream merges are conducted voluntarily at the author's own pace. If a ticket or PR is not answered promptly or is not merged into the mainline branch, please do not react with alarm or frustration. The MIT license guarantees complete freedom to create an independent Fork and evolve your own customized builds.
Contributions are welcome! Please review our Contributing Guide and Code of Conduct.





