# noctqira/anemobit architecture

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

- Interactive diagram: https://gitdiagram.com/noctqira/anemobit
- Repository: https://github.com/noctqira/anemobit

## Overview

Anemobit is a native multi-platform SNMP network-traffic monitor. The user enters a device and credentials, scans for interfaces, selects what to watch, then sees live rates, statistics, and charts; platform-specific tray, menu-bar, or floating views keep a selected rate visible. Settings, secure credentials, localization, and appearance are supporting capabilities. The graph combines documented workflow with sampled source relationships; unsampled platform implementations are represented only at paths supported by the tree, and several links are documented rather than verified calls.

Main entry points: [`Darwin/App/Shared/ViewModels/TrafficViewModel.swift`](https://github.com/noctqira/anemobit/blob/main/Darwin/App/Shared/ViewModels/TrafficViewModel.swift) (Apple traffic model), [`Linux/src/traffic_model.rs`](https://github.com/noctqira/anemobit/blob/main/Linux/src/traffic_model.rs) (Linux traffic model), [`Windows/src/Anemobit/ViewModels/TrafficViewModel.cs`](https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit/ViewModels/TrafficViewModel.cs) (Windows traffic model), [`Darwin/App/Shared/ViewModels/SettingsViewModel.swift`](https://github.com/noctqira/anemobit/blob/main/Darwin/App/Shared/ViewModels/SettingsViewModel.swift) (Settings workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform_apps["Platform apps"]
  node_darwin_app["Apple app shell"]
  node_linux_app["Linux app shell<br/>[application.rs]"]
  node_windows_app["Windows app shell<br/>[App.xaml.cs]"]
  node_apple_presentations["Apple dashboard"]
  node_linux_presentations["Linux views and tray<br/>[status_notifier.rs]"]
  node_windows_presentations["Windows views and tray<br/>[MainWindow.xaml.cs]"]
end

subgraph group_configuration["Configuration"]
  node_darwin_settings["Settings UI<br/>[SettingsView.swift]"]
  node_darwin_settings_model["Settings workflow"]
  node_credentials[("Secure credentials")]
  node_platform_settings["Platform settings<br/>[settings.rs]"]
  node_windows_settings[("Windows settings<br/>[SettingsStore.cs]")]
end

subgraph group_traffic["Traffic monitoring"]
  node_apple_traffic_model["Apple traffic model"]
  node_linux_traffic_model["Linux traffic model<br/>[traffic_model.rs]"]
  node_windows_traffic_model["Windows traffic model"]
  node_linux_poller["Linux SNMP poller<br/>[poller.rs]"]
  node_darwin_poller["Apple SNMP poller"]
  node_windows_poller["Windows SNMP poller"]
  node_linux_formatting["Linux formatting<br/>[formatting.rs]"]
  node_darwin_formatting["Apple formatting"]
  node_windows_formatting["Windows formatting<br/>[RateFormatter.cs]"]
end

subgraph group_protocol["SNMP protocol"]
  node_linux_snmp["Linux SNMP client<br/>[client.rs]"]
  node_darwin_snmp["Apple SNMP client<br/>[SNMPClient.swift]"]
  node_windows_snmp["Windows SNMP client<br/>[SnmpClient.cs]"]
  node_linux_transport["Linux UDP transport<br/>[udp.rs]"]
  node_darwin_transport["Apple UDP transport<br/>[UDPTransport.swift]"]
  node_windows_transport["Windows UDP transport"]
end

node_user(("User"))
node_device{{"SNMP device"}}

node_user -->|"configures device"| node_darwin_settings
node_user -->|"configures device"| node_platform_settings
node_user -->|"configures device"| node_windows_settings
node_darwin_settings -->|"invokes actions"| node_darwin_settings_model
node_darwin_settings_model -->|"scans and tests"| node_darwin_snmp
node_darwin_settings_model -.->|"uses secure storage"| node_credentials
node_darwin_app -->|"presents"| node_darwin_settings
node_linux_app -->|"opens settings"| node_platform_settings
node_windows_app -->|"loads settings"| node_windows_settings
node_darwin_settings_model -.->|"restarts polling"| node_darwin_poller
node_linux_app -->|"creates model"| node_linux_traffic_model
node_windows_app -->|"initializes model"| node_windows_traffic_model
node_darwin_app -->|"initializes model"| node_apple_traffic_model
node_apple_traffic_model -.->|"polls interfaces"| node_darwin_poller
node_linux_traffic_model -.->|"polls interfaces"| node_linux_poller
node_windows_traffic_model -.->|"polls interfaces"| node_windows_poller
node_darwin_poller -.->|"requests counters"| node_darwin_snmp
node_linux_poller -->|"requests counters"| node_linux_snmp
node_windows_poller -.->|"requests counters"| node_windows_snmp
node_darwin_snmp -->|"sends requests"| node_darwin_transport
node_linux_snmp -->|"sends requests"| node_linux_transport
node_windows_snmp -->|"sends requests"| node_windows_transport
node_darwin_transport -->|"exchanges SNMP"| node_device
node_linux_transport -->|"exchanges SNMP"| node_device
node_windows_transport -->|"exchanges SNMP"| node_device
node_device -->|"returns counters"| node_darwin_snmp
node_device -->|"returns counters"| node_linux_snmp
node_device -->|"returns counters"| node_windows_snmp
node_darwin_poller -.->|"updates rates"| node_apple_traffic_model
node_linux_poller -.->|"updates rates"| node_linux_traffic_model
node_windows_poller -.->|"updates rates"| node_windows_traffic_model
node_apple_traffic_model -.->|"drives dashboard"| node_apple_presentations
node_linux_traffic_model -.->|"drives tray display"| node_linux_presentations
node_windows_traffic_model -.->|"drives window"| node_windows_presentations
node_apple_traffic_model -.->|"formats rates"| node_darwin_formatting
node_linux_traffic_model -.->|"formats rates"| node_linux_formatting
node_windows_traffic_model -.->|"formats rates"| node_windows_formatting

click node_darwin_settings "https://github.com/noctqira/anemobit/blob/main/Darwin/App/Shared/Views/SettingsView.swift"
click node_darwin_settings_model "https://github.com/noctqira/anemobit/blob/main/Darwin/App/Shared/ViewModels/SettingsViewModel.swift"
click node_credentials "https://github.com/noctqira/anemobit/blob/main/Darwin/App/Shared/Settings/KeychainStore.swift"
click node_platform_settings "https://github.com/noctqira/anemobit/blob/main/Linux/src/settings.rs"
click node_windows_settings "https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit/Settings/SettingsStore.cs"
click node_darwin_app "https://github.com/noctqira/anemobit/blob/main/Darwin/App/macOS/AnemobitMacApp.swift"
click node_linux_app "https://github.com/noctqira/anemobit/blob/main/Linux/src/application.rs"
click node_windows_app "https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit/App.xaml.cs"
click node_apple_presentations "https://github.com/noctqira/anemobit/blob/main/Darwin/App/Shared/Views/DashboardSections.swift"
click node_linux_presentations "https://github.com/noctqira/anemobit/blob/main/Linux/src/tray/status_notifier.rs"
click node_windows_presentations "https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit/Views/MainWindow.xaml.cs"
click node_apple_traffic_model "https://github.com/noctqira/anemobit/blob/main/Darwin/App/Shared/ViewModels/TrafficViewModel.swift"
click node_linux_traffic_model "https://github.com/noctqira/anemobit/blob/main/Linux/src/traffic_model.rs"
click node_windows_traffic_model "https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit/ViewModels/TrafficViewModel.cs"
click node_linux_poller "https://github.com/noctqira/anemobit/blob/main/Linux/core/src/traffic/poller.rs"
click node_darwin_poller "https://github.com/noctqira/anemobit/blob/main/Darwin/Packages/Core/Sources/Core/Polling/SNMPTrafficPoller.swift"
click node_windows_poller "https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit.Core/Traffic/SnmpTrafficPoller.cs"
click node_linux_snmp "https://github.com/noctqira/anemobit/blob/main/Linux/core/src/snmp/client.rs"
click node_darwin_snmp "https://github.com/noctqira/anemobit/blob/main/Darwin/Packages/Core/Sources/Core/SNMP/SNMPClient.swift"
click node_windows_snmp "https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit.Core/Snmp/SnmpClient.cs"
click node_linux_transport "https://github.com/noctqira/anemobit/blob/main/Linux/core/src/transport/udp.rs"
click node_darwin_transport "https://github.com/noctqira/anemobit/blob/main/Darwin/Packages/Core/Sources/Core/Transport/UDPTransport.swift"
click node_windows_transport "https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit.Core/Transport/UdpSocketTransport.cs"
click node_linux_formatting "https://github.com/noctqira/anemobit/blob/main/Linux/core/src/formatting.rs"
click node_darwin_formatting "https://github.com/noctqira/anemobit/blob/main/Darwin/Packages/Core/Sources/Core/Formatting/RateFormatter.swift"
click node_windows_formatting "https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit.Core/Formatting/RateFormatter.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_darwin_app,node_linux_app,node_windows_app,node_apple_presentations,node_linux_presentations,node_windows_presentations,node_user toneBlue
class node_darwin_settings,node_darwin_settings_model,node_credentials,node_platform_settings,node_windows_settings toneAmber
class node_apple_traffic_model,node_linux_traffic_model,node_windows_traffic_model,node_linux_poller,node_darwin_poller,node_windows_poller,node_linux_formatting,node_darwin_formatting,node_windows_formatting toneMint
class node_linux_snmp,node_darwin_snmp,node_windows_snmp,node_linux_transport,node_darwin_transport,node_windows_transport toneRose
class node_device toneIndigo
```

## Components

### Platform apps

- [Apple app shell](https://github.com/noctqira/anemobit/blob/main/Darwin/App/macOS/AnemobitMacApp.swift): `Darwin/App/macOS/AnemobitMacApp.swift`
- [Linux app shell](https://github.com/noctqira/anemobit/blob/main/Linux/src/application.rs): `Linux/src/application.rs`
- [Windows app shell](https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit/App.xaml.cs): `Windows/src/Anemobit/App.xaml.cs`
- [Apple dashboard](https://github.com/noctqira/anemobit/blob/main/Darwin/App/Shared/Views/DashboardSections.swift): `Darwin/App/Shared/Views/DashboardSections.swift`
- [Linux views and tray](https://github.com/noctqira/anemobit/blob/main/Linux/src/tray/status_notifier.rs): `Linux/src/tray/status_notifier.rs`
- [Windows views and tray](https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit/Views/MainWindow.xaml.cs): `Windows/src/Anemobit/Views/MainWindow.xaml.cs`

### Configuration

- [Settings UI](https://github.com/noctqira/anemobit/blob/main/Darwin/App/Shared/Views/SettingsView.swift): `Darwin/App/Shared/Views/SettingsView.swift`
- [Settings workflow](https://github.com/noctqira/anemobit/blob/main/Darwin/App/Shared/ViewModels/SettingsViewModel.swift): `Darwin/App/Shared/ViewModels/SettingsViewModel.swift`
- [Secure credentials](https://github.com/noctqira/anemobit/blob/main/Darwin/App/Shared/Settings/KeychainStore.swift): `Darwin/App/Shared/Settings/KeychainStore.swift`
- [Platform settings](https://github.com/noctqira/anemobit/blob/main/Linux/src/settings.rs): `Linux/src/settings.rs`
- [Windows settings](https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit/Settings/SettingsStore.cs): `Windows/src/Anemobit/Settings/SettingsStore.cs`

### Traffic monitoring

- [Apple traffic model](https://github.com/noctqira/anemobit/blob/main/Darwin/App/Shared/ViewModels/TrafficViewModel.swift): `Darwin/App/Shared/ViewModels/TrafficViewModel.swift`
- [Linux traffic model](https://github.com/noctqira/anemobit/blob/main/Linux/src/traffic_model.rs): `Linux/src/traffic_model.rs`
- [Windows traffic model](https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit/ViewModels/TrafficViewModel.cs): `Windows/src/Anemobit/ViewModels/TrafficViewModel.cs`
- [Linux SNMP poller](https://github.com/noctqira/anemobit/blob/main/Linux/core/src/traffic/poller.rs): `Linux/core/src/traffic/poller.rs`
- [Apple SNMP poller](https://github.com/noctqira/anemobit/blob/main/Darwin/Packages/Core/Sources/Core/Polling/SNMPTrafficPoller.swift): `Darwin/Packages/Core/Sources/Core/Polling/SNMPTrafficPoller.swift`
- [Windows SNMP poller](https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit.Core/Traffic/SnmpTrafficPoller.cs): `Windows/src/Anemobit.Core/Traffic/SnmpTrafficPoller.cs`
- [Linux formatting](https://github.com/noctqira/anemobit/blob/main/Linux/core/src/formatting.rs): `Linux/core/src/formatting.rs`
- [Apple formatting](https://github.com/noctqira/anemobit/blob/main/Darwin/Packages/Core/Sources/Core/Formatting/RateFormatter.swift): `Darwin/Packages/Core/Sources/Core/Formatting/RateFormatter.swift`
- [Windows formatting](https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit.Core/Formatting/RateFormatter.cs): `Windows/src/Anemobit.Core/Formatting/RateFormatter.cs`

### SNMP protocol

- [Linux SNMP client](https://github.com/noctqira/anemobit/blob/main/Linux/core/src/snmp/client.rs): `Linux/core/src/snmp/client.rs`
- [Apple SNMP client](https://github.com/noctqira/anemobit/blob/main/Darwin/Packages/Core/Sources/Core/SNMP/SNMPClient.swift): `Darwin/Packages/Core/Sources/Core/SNMP/SNMPClient.swift`
- [Windows SNMP client](https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit.Core/Snmp/SnmpClient.cs): `Windows/src/Anemobit.Core/Snmp/SnmpClient.cs`
- [Linux UDP transport](https://github.com/noctqira/anemobit/blob/main/Linux/core/src/transport/udp.rs): `Linux/core/src/transport/udp.rs`
- [Apple UDP transport](https://github.com/noctqira/anemobit/blob/main/Darwin/Packages/Core/Sources/Core/Transport/UDPTransport.swift): `Darwin/Packages/Core/Sources/Core/Transport/UDPTransport.swift`
- [Windows UDP transport](https://github.com/noctqira/anemobit/blob/main/Windows/src/Anemobit.Core/Transport/UdpSocketTransport.cs): `Windows/src/Anemobit.Core/Transport/UdpSocketTransport.cs`

### Other components

- **User**
- **SNMP device**

## Connections

- User → Settings UI: configures device
- User → Platform settings: configures device
- User → Windows settings: configures device
- Settings UI → Settings workflow: invokes actions (evidence: `Darwin/App/Shared/Views/SettingsView.swift`)
- Settings workflow → Apple SNMP client: scans and tests (evidence: `Darwin/App/Shared/ViewModels/SettingsViewModel.swift`)
- Settings workflow → Secure credentials: uses secure storage
- Apple app shell → Settings UI: presents (evidence: `Darwin/App/macOS/AnemobitMacApp.swift`)
- Linux app shell → Platform settings: opens settings (evidence: `Linux/src/application.rs`)
- Windows app shell → Windows settings: loads settings (evidence: `Windows/src/Anemobit/App.xaml.cs`)
- Settings workflow → Apple SNMP poller: restarts polling (evidence: `Darwin/App/Shared/ViewModels/SettingsViewModel.swift`)
- Linux app shell → Linux traffic model: creates model (evidence: `Linux/src/application.rs`)
- Windows app shell → Windows traffic model: initializes model (evidence: `Windows/src/Anemobit/App.xaml.cs`)
- Apple app shell → Apple traffic model: initializes model (evidence: `Darwin/App/macOS/AnemobitMacApp.swift`)
- Apple traffic model → Apple SNMP poller: polls interfaces
- Linux traffic model → Linux SNMP poller: polls interfaces
- Windows traffic model → Windows SNMP poller: polls interfaces
- Apple SNMP poller → Apple SNMP client: requests counters
- Linux SNMP poller → Linux SNMP client: requests counters (evidence: `Linux/core/src/traffic/poller.rs`)
- Windows SNMP poller → Windows SNMP client: requests counters
- Apple SNMP client → Apple UDP transport: sends requests (evidence: `Darwin/Packages/Core/Sources/Core/SNMP/SNMPClient.swift`)
- Linux SNMP client → Linux UDP transport: sends requests (evidence: `Linux/core/src/snmp/client.rs`)
- Windows SNMP client → Windows UDP transport: sends requests (evidence: `Windows/src/Anemobit.Core/Snmp/SnmpClient.cs`)
- Apple UDP transport → SNMP device: exchanges SNMP
- Linux UDP transport → SNMP device: exchanges SNMP
- Windows UDP transport → SNMP device: exchanges SNMP
- SNMP device → Apple SNMP client: returns counters
- SNMP device → Linux SNMP client: returns counters
- SNMP device → Windows SNMP client: returns counters
- Apple SNMP poller → Apple traffic model: updates rates
- Linux SNMP poller → Linux traffic model: updates rates
- Windows SNMP poller → Windows traffic model: updates rates
- Apple traffic model → Apple dashboard: drives dashboard
- Linux traffic model → Linux views and tray: drives tray display
- Windows traffic model → Windows views and tray: drives window
- Apple traffic model → Apple formatting: formats rates
- Linux traffic model → Linux formatting: formats rates
- Windows traffic model → Windows formatting: formats rates
