Repolode
Submit
huanyuejue

huanyuejue/MiHome-Windows

A Windows desktop client for controlling Xiaomi Mijia smart home devices, built on the mijiaAPI library with a GUI, tray, and desktop widget.

Open-source alternative to:Mi Home

View on GitHub
Stars
157
Forks
13
Open issues
4
Last commit
10 hours ago

What is it?

MiHome-Windows is a desktop application for viewing and controlling Xiaomi Mijia smart home devices on Windows. You log in by scanning a QR code in the Mijia app, after which devices are grouped by home and room and shown with their online status. Controls are generated from each device's spec metadata: boolean properties become switches, numeric properties become sliders using the device's range and step, and enumerations become dropdowns. Actions are rendered as buttons with a confirmation step.

Beyond the main window, the app offers a system tray with quick device and scene control, Xiaomi speaker shortcuts and voice commands, plus a desktop widget panel that can be pinned, made translucent and collapsed to a thin bar. Users can also run Mijia scenes and set daily on/off schedules for individual devices. Schedules only fire while the app is running, including when minimized to the tray.

The project is built with PySide6 and packaged to a standalone exe with Nuitka, and it is licensed under GPL-3.0. The author notes that the project is in an early stage and was tested only on a limited set of devices, so support for other device types depends on community contributions.

Key features

  • 01Scan-to-login with Mijia credentials reused across launches.
  • 02Device list grouped by home and room with live online status.
  • 03Auto-generated controls for switches, sliders and dropdowns from device specs.
  • 04System tray with quick controls, scene execution and Xiaomi speaker voice commands.
  • 05Desktop widget with adjustable opacity, pinning and a collapsible bar.
  • 06Per-device daily on/off schedules that run while the app is open.

Use cases

  • Controlling Mijia lights, plugs and other devices from a Windows PC without using the phone app.
  • Keeping frequently used devices and scenes on a desktop widget or tray menu.
  • Setting simple daily on/off times for lamps or appliances on a computer that stays running.
  • Sending text commands to a Xiaomi speaker from the desktop.

In collections

Desktop GUI apps & toolkits

Topics

#smart-home#xiaomi#mijia#iot#windows#pyside6#desktop-app#python

FAQ

What is MiHome-Windows?
A Windows desktop client for controlling Xiaomi Mijia smart home devices, built on the mijiaAPI library with a GUI, tray, and desktop widget. MiHome-Windows is a desktop application for viewing and controlling Xiaomi Mijia smart home devices on Windows. You log in by scanning a QR code in the Mijia app, after which devices are grouped by home and room and shown with their online status. Controls are generated from each device's spec metadata: boolean properties become switches, numeric properties become sliders using the device's range and step, and enumerations become dropdowns. Actions are rendered as buttons with a confirmation step.
Is MiHome-Windows free to use? What license does it have?
MiHome-Windows is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is MiHome-Windows still maintained?
Actively maintained. The last commit to MiHome-Windows was on Oct 22, 2026.
What can I use MiHome-Windows for?
Controlling Mijia lights, plugs and other devices from a Windows PC without using the phone app. Keeping frequently used devices and scenes on a desktop widget or tray menu. Setting simple daily on/off times for lamps or appliances on a computer that stays running. Sending text commands to a Xiaomi speaker from the desktop.
Where can I get MiHome-Windows?
The source code and installation instructions are on GitHub: https://github.com/huanyuejue/MiHome-Windows

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects