Skip to content

About

Munin App is a high-performance application developed for software engineers, system administrators, security analysts (SOC/SIEM), and infrastructure and DevOps teams who need to inspect, navigate, and analyze massive log files.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

1 Commit

Folders and files

Repository files navigation

Munin App β€” Leitor de Logs Massivos para Windows

VersΓ£o Oficial Official Version Microsoft Store C++20 Qt 6.11.1 Windows 11 Native LicenΓ§a MIT SeguranΓ§a 100% Offline


Selecione o idioma / Select language:
PortuguΓͺs (BR) | English (US)


PortuguΓͺs (BR)

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 (CreateFileMappingW e MapViewOfFile), 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 $O(1)$ a qualquer linha do documento.
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)

Visualizador de Logs & Minimapa de Densidade
Visualizador de Logs & Minimapa
NavegaΓ§Γ£o virtualizada fluida com renderizaΓ§Γ£o instantΓ’nea
Busca Paralela Multi-Core & Filtragem JIT
Busca Paralela Multi-Core
LocalizaΓ§Γ£o rΓ‘pida de padrΓ΅es e destaque cromΓ‘tico no minimapa
Histograma Temporal (Time-Slice) & Inspetor JSON Estruturado
Histograma Temporal e Inspetor JSON
DetecΓ§Γ£o de surtos temporais e dissecΓ§Γ£o hierΓ‘rquica de payloads

πŸ“š DocumentaΓ§Γ£o TΓ©cnica Adicional


Destaques TΓ©cnicos da VersΓ£o 2026.10.19.0

  1. 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.
  2. 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 __m256i e 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_epi8 com 16 bytes por ciclo) e rotina escalar otimizada.
  3. 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.
  4. Monitoramento Live Tail via Win32 Nativo (LiveTailWatcher.cpp):

    • Acompanhamento passivo de crescimento de arquivos por meio da API Win32 ReadDirectoryChangesW em thread dedicada.
    • AtualizaΓ§Γ£o contΓ­nua de offsets de novas linhas sem reinicializar o Γ­ndice do arquivo jΓ‘ mapeado.
  5. Gerenciamento de DiΓ‘logos Modeless e Z-Order Independente (GerenciadorDialogos.cpp):

    • ImplementaΓ§Γ£o de janelas de diΓ‘logo independentes (SobreDialog e ManualDialog) 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.
  6. 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.
  7. 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 AppExecutionAlias no 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 --parallel

O 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 --check

Estrutura 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


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:

  1. 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.
  2. 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.
  3. 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:

  1. 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.
  2. 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.
  3. AtribuiΓ§Γ£o de Terceiros e Licenciamento Upstream (LGPL v3 e DomΓ­nio PΓΊblico): Os diretΓ³rios NOTICES e LICENSES cumprem 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.
  4. 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.


English (US)

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 (CreateFileMappingW and MapViewOfFile), 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 $O(1)$ random seek to any line across millions of records.
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

Massive Log Viewer & Density Minimap
Log Viewer & Minimap
Fluid virtual navigation with zero-copy memory mapping
Multi-Core Parallel Search & JIT Filtering
Multi-Core Parallel Search
Rapid pattern matching with chromatic markers on the scrollbar
Time-Slice Timeline & Structured JSON Inspector
Time-Slice Timeline & JSON Inspector
Incident surge detection and structured hierarchy dissection

πŸ“š Modular Technical Documentation


Technical Highlights of Version 2026.10.19.0

  1. 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.
  2. SIMD Vector Acceleration (SimdUtils.cpp):

    • Runtime CPU feature detection ensuring AVX2 instructions are executed when supported, utilizing __m256i registers 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.
  3. 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.
  4. Kernel-Level Live Tail (LiveTailWatcher.cpp):

    • Passive tracking of active writes using the Windows ReadDirectoryChangesW kernel API on a dedicated background thread.
    • Dynamic expansion of line offset arrays without needing to reindex previously mapped regions.
  5. Modeless Dialog Hierarchy and Z-Order Control (GerenciadorDialogos.cpp):

    • Top-level modeless dialog design (SobreDialog and ManualDialog) 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.
  6. 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.
  7. 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 AppExecutionAlias in 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 --parallel

Binaries 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


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:

  1. 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.
  2. 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.
  3. 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:

  1. 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.
  2. 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).
  3. Upstream Licensing Compliance & Third-Party Attribution (LGPL v3 & Public Domain): The NOTICES and LICENSES folders 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.
  4. 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.

About

Munin App is a high-performance application developed for software engineers, system administrators, security analysts (SOC/SIEM), and infrastructure and DevOps teams who need to inspect, navigate, and analyze massive log files.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages