# juliofilizzola/batto architecture

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

- Interactive diagram: https://gitdiagram.com/juliofilizzola/batto
- Repository: https://github.com/juliofilizzola/batto

## Overview

Batto is a Bluetooth battery monitor that keeps device status visible in a system tray, with Windows/WPF and Linux/BlueZ implementations over a shared monitoring core. Device discovery and battery reads feed the monitor; settings, notifications, tray presentation, and device-management UI provide the user-facing result. The graph includes README-documented capabilities whose implementation details were not sampled; edges are limited to shown references or documented relationships.

Main entry points: [`src/Batto.Core/Battery/BatteryMonitor.cs`](https://github.com/juliofilizzola/batto/blob/main/src/Batto.Core/Battery/BatteryMonitor.cs) (Battery monitor), [`src/Batto.Linux/AppServices.cs`](https://github.com/juliofilizzola/batto/blob/main/src/Batto.Linux/AppServices.cs) (Linux service composition), [`src/Batto/Tray/TrayManager.cs`](https://github.com/juliofilizzola/batto/blob/main/src/Batto/Tray/TrayManager.cs) (Tray and flyout), [`src/Batto/App.xaml.cs`](https://github.com/juliofilizzola/batto/blob/main/src/Batto/App.xaml.cs) (Windows composition)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Shared monitoring core"]
  node_monitor["Battery monitor<br/>[BatteryMonitor.cs]"]
  node_device["Device model"]
  node_classifier["Device classifier"]
  node_scanner["Logitech HID++ scanner"]
  node_settings[("Settings and autostart<br/>[SettingsManager.cs]")]
  node_notify["Notification policy"]
end

subgraph group_windows["Windows application"]
  node_winapp["Windows composition<br/>[App.xaml.cs]"]
  node_winbt["Windows discovery"]
  node_gatt["GATT battery reader"]
  node_pnp["PnP battery reader"]
  node_winread["Windows reader"]
  node_native["Windows tray integration<br/>[NativeMethods.cs]"]
  node_promotion["Tray icon promotion<br/>[TrayPromotion.cs]"]
end

subgraph group_linux["Linux application"]
  node_bluezreg["BlueZ device registry<br/>[BlueZRegistry.cs]"]
  node_bluezsource["BlueZ discovery"]
  node_bluezread["BlueZ battery reader"]
  node_linuxservices["Linux service composition<br/>[AppServices.cs]"]
  node_sni["StatusNotifier tray"]
  node_freedesktop["Desktop notifications"]
end

subgraph group_presentation["User presentation"]
  node_winui["Device management UI<br/>[MainViewModel.cs]"]
  node_wintray["Tray and flyout<br/>[TrayManager.cs]"]
  node_trayicon["Tray icon rendering<br/>[IconGenerator.cs]"]
  node_linuxui["Linux device UI<br/>[MainViewModel.cs]"]
end

node_user(("Desktop user"))
node_bluez(("BlueZ over D-Bus"))
node_osnotify(("Desktop notification service"))

node_user -->|"views status"| node_wintray
node_winapp -->|"composes"| node_monitor
node_winapp -->|"composes"| node_winbt
node_winapp -->|"composes"| node_settings
node_winapp -->|"composes"| node_wintray
node_winapp -->|"composes"| node_scanner
node_monitor -->|"discovers devices"| node_winbt
node_monitor -->|"scans Logitech"| node_scanner
node_monitor -->|"raises alerts"| node_notify
node_monitor -->|"loads and saves"| node_settings
node_winbt -->|"classifies devices"| node_classifier
node_winbt -->|"reads device properties"| node_pnp
node_monitor -.->|"reads BLE battery"| node_gatt
node_monitor -.->|"reads PnP battery"| node_pnp
node_monitor -.->|"uses platform readers"| node_winread
node_monitor -->|"updates device state"| node_device
node_winui -->|"manages devices"| node_monitor
node_winui -->|"updates settings"| node_settings
node_monitor -->|"publishes battery changes"| node_wintray
node_wintray -->|"renders summary icon"| node_trayicon
node_wintray -->|"registers tray icon"| node_native
node_wintray -->|"promotes tray icons"| node_promotion
node_user -->|"manages devices"| node_winui
node_user -->|"manages devices"| node_linuxui
node_linuxservices -->|"creates registry"| node_bluezreg
node_linuxservices -->|"composes discovery"| node_bluezsource
node_linuxservices -->|"composes reader"| node_bluezread
node_linuxservices -->|"starts monitor"| node_monitor
node_linuxservices -->|"loads settings"| node_settings
node_linuxservices -->|"composes policy"| node_notify
node_linuxservices -->|"configures notifier"| node_freedesktop
node_linuxservices -->|"starts tray host"| node_sni
node_bluezreg -->|"watches D-Bus"| node_bluez
node_bluezsource -->|"reads snapshots"| node_bluezreg
node_bluezread -->|"reads battery state"| node_bluezreg
node_notify -->|"sends notifications"| node_freedesktop
node_freedesktop -->|"displays alerts"| node_osnotify
node_linuxui -->|"presents devices"| node_device
node_user -->|"uses tray"| node_sni

click node_winapp "https://github.com/juliofilizzola/batto/blob/main/src/Batto/App.xaml.cs"
click node_monitor "https://github.com/juliofilizzola/batto/blob/main/src/Batto.Core/Battery/BatteryMonitor.cs"
click node_device "https://github.com/juliofilizzola/batto/blob/main/src/Batto.Core/Models/BluetoothDeviceModel.cs"
click node_classifier "https://github.com/juliofilizzola/batto/blob/main/src/Batto.Core/Bluetooth/DeviceClassifier.cs"
click node_scanner "https://github.com/juliofilizzola/batto/blob/main/src/Batto.Core/Logitech/LogitechDeviceScanner.cs"
click node_settings "https://github.com/juliofilizzola/batto/blob/main/src/Batto.Core/Storage/SettingsManager.cs"
click node_notify "https://github.com/juliofilizzola/batto/blob/main/src/Batto.Core/Notifications/NotificationManager.cs"
click node_winbt "https://github.com/juliofilizzola/batto/blob/main/src/Batto/Bluetooth/BluetoothManager.cs"
click node_gatt "https://github.com/juliofilizzola/batto/blob/main/src/Batto/Bluetooth/GattBatteryReader.cs"
click node_pnp "https://github.com/juliofilizzola/batto/blob/main/src/Batto/Bluetooth/PnpBatteryReader.cs"
click node_winread "https://github.com/juliofilizzola/batto/blob/main/src/Batto/Bluetooth/WindowsBatteryReader.cs"
click node_winui "https://github.com/juliofilizzola/batto/blob/main/src/Batto/ViewModels/MainViewModel.cs"
click node_wintray "https://github.com/juliofilizzola/batto/blob/main/src/Batto/Tray/TrayManager.cs"
click node_trayicon "https://github.com/juliofilizzola/batto/blob/main/src/Batto/Tray/IconGenerator.cs"
click node_native "https://github.com/juliofilizzola/batto/blob/main/src/Batto/Native/NativeMethods.cs"
click node_promotion "https://github.com/juliofilizzola/batto/blob/main/src/Batto/Tray/TrayPromotion.cs"
click node_bluezreg "https://github.com/juliofilizzola/batto/blob/main/src/Batto.Linux/Bluez/BlueZRegistry.cs"
click node_bluezsource "https://github.com/juliofilizzola/batto/blob/main/src/Batto.Linux/Bluez/BlueZDeviceSource.cs"
click node_bluezread "https://github.com/juliofilizzola/batto/blob/main/src/Batto.Linux/Bluez/BlueZBatteryReader.cs"
click node_linuxservices "https://github.com/juliofilizzola/batto/blob/main/src/Batto.Linux/AppServices.cs"
click node_sni "https://github.com/juliofilizzola/batto/blob/main/src/Batto.Linux/Tray/StatusNotifierHost.cs"
click node_linuxui "https://github.com/juliofilizzola/batto/blob/main/src/Batto.Linux/UI/MainViewModel.cs"
click node_freedesktop "https://github.com/juliofilizzola/batto/blob/main/src/Batto.Linux/Notifications/FreedesktopNotifier.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_monitor,node_device,node_classifier,node_scanner,node_settings,node_notify,node_user toneBlue
class node_winapp,node_winbt,node_gatt,node_pnp,node_winread,node_native,node_promotion toneAmber
class node_bluezreg,node_bluezsource,node_bluezread,node_linuxservices,node_sni,node_freedesktop toneMint
class node_winui,node_wintray,node_trayicon,node_linuxui toneRose
class node_bluez,node_osnotify toneIndigo
```

## Components

### Shared monitoring core

- [Battery monitor](https://github.com/juliofilizzola/batto/blob/main/src/Batto.Core/Battery/BatteryMonitor.cs): `src/Batto.Core/Battery/BatteryMonitor.cs`
- [Device model](https://github.com/juliofilizzola/batto/blob/main/src/Batto.Core/Models/BluetoothDeviceModel.cs): `src/Batto.Core/Models/BluetoothDeviceModel.cs`
- [Device classifier](https://github.com/juliofilizzola/batto/blob/main/src/Batto.Core/Bluetooth/DeviceClassifier.cs): `src/Batto.Core/Bluetooth/DeviceClassifier.cs`
- [Logitech HID++ scanner](https://github.com/juliofilizzola/batto/blob/main/src/Batto.Core/Logitech/LogitechDeviceScanner.cs): `src/Batto.Core/Logitech/LogitechDeviceScanner.cs`
- [Settings and autostart](https://github.com/juliofilizzola/batto/blob/main/src/Batto.Core/Storage/SettingsManager.cs): `src/Batto.Core/Storage/SettingsManager.cs`
- [Notification policy](https://github.com/juliofilizzola/batto/blob/main/src/Batto.Core/Notifications/NotificationManager.cs): `src/Batto.Core/Notifications/NotificationManager.cs`

### Windows application

- [Windows composition](https://github.com/juliofilizzola/batto/blob/main/src/Batto/App.xaml.cs): `src/Batto/App.xaml.cs`
- [Windows discovery](https://github.com/juliofilizzola/batto/blob/main/src/Batto/Bluetooth/BluetoothManager.cs): `src/Batto/Bluetooth/BluetoothManager.cs`
- [GATT battery reader](https://github.com/juliofilizzola/batto/blob/main/src/Batto/Bluetooth/GattBatteryReader.cs): `src/Batto/Bluetooth/GattBatteryReader.cs`
- [PnP battery reader](https://github.com/juliofilizzola/batto/blob/main/src/Batto/Bluetooth/PnpBatteryReader.cs): `src/Batto/Bluetooth/PnpBatteryReader.cs`
- [Windows reader](https://github.com/juliofilizzola/batto/blob/main/src/Batto/Bluetooth/WindowsBatteryReader.cs): `src/Batto/Bluetooth/WindowsBatteryReader.cs`
- [Windows tray integration](https://github.com/juliofilizzola/batto/blob/main/src/Batto/Native/NativeMethods.cs): `src/Batto/Native/NativeMethods.cs`
- [Tray icon promotion](https://github.com/juliofilizzola/batto/blob/main/src/Batto/Tray/TrayPromotion.cs): `src/Batto/Tray/TrayPromotion.cs`

### Linux application

- [BlueZ device registry](https://github.com/juliofilizzola/batto/blob/main/src/Batto.Linux/Bluez/BlueZRegistry.cs): `src/Batto.Linux/Bluez/BlueZRegistry.cs`
- [BlueZ discovery](https://github.com/juliofilizzola/batto/blob/main/src/Batto.Linux/Bluez/BlueZDeviceSource.cs): `src/Batto.Linux/Bluez/BlueZDeviceSource.cs`
- [BlueZ battery reader](https://github.com/juliofilizzola/batto/blob/main/src/Batto.Linux/Bluez/BlueZBatteryReader.cs): `src/Batto.Linux/Bluez/BlueZBatteryReader.cs`
- [Linux service composition](https://github.com/juliofilizzola/batto/blob/main/src/Batto.Linux/AppServices.cs): `src/Batto.Linux/AppServices.cs`
- [StatusNotifier tray](https://github.com/juliofilizzola/batto/blob/main/src/Batto.Linux/Tray/StatusNotifierHost.cs): `src/Batto.Linux/Tray/StatusNotifierHost.cs`
- [Desktop notifications](https://github.com/juliofilizzola/batto/blob/main/src/Batto.Linux/Notifications/FreedesktopNotifier.cs): `src/Batto.Linux/Notifications/FreedesktopNotifier.cs`

### User presentation

- [Device management UI](https://github.com/juliofilizzola/batto/blob/main/src/Batto/ViewModels/MainViewModel.cs): `src/Batto/ViewModels/MainViewModel.cs`
- [Tray and flyout](https://github.com/juliofilizzola/batto/blob/main/src/Batto/Tray/TrayManager.cs): `src/Batto/Tray/TrayManager.cs`
- [Tray icon rendering](https://github.com/juliofilizzola/batto/blob/main/src/Batto/Tray/IconGenerator.cs): `src/Batto/Tray/IconGenerator.cs`
- [Linux device UI](https://github.com/juliofilizzola/batto/blob/main/src/Batto.Linux/UI/MainViewModel.cs): `src/Batto.Linux/UI/MainViewModel.cs`

### Other components

- **Desktop user**
- **BlueZ over D-Bus**
- **Desktop notification service**

## Connections

- Desktop user → Tray and flyout: views status
- Windows composition → Battery monitor: composes (evidence: `src/Batto/App.xaml.cs`)
- Windows composition → Windows discovery: composes (evidence: `src/Batto/App.xaml.cs`)
- Windows composition → Settings and autostart: composes (evidence: `src/Batto/App.xaml.cs`)
- Windows composition → Tray and flyout: composes (evidence: `src/Batto/App.xaml.cs`)
- Windows composition → Logitech HID++ scanner: composes (evidence: `src/Batto/App.xaml.cs`)
- Battery monitor → Windows discovery: discovers devices (evidence: `src/Batto.Core/Battery/BatteryMonitor.cs`)
- Battery monitor → Logitech HID++ scanner: scans Logitech (evidence: `src/Batto.Core/Battery/BatteryMonitor.cs`)
- Battery monitor → Notification policy: raises alerts (evidence: `src/Batto.Core/Battery/BatteryMonitor.cs`)
- Battery monitor → Settings and autostart: loads and saves (evidence: `src/Batto.Core/Battery/BatteryMonitor.cs`)
- Windows discovery → Device classifier: classifies devices (evidence: `src/Batto/Bluetooth/BluetoothManager.cs`)
- Windows discovery → PnP battery reader: reads device properties (evidence: `src/Batto/Bluetooth/BluetoothManager.cs`)
- Battery monitor → GATT battery reader: reads BLE battery
- Battery monitor → PnP battery reader: reads PnP battery
- Battery monitor → Windows reader: uses platform readers (evidence: `src/Batto/App.xaml.cs`)
- Battery monitor → Device model: updates device state (evidence: `src/Batto.Core/Battery/BatteryMonitor.cs`)
- Device management UI → Battery monitor: manages devices (evidence: `src/Batto/ViewModels/MainViewModel.cs`)
- Device management UI → Settings and autostart: updates settings (evidence: `src/Batto/ViewModels/MainViewModel.cs`)
- Battery monitor → Tray and flyout: publishes battery changes (evidence: `src/Batto/Tray/TrayManager.cs`)
- Tray and flyout → Tray icon rendering: renders summary icon (evidence: `src/Batto/Tray/TrayManager.cs`)
- Tray and flyout → Windows tray integration: registers tray icon (evidence: `src/Batto/Tray/TrayManager.cs`)
- Tray and flyout → Tray icon promotion: promotes tray icons (evidence: `src/Batto/Tray/TrayManager.cs`)
- Desktop user → Device management UI: manages devices
- Desktop user → Linux device UI: manages devices
- Linux service composition → BlueZ device registry: creates registry (evidence: `src/Batto.Linux/AppServices.cs`)
- Linux service composition → BlueZ discovery: composes discovery (evidence: `src/Batto.Linux/AppServices.cs`)
- Linux service composition → BlueZ battery reader: composes reader (evidence: `src/Batto.Linux/AppServices.cs`)
- Linux service composition → Battery monitor: starts monitor (evidence: `src/Batto.Linux/AppServices.cs`)
- Linux service composition → Settings and autostart: loads settings (evidence: `src/Batto.Linux/AppServices.cs`)
- Linux service composition → Notification policy: composes policy (evidence: `src/Batto.Linux/AppServices.cs`)
- Linux service composition → Desktop notifications: configures notifier (evidence: `src/Batto.Linux/AppServices.cs`)
- Linux service composition → StatusNotifier tray: starts tray host (evidence: `src/Batto.Linux/AppServices.cs`)
- BlueZ device registry → BlueZ over D-Bus: watches D-Bus
- BlueZ discovery → BlueZ device registry: reads snapshots (evidence: `src/Batto.Linux/Bluez/BlueZDeviceSource.cs`)
- BlueZ battery reader → BlueZ device registry: reads battery state (evidence: `src/Batto.Linux/Bluez/BlueZBatteryReader.cs`)
- Notification policy → Desktop notifications: sends notifications (evidence: `src/Batto.Linux/AppServices.cs`)
- Desktop notifications → Desktop notification service: displays alerts
- Linux device UI → Device model: presents devices (evidence: `src/Batto.Linux/UI/MainViewModel.cs`)
- Desktop user → StatusNotifier tray: uses tray
