whatisgithub

What is miyoo-mqtt-reporter?

hudsonbrendon/miyoo-mqtt-reporter — explained in plain English

Analysis updated 2026-05-18

0ShellAudience · generalComplexity · 2/5Setup · moderate

In one sentence

A background plugin for the Miyoo Mini Plus handheld that reports battery, CPU, and gaming stats to Home Assistant over MQTT.

Mindmap

mindmap
  root((miyoo-mqtt-reporter))
    What it does
      Reads device state
      Publishes via MQTT
      Home Assistant integration
    Tech stack
      Shell
      MQTT
      OnionOS
    Use cases
      Battery monitoring
      Gaming session tracking
      Home automation
    Audience
      Home Assistant users
      Miyoo Mini owners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Monitor your Miyoo Mini Plus battery, CPU, and game session data in Home Assistant dashboards

USE CASE 2

Build automations that react to what game you are playing or how low your battery is

USE CASE 3

Track daily playtime and session duration for handheld gaming sessions

What is it built with?

ShellMQTTHome AssistantOnionOS

How does it compare?

hudsonbrendon/miyoo-mqtt-reporter123satyajeet123/bitnet-serveralexbloch-ia/legal-data
Stars000
LanguageShellShellShell
Setup difficultymoderateeasymoderate
Complexity2/52/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an MQTT broker and Home Assistant instance already running.

So what is it?

Miyoo MQTT Reporter is a small background plugin for the Miyoo Mini Plus, a handheld gaming device running OnionOS. It continuously reads the device's system state and publishes that data to Home Assistant, a popular home automation hub, via MQTT, a lightweight publish-subscribe messaging protocol common in smart home setups. Every 10 seconds by default, the plugin collects data across several categories: battery percentage, voltage, current draw, and charging status, CPU load, frequency, temperature, and RAM usage, audio volume and mute state, display brightness and color settings, Wi-Fi details including signal strength and IP address, SD card storage, and gaming-specific data like the currently running game, emulator, total playtime today, and session duration. It then sends this to your MQTT broker as a single JSON payload. On the Home Assistant side, the plugin uses MQTT Discovery, a feature that registers devices automatically without requiring manual configuration file edits. The first connection creates 73 sensor and status entities in Home Assistant, ready to use in dashboards or automations. Setup is done through an on-device web interface. After installing the plugin on the SD card and booting the device, opening the app shows a QR code linking to a browser-based config page on your local network. You enter your broker address, credentials, and publish interval, save, and the daemon starts immediately. A companion Home Assistant dashboard card is also available for displaying the Miyoo's data in a visual widget. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
Help me set up Miyoo MQTT Reporter to publish my Miyoo Mini Plus stats to Home Assistant
Prompt 2
Walk me through configuring the MQTT broker address and publish interval for miyoo-mqtt-reporter
Prompt 3
Show me how to build a Home Assistant dashboard card using the 73 sensor entities from miyoo-mqtt-reporter

Frequently asked questions

What is miyoo-mqtt-reporter?

A background plugin for the Miyoo Mini Plus handheld that reports battery, CPU, and gaming stats to Home Assistant over MQTT.

What language is miyoo-mqtt-reporter written in?

Mainly Shell. The stack also includes Shell, MQTT, Home Assistant.

How hard is miyoo-mqtt-reporter to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is miyoo-mqtt-reporter for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.