# risunity/notchi architecture

> Architecture diagram of the GitHub repository risunity/notchi, 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/risunity/notchi
- Repository: https://github.com/risunity/notchi

## Overview

Notchi is a native Windows notch overlay whose main user workflow is to interact with the expanded overlay, choose a feature, and receive media, system, calendar, file, or device functionality. The graph includes the documented feature branches and supporting runtime layers. Most relationships are evidenced by the README; the source index also confirms MainWindow’s service dependencies. Unsampled implementation details are not inferred beyond those documented capabilities.

Main entry points: [`MainWindow.xaml.cs`](https://github.com/risunity/notchi/blob/main/MainWindow.xaml.cs) (Feature navigation), [`MobileServerService.cs`](https://github.com/risunity/notchi/blob/main/MobileServerService.cs) (Mobile HTTP and WebSocket), [`MediaFocusWindow.xaml.cs`](https://github.com/risunity/notchi/blob/main/MediaFocusWindow.xaml.cs) (Media Focus card), [`DropShelfWindow.xaml.cs`](https://github.com/risunity/notchi/blob/main/DropShelfWindow.xaml.cs) (File drop shelf)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_overlay["Overlay and navigation"]
  node_overlay_ui["Notch overlay<br/>[MainWindow.xaml.cs]"]
  node_screen["Screen positioning<br/>[ScreenGeometry.cs]"]
  node_feature_nav["Feature navigation<br/>[MainWindow.xaml.cs]"]
end

subgraph group_media["Media experience"]
  node_media_controls["Media controls<br/>[MainWindow.xaml.cs]"]
  node_media_sessions["Windows media sessions<br/>[SmtcService.cs]"]
  node_media_focus["Media Focus card"]
  node_lyrics["Synced lyrics<br/>[LyricsService.cs]"]
end

subgraph group_desktop["Desktop tools"]
  node_system_metrics["System dashboard"]
  node_calendar["Calendar notes<br/>[CalendarStore.cs]"]
  node_note_window["Notes window<br/>[NoteWindow.xaml.cs]"]
  node_drop_shelf["File drop shelf"]
  node_conversion["File conversion"]
  node_conversion_engine["Conversion engine"]
end

subgraph group_mobile["Mobile companion"]
  node_mobile_service["Mobile HTTP and WebSocket"]
  node_pairing["Device pairing<br/>[PairingService.cs]"]
  node_paired_devices[("Paired device store<br/>[DeviceStore.cs]")]
end

subgraph group_runtime["Settings and runtime"]
  node_settings_ui["Settings interface"]
  node_settings_store[("Settings persistence<br/>[SettingsStore.cs]")]
  node_hotkeys["Global shortcuts"]
  node_volume["System volume"]
end

node_user(("Windows user"))

node_user -->|"interacts with"| node_overlay_ui
node_overlay_ui -->|"opens panels"| node_feature_nav
node_overlay_ui -->|"anchors on screen"| node_screen
node_feature_nav -->|"opens media"| node_media_controls
node_media_controls -->|"controls sessions"| node_media_sessions
node_feature_nav -->|"opens focus card"| node_media_focus
node_media_focus -->|"synchronizes playback"| node_media_sessions
node_media_focus -->|"loads lyrics"| node_lyrics
node_feature_nav -->|"shows metrics"| node_system_metrics
node_feature_nav -->|"opens calendar"| node_calendar
node_feature_nav -->|"opens notes"| node_note_window
node_user -->|"drops files"| node_drop_shelf
node_drop_shelf -->|"requests conversion"| node_conversion
node_conversion -->|"converts files"| node_conversion_engine
node_drop_shelf -->|"shares files"| node_mobile_service
node_mobile_service -->|"pairs devices"| node_pairing
node_mobile_service -->|"manages devices"| node_paired_devices
node_mobile_service -->|"synchronizes volume"| node_volume
node_feature_nav -->|"opens settings"| node_settings_ui
node_settings_ui -->|"persists settings"| node_settings_store
node_overlay_ui -->|"loads settings"| node_settings_store
node_user -->|"uses shortcuts"| node_hotkeys
node_hotkeys -->|"toggles overlay"| node_overlay_ui

click node_overlay_ui "https://github.com/risunity/notchi/blob/main/MainWindow.xaml.cs"
click node_screen "https://github.com/risunity/notchi/blob/main/ScreenGeometry.cs"
click node_feature_nav "https://github.com/risunity/notchi/blob/main/MainWindow.xaml.cs"
click node_media_controls "https://github.com/risunity/notchi/blob/main/MainWindow.xaml.cs"
click node_media_sessions "https://github.com/risunity/notchi/blob/main/SmtcService.cs"
click node_media_focus "https://github.com/risunity/notchi/blob/main/MediaFocusWindow.xaml.cs"
click node_lyrics "https://github.com/risunity/notchi/blob/main/LyricsService.cs"
click node_system_metrics "https://github.com/risunity/notchi/blob/main/SystemStatusService.cs"
click node_calendar "https://github.com/risunity/notchi/blob/main/CalendarStore.cs"
click node_note_window "https://github.com/risunity/notchi/blob/main/NoteWindow.xaml.cs"
click node_drop_shelf "https://github.com/risunity/notchi/blob/main/DropShelfWindow.xaml.cs"
click node_conversion "https://github.com/risunity/notchi/blob/main/Conversion/QuickConversionService.cs"
click node_mobile_service "https://github.com/risunity/notchi/blob/main/MobileServerService.cs"
click node_pairing "https://github.com/risunity/notchi/blob/main/PairingService.cs"
click node_paired_devices "https://github.com/risunity/notchi/blob/main/DeviceStore.cs"
click node_settings_ui "https://github.com/risunity/notchi/blob/main/SettingsWindow.xaml.cs"
click node_settings_store "https://github.com/risunity/notchi/blob/main/SettingsStore.cs"
click node_hotkeys "https://github.com/risunity/notchi/blob/main/GlobalHotkeyService.cs"
click node_volume "https://github.com/risunity/notchi/blob/main/AudioVolumeService.cs"
click node_conversion_engine "https://github.com/risunity/notchi/blob/main/Conversion/ConversionClient.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_overlay_ui,node_screen,node_feature_nav,node_user toneBlue
class node_media_controls,node_media_sessions,node_media_focus,node_lyrics toneAmber
class node_system_metrics,node_calendar,node_note_window,node_drop_shelf,node_conversion,node_conversion_engine toneMint
class node_mobile_service,node_pairing,node_paired_devices toneRose
class node_settings_ui,node_settings_store,node_hotkeys,node_volume toneIndigo
```

## Components

### Overlay and navigation

- [Notch overlay](https://github.com/risunity/notchi/blob/main/MainWindow.xaml.cs): `MainWindow.xaml.cs`
- [Screen positioning](https://github.com/risunity/notchi/blob/main/ScreenGeometry.cs): `ScreenGeometry.cs`
- [Feature navigation](https://github.com/risunity/notchi/blob/main/MainWindow.xaml.cs): `MainWindow.xaml.cs`

### Media experience

- [Media controls](https://github.com/risunity/notchi/blob/main/MainWindow.xaml.cs): `MainWindow.xaml.cs`
- [Windows media sessions](https://github.com/risunity/notchi/blob/main/SmtcService.cs): `SmtcService.cs`
- [Media Focus card](https://github.com/risunity/notchi/blob/main/MediaFocusWindow.xaml.cs): `MediaFocusWindow.xaml.cs`
- [Synced lyrics](https://github.com/risunity/notchi/blob/main/LyricsService.cs): `LyricsService.cs`

### Desktop tools

- [System dashboard](https://github.com/risunity/notchi/blob/main/SystemStatusService.cs): `SystemStatusService.cs`
- [Calendar notes](https://github.com/risunity/notchi/blob/main/CalendarStore.cs): `CalendarStore.cs`
- [Notes window](https://github.com/risunity/notchi/blob/main/NoteWindow.xaml.cs): `NoteWindow.xaml.cs`
- [File drop shelf](https://github.com/risunity/notchi/blob/main/DropShelfWindow.xaml.cs): `DropShelfWindow.xaml.cs`
- [File conversion](https://github.com/risunity/notchi/blob/main/Conversion/QuickConversionService.cs): `Conversion/QuickConversionService.cs`
- [Conversion engine](https://github.com/risunity/notchi/blob/main/Conversion/ConversionClient.cs): `Conversion/ConversionClient.cs`

### Mobile companion

- [Mobile HTTP and WebSocket](https://github.com/risunity/notchi/blob/main/MobileServerService.cs): `MobileServerService.cs`
- [Device pairing](https://github.com/risunity/notchi/blob/main/PairingService.cs): `PairingService.cs`
- [Paired device store](https://github.com/risunity/notchi/blob/main/DeviceStore.cs): `DeviceStore.cs`

### Settings and runtime

- [Settings interface](https://github.com/risunity/notchi/blob/main/SettingsWindow.xaml.cs): `SettingsWindow.xaml.cs`
- [Settings persistence](https://github.com/risunity/notchi/blob/main/SettingsStore.cs): `SettingsStore.cs`
- [Global shortcuts](https://github.com/risunity/notchi/blob/main/GlobalHotkeyService.cs): `GlobalHotkeyService.cs`
- [System volume](https://github.com/risunity/notchi/blob/main/AudioVolumeService.cs): `AudioVolumeService.cs`

### Other components

- **Windows user**

## Connections

- Windows user → Notch overlay: interacts with (evidence: `README.md`)
- Notch overlay → Feature navigation: opens panels (evidence: `README.md`)
- Notch overlay → Screen positioning: anchors on screen (evidence: `README.md`)
- Feature navigation → Media controls: opens media (evidence: `README.md`)
- Media controls → Windows media sessions: controls sessions (evidence: `README.md`)
- Feature navigation → Media Focus card: opens focus card (evidence: `README.md`)
- Media Focus card → Windows media sessions: synchronizes playback (evidence: `README.md`)
- Media Focus card → Synced lyrics: loads lyrics (evidence: `README.md`)
- Feature navigation → System dashboard: shows metrics (evidence: `README.md`)
- Feature navigation → Calendar notes: opens calendar (evidence: `README.md`)
- Feature navigation → Notes window: opens notes (evidence: `README.md`)
- Windows user → File drop shelf: drops files (evidence: `README.md`)
- File drop shelf → File conversion: requests conversion (evidence: `README.md`)
- File conversion → Conversion engine: converts files (evidence: `Conversion/QuickConversionService.cs`)
- File drop shelf → Mobile HTTP and WebSocket: shares files (evidence: `README.md`)
- Mobile HTTP and WebSocket → Device pairing: pairs devices (evidence: `MobileServerService.cs`)
- Mobile HTTP and WebSocket → Paired device store: manages devices (evidence: `MobileServerService.cs`)
- Mobile HTTP and WebSocket → System volume: synchronizes volume (evidence: `README.md`)
- Feature navigation → Settings interface: opens settings (evidence: `README.md`)
- Settings interface → Settings persistence: persists settings (evidence: `SettingsWindow.xaml.cs`)
- Notch overlay → Settings persistence: loads settings (evidence: `MainWindow.xaml.cs`)
- Windows user → Global shortcuts: uses shortcuts (evidence: `README.md`)
- Global shortcuts → Notch overlay: toggles overlay (evidence: `README.md`)
