# reign9201/mihome-mac architecture

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

- Interactive diagram: https://gitdiagram.com/reign9201/mihome-mac
- Repository: https://github.com/reign9201/mihome-mac

## Overview

MiHome Mac is a macOS Mi Home client. The primary workflow is scan-to-login, select a home, browse devices, and control devices or run scenes; camera viewing and local automations are parallel product workflows. The graph also preserves quick controls, metering, speaker commands, diagnostics, and messaging-platform AI integrations. Source excerpts show the desktop command boundary, assistant execution, and camera streaming, while some README-described features are represented at their documented subsystem paths; unsampled implementation details are not inferred.

Main entry points: [`desktop/ui/app.js`](https://github.com/reign9201/mihome-mac/blob/main/desktop/ui/app.js) (Desktop UI), [`desktop/src-tauri/src/main.rs`](https://github.com/reign9201/mihome-mac/blob/main/desktop/src-tauri/src/main.rs) (Desktop commands), [`core/src/cloud.rs`](https://github.com/reign9201/mihome-mac/blob/main/core/src/cloud.rs) (Home and devices), [`desktop/src-tauri/src/platform_bridge.rs`](https://github.com/reign9201/mihome-mac/blob/main/desktop/src-tauri/src/platform_bridge.rs) (Platform bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop experience"]
  node_ui["Desktop UI<br/>[app.js]"]
  node_camera_ui["Camera player<br/>[camera-player.js]"]
  node_locale["Localization<br/>[i18n.js]"]
  node_tauri["Desktop commands<br/>[main.rs]"]
end

subgraph group_core["Mi Home core"]
  node_auth["QR login<br/>[auth.rs]"]
  node_cloud["Home and devices<br/>[cloud.rs]"]
  node_spec["Device capabilities<br/>[spec.rs]"]
  node_scenes["Scene execution<br/>[cloud.rs]"]
  node_stats["Energy statistics<br/>[cloud.rs]"]
  node_logging[("Diagnostics<br/>[logging.rs]")]
end

subgraph group_camera["Camera streaming"]
  node_camera_core["Camera discovery<br/>[camera.rs]"]
  node_remote["Remote camera<br/>[remote_stream.rs]"]
  node_local_camera["Local camera<br/>[camera.rs]"]
  node_media["Media handling<br/>[media.rs]"]
end

subgraph group_automation["Automation and quick access"]
  node_automation[("Scheduled rules<br/>[automation.rs]")]
  node_quick[("Quick preferences<br/>[quick_prefs.rs]")]
end

subgraph group_assistant["Assistant integrations"]
  node_assistant["Intent engine"]
  node_platform_bridge["Platform bridge<br/>[platform_bridge.rs]"]
  node_feishu["Feishu bot<br/>[feishu_ws.rs]"]
  node_wecom["WeCom bot<br/>[wecom_ws.rs]"]
  node_dingtalk["DingTalk bot<br/>[dingtalk_ws.rs]"]
  node_asr["Voice transcription<br/>[asr.rs]"]
  node_integration_settings[("Integration settings<br/>[integration.rs]")]
end

node_user(("User"))
node_xiaomi{{"Xiaomi services"}}
node_platforms{{"Chat platforms"}}

node_user -->|"uses"| node_ui
node_ui -->|"invokes commands"| node_tauri
node_tauri -->|"starts login"| node_auth
node_auth -->|"authenticates with"| node_xiaomi
node_tauri -->|"loads account"| node_cloud
node_cloud -->|"requests home data"| node_xiaomi
node_ui -->|"shows devices"| node_cloud
node_cloud -->|"uses device specs"| node_spec
node_ui -->|"runs scenes"| node_scenes
node_ui -->|"views energy"| node_stats
node_tauri -->|"starts cameras"| node_camera_core
node_cloud -->|"discovers cameras"| node_camera_core
node_camera_core -->|"creates local streams"| node_local_camera
node_camera_core -->|"creates remote streams"| node_remote
node_remote -->|"processes media"| node_media
node_tauri -->|"returns stream details"| node_camera_ui
node_camera_ui -->|"plays video"| node_user
node_tauri -->|"runs scheduled rules"| node_automation
node_ui -->|"configures quick panel"| node_quick
node_ui -->|"selects language"| node_locale
node_ui -->|"exports diagnostics"| node_logging
node_ui -->|"sends instruction"| node_assistant
node_assistant -->|"executes device actions"| node_cloud
node_platforms -->|"sends messages"| node_feishu
node_platforms -->|"sends messages"| node_wecom
node_platforms -->|"sends messages"| node_dingtalk
node_feishu -->|"forwards messages"| node_platform_bridge
node_wecom -->|"forwards messages"| node_platform_bridge
node_dingtalk -->|"forwards messages"| node_platform_bridge
node_platform_bridge -->|"dispatches requests"| node_assistant
node_feishu -->|"transcribes voice"| node_asr
node_platform_bridge -.->|"checks bindings"| node_integration_settings

click node_ui "https://github.com/reign9201/mihome-mac/blob/main/desktop/ui/app.js"
click node_camera_ui "https://github.com/reign9201/mihome-mac/blob/main/desktop/ui/camera-player.js"
click node_locale "https://github.com/reign9201/mihome-mac/blob/main/desktop/ui/i18n.js"
click node_tauri "https://github.com/reign9201/mihome-mac/blob/main/desktop/src-tauri/src/main.rs"
click node_auth "https://github.com/reign9201/mihome-mac/blob/main/core/src/auth.rs"
click node_cloud "https://github.com/reign9201/mihome-mac/blob/main/core/src/cloud.rs"
click node_spec "https://github.com/reign9201/mihome-mac/blob/main/core/src/spec.rs"
click node_scenes "https://github.com/reign9201/mihome-mac/blob/main/core/src/cloud.rs"
click node_stats "https://github.com/reign9201/mihome-mac/blob/main/core/src/cloud.rs"
click node_camera_core "https://github.com/reign9201/mihome-mac/blob/main/core/src/camera.rs"
click node_remote "https://github.com/reign9201/mihome-mac/blob/main/core/src/remote_stream.rs"
click node_local_camera "https://github.com/reign9201/mihome-mac/blob/main/core/src/camera.rs"
click node_media "https://github.com/reign9201/mihome-mac/blob/main/core/src/media.rs"
click node_automation "https://github.com/reign9201/mihome-mac/blob/main/core/src/automation.rs"
click node_quick "https://github.com/reign9201/mihome-mac/blob/main/core/src/quick_prefs.rs"
click node_assistant "https://github.com/reign9201/mihome-mac/blob/main/desktop/src-tauri/src/assistant_engine.rs"
click node_platform_bridge "https://github.com/reign9201/mihome-mac/blob/main/desktop/src-tauri/src/platform_bridge.rs"
click node_feishu "https://github.com/reign9201/mihome-mac/blob/main/desktop/src-tauri/src/feishu_ws.rs"
click node_wecom "https://github.com/reign9201/mihome-mac/blob/main/desktop/src-tauri/src/wecom_ws.rs"
click node_dingtalk "https://github.com/reign9201/mihome-mac/blob/main/desktop/src-tauri/src/dingtalk_ws.rs"
click node_asr "https://github.com/reign9201/mihome-mac/blob/main/desktop/src-tauri/src/asr.rs"
click node_integration_settings "https://github.com/reign9201/mihome-mac/blob/main/core/src/integration.rs"
click node_logging "https://github.com/reign9201/mihome-mac/blob/main/core/src/logging.rs"

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_ui,node_camera_ui,node_locale,node_tauri,node_user toneBlue
class node_auth,node_cloud,node_spec,node_scenes,node_stats,node_logging toneAmber
class node_camera_core,node_remote,node_local_camera,node_media toneMint
class node_automation,node_quick toneRose
class node_assistant,node_platform_bridge,node_feishu,node_wecom,node_dingtalk,node_asr,node_integration_settings,node_xiaomi,node_platforms toneIndigo
```

## Components

### Desktop experience

- [Desktop UI](https://github.com/reign9201/mihome-mac/blob/main/desktop/ui/app.js): `desktop/ui/app.js`
- [Camera player](https://github.com/reign9201/mihome-mac/blob/main/desktop/ui/camera-player.js): `desktop/ui/camera-player.js`
- [Localization](https://github.com/reign9201/mihome-mac/blob/main/desktop/ui/i18n.js): `desktop/ui/i18n.js`
- [Desktop commands](https://github.com/reign9201/mihome-mac/blob/main/desktop/src-tauri/src/main.rs): `desktop/src-tauri/src/main.rs`

### Mi Home core

- [QR login](https://github.com/reign9201/mihome-mac/blob/main/core/src/auth.rs): `core/src/auth.rs`
- [Home and devices](https://github.com/reign9201/mihome-mac/blob/main/core/src/cloud.rs): `core/src/cloud.rs`
- [Device capabilities](https://github.com/reign9201/mihome-mac/blob/main/core/src/spec.rs): `core/src/spec.rs`
- [Scene execution](https://github.com/reign9201/mihome-mac/blob/main/core/src/cloud.rs): `core/src/cloud.rs`
- [Energy statistics](https://github.com/reign9201/mihome-mac/blob/main/core/src/cloud.rs): `core/src/cloud.rs`
- [Diagnostics](https://github.com/reign9201/mihome-mac/blob/main/core/src/logging.rs): `core/src/logging.rs`

### Camera streaming

- [Camera discovery](https://github.com/reign9201/mihome-mac/blob/main/core/src/camera.rs): `core/src/camera.rs`
- [Remote camera](https://github.com/reign9201/mihome-mac/blob/main/core/src/remote_stream.rs): `core/src/remote_stream.rs`
- [Local camera](https://github.com/reign9201/mihome-mac/blob/main/core/src/camera.rs): `core/src/camera.rs`
- [Media handling](https://github.com/reign9201/mihome-mac/blob/main/core/src/media.rs): `core/src/media.rs`

### Automation and quick access

- [Scheduled rules](https://github.com/reign9201/mihome-mac/blob/main/core/src/automation.rs): `core/src/automation.rs`
- [Quick preferences](https://github.com/reign9201/mihome-mac/blob/main/core/src/quick_prefs.rs): `core/src/quick_prefs.rs`

### Assistant integrations

- [Intent engine](https://github.com/reign9201/mihome-mac/blob/main/desktop/src-tauri/src/assistant_engine.rs): `desktop/src-tauri/src/assistant_engine.rs`
- [Platform bridge](https://github.com/reign9201/mihome-mac/blob/main/desktop/src-tauri/src/platform_bridge.rs): `desktop/src-tauri/src/platform_bridge.rs`
- [Feishu bot](https://github.com/reign9201/mihome-mac/blob/main/desktop/src-tauri/src/feishu_ws.rs): `desktop/src-tauri/src/feishu_ws.rs`
- [WeCom bot](https://github.com/reign9201/mihome-mac/blob/main/desktop/src-tauri/src/wecom_ws.rs): `desktop/src-tauri/src/wecom_ws.rs`
- [DingTalk bot](https://github.com/reign9201/mihome-mac/blob/main/desktop/src-tauri/src/dingtalk_ws.rs): `desktop/src-tauri/src/dingtalk_ws.rs`
- [Voice transcription](https://github.com/reign9201/mihome-mac/blob/main/desktop/src-tauri/src/asr.rs): `desktop/src-tauri/src/asr.rs`
- [Integration settings](https://github.com/reign9201/mihome-mac/blob/main/core/src/integration.rs): `core/src/integration.rs`

### Other components

- **User**
- **Xiaomi services**
- **Chat platforms**

## Connections

- User → Desktop UI: uses (evidence: `README.md`)
- Desktop UI → Desktop commands: invokes commands (evidence: `desktop/src-tauri/src/main.rs`)
- Desktop commands → QR login: starts login (evidence: `README.md`)
- QR login → Xiaomi services: authenticates with (evidence: `core/src/auth.rs`)
- Desktop commands → Home and devices: loads account (evidence: `desktop/src-tauri/src/main.rs`)
- Home and devices → Xiaomi services: requests home data (evidence: `core/src/cloud.rs`)
- Desktop UI → Home and devices: shows devices (evidence: `README.md`)
- Home and devices → Device capabilities: uses device specs (evidence: `core/src/assistant.rs`)
- Desktop UI → Scene execution: runs scenes (evidence: `README.md`)
- Desktop UI → Energy statistics: views energy (evidence: `README.md`)
- Desktop commands → Camera discovery: starts cameras (evidence: `desktop/src-tauri/src/main.rs`)
- Home and devices → Camera discovery: discovers cameras (evidence: `core/src/cloud.rs`)
- Camera discovery → Local camera: creates local streams (evidence: `core/src/camera.rs`)
- Camera discovery → Remote camera: creates remote streams (evidence: `core/src/remote_stream.rs`)
- Remote camera → Media handling: processes media (evidence: `core/src/remote_stream.rs`)
- Desktop commands → Camera player: returns stream details (evidence: `desktop/src-tauri/src/main.rs`)
- Camera player → User: plays video (evidence: `README.md`)
- Desktop commands → Scheduled rules: runs scheduled rules (evidence: `README.md`)
- Desktop UI → Quick preferences: configures quick panel (evidence: `README.md`)
- Desktop UI → Localization: selects language (evidence: `README.md`)
- Desktop UI → Diagnostics: exports diagnostics (evidence: `README.md`)
- Desktop UI → Intent engine: sends instruction
- Intent engine → Home and devices: executes device actions (evidence: `desktop/src-tauri/src/assistant_engine.rs`)
- Chat platforms → Feishu bot: sends messages (evidence: `README.md`)
- Chat platforms → WeCom bot: sends messages (evidence: `README.md`)
- Chat platforms → DingTalk bot: sends messages (evidence: `README.md`)
- Feishu bot → Platform bridge: forwards messages (evidence: `desktop/src-tauri/src/feishu_ws.rs`)
- WeCom bot → Platform bridge: forwards messages (evidence: `desktop/src-tauri/src/wecom_ws.rs`)
- DingTalk bot → Platform bridge: forwards messages (evidence: `desktop/src-tauri/src/dingtalk_ws.rs`)
- Platform bridge → Intent engine: dispatches requests (evidence: `desktop/src-tauri/src/platform_bridge.rs`)
- Feishu bot → Voice transcription: transcribes voice (evidence: `desktop/src-tauri/src/feishu_ws.rs`)
- Platform bridge → Integration settings: checks bindings
