# polargoose/bluetoothdevicepairing architecture

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

- Interactive diagram: https://gitdiagram.com/polargoose/bluetoothdevicepairing
- Repository: https://github.com/polargoose/bluetoothdevicepairing

## Overview

##### Project type and purpose
- This is a console-based command-line utility (written in C#/.NET) for discovering, pairing, connecting, disconnecting, and unpairing Bluetooth and BLE audio devices on Windows. It exposes a set of commands (e.g. “discover”, “pair-by-mac”, “disconnect-bluetooth-audio-device-by-name”) that call into a domain library which wraps the Windows Bluetooth APIs.

##### File structure
- Top-level: solution file, build scripts, nuget.config, README, LICENSE
- src/Program.cs → entry point that bootstraps a command parser and dispatches to “Commands”
- src/Commands → individual command classes (e.g. PairDeviceByMac, DiscoverDevices) + shared options & utilities
- src/Bluetooth → core domain library with sub-packages:
- Adapters (AdapterFinder, Adapter, AdapterMacAddress)
- Devices (BluetoothDevice, BluetoothLeDevice, AudioDevice + enumerators, DeviceDiscoverer, DevicePairer, DeviceUnPairer)
- Utils (filtering, watchers)
- src/Utils → cross-cutting exception type
- FodyWeavers.xml, Directory.Build.props → build/config glue
- Program.cs + build.ps1 + GitHub Actions workflow → deployment pipeline

##### README for additional insights
- Describes commands, behavior when pairing, discovery time, return codes
- Target platform: Windows 10 1809+
- Depends on Windows.Devices.Enumeration UWP APIs via interop calls in src/Bluetooth/Devices/Interop.cs
- No external services or databases—purely local OS API calls

##### Detail & thoroughness
- If desired, annotate potential extension points (e.g. adding new Commands, adding support for another OS API)
- Layers—don’t collapse the domain layer; show Adapters vs. Devices vs. AudioDevices submodules

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% CLI Layer
    subgraph "CLI Layer"
        direction TB
        CLI["Program.cs"]:::cli
    end

    %% Commands Layer
    subgraph "Commands Layer"
        direction TB
        CD1["DiscoverDevices"]:::cmd
        CD2["PairDeviceByMac"]:::cmd
        CD3["PairDeviceByName"]:::cmd
        CD4["UnPairDeviceByMac"]:::cmd
        CD5["UnPairDeviceByName"]:::cmd
        CD6["DisconnectBluetoothAudioDeviceByMac"]:::cmd
        CD7["DisconnectBluetoothAudioDeviceByName"]:::cmd
        CD8["ListAdapters"]:::cmd
    end

    %% Command Utilities
    subgraph "Command Utilities"
        direction TB
        CU1["CommonOptions"]:::cmdutil
        CU2["DeviceFinder"]:::cmdutil
        CU3["AudioDeviceDisconnector"]:::cmdutil
    end

    %% Domain Layer
    subgraph "Domain Layer"
        direction TB

        subgraph "Adapter Management"
            direction TB
            AF["AdapterFinder"]:::domain
            A["Adapter"]:::domain
            AM["AdapterMacAddress"]:::domain
        end

        subgraph "Device Discovery & Pairing"
            direction TB
            DD["DeviceDiscoverer"]:::domain
            DP["DevicePairer"]:::domain
            DU["DeviceUnPairer"]:::domain
            D["Device"]:::domain
            BD["BluetoothDevice"]:::domain
            BLD["BluetoothLeDevice"]:::domain
            DI["DeviceInfoId"]:::domain
            DM["DeviceMacAddress"]:::domain
        end

        subgraph "Audio Device Management"
            direction TB
            AE["AudioDeviceEnumerator"]:::domain
            AD["AudioDevice"]:::domain
        end

        subgraph "Domain Utilities"
            direction TB
            AFu["AsqFilter"]:::domainutil
            DW["DeviceWatcher"]:::domainutil
        end
    end

    %% Interop Layer
    subgraph "Interop Layer"
        direction TB
        IO["Interop"]:::infra
    end

    %% External System
    ext["Windows Bluetooth API\n(Windows 10 1809+)"]:::external

    %% Connections
    CLI -->|"dispatch"| CD1
    CLI -->|"dispatch"| CD2
    CLI -->|"dispatch"| CD3
    CLI -->|"dispatch"| CD4
    CLI -->|"dispatch"| CD5
    CLI -->|"dispatch"| CD6
    CLI -->|"dispatch"| CD7
    CLI -->|"dispatch"| CD8

    CD1 -->|"uses"| CU1
    CD1 -->|"uses"| CU2
    CD1 -->|"Execute()"| DD

    CD2 -->|"uses"| CU1
    CD2 -->|"Execute()"| DP

    CD3 -->|"uses"| CU1
    CD3 -->|"Execute()"| DP

    CD4 -->|"uses"| CU1
    CD4 -->|"Execute()"| DU

    CD5 -->|"uses"| CU1
    CD5 -->|"Execute()"| DU

    CD6 -->|"uses"| CU1
    CD6 -->|"uses"| CU3
    CD6 -->|"Execute()"| AD

    CD7 -->|"uses"| CU1
    CD7 -->|"uses"| CU3
    CD7 -->|"Execute()"| AD

    CD8 -->|"uses"| CU1
    CD8 -->|"Execute()"| AF

    DD -->|"FindAsync()"| AF
    DP -->|"PairAsync()"| AF
    DU -->|"UnPairAsync()"| AF

    DD -->|"creates"| D
    D -->|"instanceof"| BD
    D -->|"instanceof"| BLD
    DD -->|"reads"| DI
    DD -->|"reads"| DM

    AE -->|"Enumerate()"| AD

    AF --> DW
    DD --> AFu

    DD -->|"PInvoke"| IO
    DP -->|"PInvoke"| IO
    DU -->|"PInvoke"| IO
    AD -->|"PInvoke"| IO

    IO -->|"calls"| ext

    %% Click Events
    click CLI "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Program.cs"
    click CD1 "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Commands/DiscoverDevices.cs"
    click CD2 "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Commands/PairDeviceByMac.cs"
    click CD3 "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Commands/PairDeviceByName.cs"
    click CD4 "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Commands/UnPairDeviceByMac.cs"
    click CD5 "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Commands/UnPairDeviceByName.cs"
    click CD6 "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Commands/DisconnectBluetoothAudioDeviceByMac.cs"
    click CD7 "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Commands/DisconnectBluetoothAudioDeviceByName.cs"
    click CD8 "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Commands/ListAdapters.cs"
    click CU1 "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Commands/Utils/CommonOptions.cs"
    click CU2 "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Commands/Utils/DeviceFinder.cs"
    click CU3 "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Commands/Utils/AudioDeviceDisconnector.cs"
    click AF "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Bluetooth/Adapters/AdapterFinder.cs"
    click A "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Bluetooth/Adapters/Adapter.cs"
    click AM "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Bluetooth/Adapters/AdapterMacAddress.cs"
    click DD "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Bluetooth/Devices/DeviceDiscoverer.cs"
    click DP "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Bluetooth/Devices/DevicePairer.cs"
    click DU "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Bluetooth/Devices/DeviceUnPairer.cs"
    click D "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Bluetooth/Devices/Device.cs"
    click BD "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Bluetooth/Devices/BluetoothDevice.cs"
    click BLD "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Bluetooth/Devices/BluetoothLeDevice.cs"
    click DI "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Bluetooth/Devices/DeviceInfoId.cs"
    click DM "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Bluetooth/Devices/DeviceMacAddress.cs"
    click AE "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Bluetooth/Devices/AudioDevices/AudioDeviceEnumerator.cs"
    click AD "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Bluetooth/Devices/AudioDevices/AudioDevice.cs"
    click AFu "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Bluetooth/Devices/Utils/AsqFilter.cs"
    click DW "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Bluetooth/Devices/Utils/DeviceWatcher.cs"
    click IO "https://github.com/polargoose/bluetoothdevicepairing/blob/master/src/Bluetooth/Devices/AudioDevices/Interop.cs"

    %% Styles
    classDef cli fill:#DDEBF7,stroke:#6C8EBF,color:#000;
    classDef cmd fill:#B7E1CD,stroke:#6AA84F,color:#000;
    classDef cmdutil fill:#E2EFDA,stroke:#6AA84F,color:#000;
    classDef domain fill:#C6EFCE,stroke:#38761D,color:#000;
    classDef domainutil fill:#EBF1DE,stroke:#38761D,color:#000;
    classDef infra fill:#FCE4D6,stroke:#E69138,color:#000;
    classDef external fill:#E7E6E6,stroke:#999999,color:#000;
```
