English | 简体中文

MenuBarMijia

Control your entire home right from your computer, without picking up your phone.
A native macOS menu-bar app for Xiaomi / Mijia smart home devices, with a companion Windows 11 tray build.
Scan a QR code to connect directly to Mi Home without setting up Home Assistant. Features keyboard fuzzy search, push-to-talk voice, Mac event automation, and one-click undo.

Download latest · Install & Connect · Platform Comparison · Safety & Privacy · Changelog

# Recommended one-line installation on macOS via Homebrew Cask
brew install --cask jryang1997/tap/menubarmijia

macOS demo: open the panel, search for a study lamp by pinyin initials, and turn it on

_{macOS demo mode with simulated devices.}

Why Put Smart Home Control on Your Desktop?

When coding, writing, or in a meeting, you don't need to reach for your phone:

Keep Your Hands on the Keyboard: Press ⌥M to summon the panel, type a name or pinyin initials (e.g. sftd for "Study Desk Lamp"), and hit Return to toggle. Open a device’s details and use the arrow keys to adjust brightness or AC temperature. No scrolling through nested room trees.
Push-to-Talk, Release to Run: Hold ⌥M or the menu bar icon to speak your command, and release when you are done. Everyday commands like switching lights or setting the thermostat are interpreted by local parsing rules—no wake words, no sluggish voice chatter. Optional AI backends handle multi-step requests.
Sync with Your Daily Work Rhythm: Automatically turn off lights when you lock your Mac or step away. Trigger your focus lighting when plugging in an external display. All automation rules are disabled by default; you stay in full control of what triggers when.
All Off, with Undo: Hold "All Off" when it is time to call it a day. Plugs and robot vacuums stay on by default, and if you change your mind, the undo button brings your devices back.

Feature Demos

Here are a few everyday actions in the macOS demo home. The interface shown is in Chinese.

1. Push-to-Talk Voice Control

No wake words needed. Hold the menu bar icon or global shortcut to speak, and see execution receipts right away (showing local millisecond execution or AI resolution).

macOS demo: hold the shortcut, speak, and switch the study lamp to moonlight mode

2. Room All-Off with Safety Protection & Undo

Heading out or turning in? Hold "All Off" for 0.6 seconds to switch off participating devices in the current view. Plugs and robot vacuums are left alone by default, and you can change that in settings. If you switch something off by mistake, tap Undo.

macOS demo: hold All Off, leave the plug on, and undo

3. macOS Display & Lock-Screen Automation

Turn everyday desktop transitions into ambient triggers. Configure a rule to turn off lights when you lock your screen or put your Mac to sleep. You can also configure a separate rule for returning.

macOS automation demo: lock the screen and turn off the living room light

4. Climate Trends & Energy Metrics

Wondering whether the room is warmer than yesterday? On macOS, open a sensor to see its temperature and humidity trends over 24 hours or 7 days. For plugs that report energy readings, device details show today’s usage and settings show the last 7 days.

macOS demo: inspect a sensor trend over 24 hours and 7 days

Features & Platform Matrix

The macOS version is built natively in Swift 6, while the Windows 11 client is an independent implementation using Tauri v2 and TypeScript. Both share verified golden fixtures (Tests/Fixtures/) for protocol and intent matching, while respecting system platform differences.

Quick Start

1. Requirements & Installation

macOS: macOS 14 (Sonoma) or later.
Windows: Windows 11 (64-bit).

Installing on macOS

Method A: Homebrew Cask (Recommended)

brew install --cask jryang1997/tap/menubarmijia

If Homebrew asks to trust a new third-party tap, run brew trust --cask jryang1997/tap/menubarmijia first.

Method B: Direct DMG Download Download the latest macOS DMG from GitHub Releases and drag MenuBarMijia.app into your Applications folder.

About macOS Gatekeeper:

This project is an independent open-source tool and is not enrolled in the paid Apple Developer Program (no Developer ID notarization). If Gatekeeper blocks initial launch, open System Settings → Privacy & Security, scroll down, and click "Open Anyway" for MenuBarMijia.

Installing on Windows 11

Download the latest Windows x64 .exe or .msi from GitHub Releases.

About Windows SmartScreen:

The Windows binary is not signed with an enterprise Authenticode certificate. If SmartScreen shows "Windows protected your PC", click "More info" → "Run anyway". SHA-256 digests are published on each Release for manual verification.

2. Connect Your Devices

Click the menu bar icon to reveal the panel, then open Settings ⚙️:

Option A: Mi Home Direct Cloud Connect (Recommended):

Select "Mi Cloud Connect" in Settings. A QR code appears on screen. Scan it with the official Mi Home app on your phone to link your account. All your homes, rooms, and supported devices sync instantly.

Option B: Home Assistant Local Connection (macOS Only):

Select "Home Assistant" and enter your local instance URL (e.g. http://192.168.1.100:8123) and Long-Lived Access Token. The synthesizer groups supported sensor and switch entities into device cards.

Option C: Offline Demo Home:

Explore the interface and controls without an account using simulated devices.

Keyboard Shortcuts & Natural Commands

Keyboard Navigation

These panel shortcuts apply to macOS. On Windows, the default shortcut to open the panel is Alt+M.

Local Natural Language Commands

These phrases are parsed locally without any AI API key or cloud model tokens:

Power: "turn off study light", "turn on living room ac", "turn off all lights"
Lighting presets: "study light moonlight mode", "daylight mode"
Adjustments: "dimmer", "brighter", "set bedroom light to 40%"
Climate & Fan: "set ac to 24 degrees", "warmer", "fan natural wind"
Timers: "in 10 minutes turn off study light", "cancel timer"
Undo: "undo", "revert" (active for 10 minutes after any batch execution)

Safety, Privacy & Limitations

MenuBarMijia is an independent open-source project, not an official Xiaomi app. Mi Home cloud control needs an internet connection. If you already use Home Assistant, you can connect your own instance on macOS.

Account credentials and AI keys are stored in the macOS Keychain or Windows Credential Manager. macOS may ask for Keychain permission after an update. When migrating credentials from an older version, the plaintext copy is removed after the Keychain accepts it.

Everyday commands are handled by local rules. You can also connect an AI service of your choice for more complex requests. The request includes your command, device and environment information, and any habit summary you have enabled. Speech recognition uses system services; on-device-only recognition is available for supported languages.

To help prevent mistakes, low-confidence AI suggestions and actions such as turning on a heater, switching a plug, or starting a vacuum wait for your confirmation. URL controls also ask first by default, with an option to enable direct control.

The macOS app is not yet notarized by Apple, so you may need to allow it in System Settings the first time. Windows may show a SmartScreen prompt. macOS updates are verified with an Ed25519 public key; the signing key stays offline. See ADR-0007 for more on connection options.

Development & Architecture

Architecture: The macOS version is written in pure Swift 6 with no third-party Swift runtime dependencies, adhering to strict concurrency rules. Core protocol handling and device synthesis live in MijiaCore with full headless test coverage. The Windows client is built with Tauri v2 (Rust + TypeScript + Vite).
Cross-Platform Consistency: Both platforms run separate test suites against shared golden test fixtures in Tests/Fixtures/ (intents, specs, regions, AI payloads) to prevent behavioral drift (see ADR-0006).

Local Build & Verification

# Run secret checks, linters, and Swift tests on macOS
bash scripts/check.sh
Build, sign locally, and launch MenuBarMijia.app
bash scripts/build_app.sh
Build and test the Windows tray app
cd windows
npm install
npm test
npm run build

Please review CODING_STANDARDS.md before submitting pull requests. Key domain concepts are documented in GLOSSARY.md.

Contributors

Thanks to everyone who has contributed features, fixes, and feedback:

@jryang1997 (一群小羊说) — Creator & maintainer
@almightyYantao (Alimighty.Yantao) — Multi-key Mesh switch split-device synthesis (#6, #7), multi-home switcher & light-group scene filtering (#8), visual skin system, inline climate module, drag-to-reorder layout & custom device groups (#9), macOS app bundle icon packaging (#10), panel drop-in animation, local device renaming & room-strip polish (#11), Windows feature parity and cross-platform UI fixes (#12), and redundant-write optimization for provider snapshots (#66)

License & Acknowledgements

License: Distributed under the MIT License.
Third-Party Integrations: This repository does not distribute third-party integrations. The optional Home Assistant scripts reference repositories: xiaomi_home and midea_ac_lan.
Trademarks: "Xiaomi", "Mijia", and "Midea" are registered trademarks of their respective owners. Used here solely to indicate device compatibility.

Thanks to all contributors who have submitted PRs, reported issues, and helped refine the desktop smart home experience! If MenuBarMijia helps you keep your hands on the keyboard, please give it a ⭐ Star on GitHub.

jryang1997/MenuBarMijia: Native macOS (Swift 6 + SwiftUI) & Windows 11 (Tauri v2) menu-bar/tray controller for Xiaomi Mijia & Home Assistant with hold-to-talk voice control · 跨端米家与 HA 菜单栏智控中心