# logexperts/logexpert architecture

> Architecture diagram of the GitHub repository logexperts/logexpert, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/logexperts/logexpert
- Repository: https://github.com/logexperts/logexpert

## Overview

LogExpert is a Windows GUI log viewer and tailing application. A user opens a log in the tabbed interface; the application reads and presents its lines, with columnizers and analysis tools supporting search, filtering, highlighting, bookmarks, and tail-follow. Plugins extend log formats and file sources, while configuration and session persistence retain user state. The README documents these capabilities; some corresponding implementations are present in the tree but were not excerpted, so uncertain internal links are omitted rather than inferred.

Main entry points: [`src/LogExpert/Program.cs`](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert/Program.cs) (Application startup), [`src/LogExpert.Core/Classes/Filter/SerialFilterEngine.cs`](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Filter/SerialFilterEngine.cs) (Filter engine), [`src/LogExpert.Core/Classes/Log/LogfileReader.cs`](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Log/LogfileReader.cs) (Log file reader), [`src/PluginRegistry/PluginRegistry.cs`](https://github.com/logexperts/logexpert/blob/Development/src/PluginRegistry/PluginRegistry.cs) (Plugin registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and UI"]
  node_program["Application startup<br/>[Program.cs]"]
  node_window["Log window<br/>[LogWindow.cs]"]
  node_tabs["Tabbed interface<br/>[TabController.cs]"]
end

subgraph group_reading["Log reading and parsing"]
  node_reader["Log file reader<br/>[LogfileReader.cs]"]
  node_buffers["Line buffers<br/>[LogBuffer.cs]"]
  node_callback["Columnizer callback"]
  node_columnizers["Format columnizers"]
  node_tail["Tail following"]
end

subgraph group_analysis["Log analysis"]
  node_search["Search<br/>[LogSearcher.cs]"]
  node_filter["Filter engine"]
  node_filterparams["Filter criteria<br/>[FilterParams.cs]"]
  node_highlight["Highlight rules<br/>[HighlightEntry.cs]"]
  node_bookmarks["Bookmarks"]
end

subgraph group_extensibility["Extensions and state"]
  node_config["Configuration<br/>[ConfigManager.cs]"]
  node_settings["Settings model<br/>[Settings.cs]"]
  node_sessions["Session persistence"]
  node_pluginregistry["Plugin registry<br/>[PluginRegistry.cs]"]
  node_pluginapi["Plugin API"]
end

node_user(("Log viewer"))

node_user -->|"opens logs"| node_program
node_program -->|"starts interface"| node_window
node_program -->|"loads configuration"| node_config
node_program -->|"initializes plugins"| node_pluginregistry
node_user -->|"uses tabs"| node_tabs
node_window -.->|"displays log"| node_reader
node_reader -.->|"stores lines"| node_buffers
node_callback -->|"reads lines"| node_reader
node_user -->|"selects format"| node_columnizers
node_user -->|"follows updates"| node_tail
node_user -->|"searches logs"| node_search
node_user -->|"filters lines"| node_filter
node_filter -->|"reads lines"| node_callback
node_filter -->|"uses criteria"| node_filterparams
node_user -->|"sets highlights"| node_highlight
node_user -->|"creates bookmarks"| node_bookmarks
node_config -->|"loads settings"| node_settings
node_user -.->|"restores sessions"| node_sessions
node_pluginregistry -.->|"loads extensions"| node_pluginapi
node_user -->|"extends sources"| node_pluginregistry

click node_program "https://github.com/logexperts/logexpert/blob/Development/src/LogExpert/Program.cs"
click node_window "https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.UI/Controls/LogWindow/LogWindow.cs"
click node_tabs "https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.UI/Services/TabControllerService/TabController.cs"
click node_reader "https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Log/LogfileReader.cs"
click node_buffers "https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Log/Buffers/LogBuffer.cs"
click node_callback "https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Callback/ColumnizerCallback.cs"
click node_columnizers "https://github.com/logexperts/logexpert/blob/Development/src/ColumnizerLib/ILogLineMemoryColumnizer.cs"
click node_tail "https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Tail/TailFollowEngine.cs"
click node_search "https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Search/LogSearcher.cs"
click node_filter "https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Filter/SerialFilterEngine.cs"
click node_filterparams "https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Filter/FilterParams.cs"
click node_highlight "https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Highlight/HighlightEntry.cs"
click node_bookmarks "https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Bookmark/BookmarkDataProvider.cs"
click node_config "https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Configuration/ConfigManager.cs"
click node_settings "https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Config/Settings.cs"
click node_sessions "https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Persister/SessionPersister.cs"
click node_pluginregistry "https://github.com/logexperts/logexpert/blob/Development/src/PluginRegistry/PluginRegistry.cs"
click node_pluginapi "https://github.com/logexperts/logexpert/blob/Development/src/ColumnizerLib/ILogExpertPlugin.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_program,node_window,node_tabs,node_user toneBlue
class node_reader,node_buffers,node_callback,node_columnizers,node_tail toneAmber
class node_search,node_filter,node_filterparams,node_highlight,node_bookmarks toneMint
class node_config,node_settings,node_sessions,node_pluginregistry,node_pluginapi toneRose
```

## Components

### Application and UI

- [Application startup](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert/Program.cs): `src/LogExpert/Program.cs`
- [Log window](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.UI/Controls/LogWindow/LogWindow.cs): `src/LogExpert.UI/Controls/LogWindow/LogWindow.cs`
- [Tabbed interface](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.UI/Services/TabControllerService/TabController.cs): `src/LogExpert.UI/Services/TabControllerService/TabController.cs`

### Log reading and parsing

- [Log file reader](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Log/LogfileReader.cs): `src/LogExpert.Core/Classes/Log/LogfileReader.cs`
- [Line buffers](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Log/Buffers/LogBuffer.cs): `src/LogExpert.Core/Classes/Log/Buffers/LogBuffer.cs`
- [Columnizer callback](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Callback/ColumnizerCallback.cs): `src/LogExpert.Core/Callback/ColumnizerCallback.cs`
- [Format columnizers](https://github.com/logexperts/logexpert/blob/Development/src/ColumnizerLib/ILogLineMemoryColumnizer.cs): `src/ColumnizerLib/ILogLineMemoryColumnizer.cs`
- [Tail following](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Tail/TailFollowEngine.cs): `src/LogExpert.Core/Classes/Tail/TailFollowEngine.cs`

### Log analysis

- [Search](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Search/LogSearcher.cs): `src/LogExpert.Core/Classes/Search/LogSearcher.cs`
- [Filter engine](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Filter/SerialFilterEngine.cs): `src/LogExpert.Core/Classes/Filter/SerialFilterEngine.cs`
- [Filter criteria](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Filter/FilterParams.cs): `src/LogExpert.Core/Classes/Filter/FilterParams.cs`
- [Highlight rules](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Highlight/HighlightEntry.cs): `src/LogExpert.Core/Classes/Highlight/HighlightEntry.cs`
- [Bookmarks](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Bookmark/BookmarkDataProvider.cs): `src/LogExpert.Core/Classes/Bookmark/BookmarkDataProvider.cs`

### Extensions and state

- [Configuration](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Configuration/ConfigManager.cs): `src/LogExpert.Configuration/ConfigManager.cs`
- [Settings model](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Config/Settings.cs): `src/LogExpert.Core/Config/Settings.cs`
- [Session persistence](https://github.com/logexperts/logexpert/blob/Development/src/LogExpert.Core/Classes/Persister/SessionPersister.cs): `src/LogExpert.Core/Classes/Persister/SessionPersister.cs`
- [Plugin registry](https://github.com/logexperts/logexpert/blob/Development/src/PluginRegistry/PluginRegistry.cs): `src/PluginRegistry/PluginRegistry.cs`
- [Plugin API](https://github.com/logexperts/logexpert/blob/Development/src/ColumnizerLib/ILogExpertPlugin.cs): `src/ColumnizerLib/ILogExpertPlugin.cs`

### Other components

- **Log viewer**

## Connections

- Log viewer → Application startup: opens logs (evidence: `README.md`)
- Application startup → Log window: starts interface (evidence: `src/LogExpert/Program.cs`)
- Application startup → Configuration: loads configuration (evidence: `src/LogExpert/Program.cs`)
- Application startup → Plugin registry: initializes plugins (evidence: `src/LogExpert/Program.cs`)
- Log viewer → Tabbed interface: uses tabs (evidence: `README.md`)
- Log window → Log file reader: displays log (evidence: `src/LogExpert.UI/Controls/LogWindow/LogWindow.cs`)
- Log file reader → Line buffers: stores lines
- Columnizer callback → Log file reader: reads lines (evidence: `src/LogExpert.Core/Callback/ColumnizerCallback.cs`)
- Log viewer → Format columnizers: selects format (evidence: `README.md`)
- Log viewer → Tail following: follows updates (evidence: `README.md`)
- Log viewer → Search: searches logs (evidence: `README.md`)
- Log viewer → Filter engine: filters lines (evidence: `README.md`)
- Filter engine → Columnizer callback: reads lines (evidence: `src/LogExpert.Core/Classes/Filter/SerialFilterEngine.cs`)
- Filter engine → Filter criteria: uses criteria (evidence: `src/LogExpert.Core/Classes/Filter/SerialFilterEngine.cs`)
- Log viewer → Highlight rules: sets highlights (evidence: `README.md`)
- Log viewer → Bookmarks: creates bookmarks (evidence: `README.md`)
- Configuration → Settings model: loads settings (evidence: `src/LogExpert.Configuration/ConfigManager.cs`)
- Log viewer → Session persistence: restores sessions (evidence: `README.md`)
- Plugin registry → Plugin API: loads extensions (evidence: `src/PluginRegistry/PluginRegistry.cs`)
- Log viewer → Plugin registry: extends sources (evidence: `README.md`)
