Skip to content

sindrebroch/ha-magicmirror

Repository files navigation

MagicMirror for HomeAssistant

GitHub release (latest by date) hacs_badge

"Buy Me A Coffee"

Requires MMM-Remote-Control installed on your MagicMirror host, with an API-key configured.

Installation

HACS (Recommended)
  1. Ensure that HACS is installed.
  2. Add this repository as a custom repository
  3. Search for and install the "MagicMirror"-integration.
  4. Restart Home Assistant.
  5. Configure the MagicMirror integration.
Manual
  1. Download the Source code (zip) file from the latest release.
  2. Unpack the release and copy the custom_components/ha-magicmirror directory into the custom_components directory of your Home Assistant installation.
  3. Restart Home Assistant.
  4. Configure the MagicMirror-integration.

Features

Light

  • Toggle monitor on/off
  • Change brightness

Switch

  • Show / hide modules (See Note)

Button

  • Shutdown host
  • Reboot host
  • Restart magicmirror
  • Refresh browser

Update

  • MagicMirror update
  • Module update (supports installing new version)

Notify

service: notify.magicmirror
data:
  title: Title      # optional
  message: Message  # required
  data:
    timer: 5000     # default, optional
    dropdown: False # default, optional

Note

Module controls are using an ID from the API which is generated from MagicMirror config.js. This means that if you change the order of your config.js, the modules might become out of sync. This should be fixed by reloading the integration, to have new devices generated. The old ones needs to be deleted.

Debugging

If something is not working properly, logs might help with debugging. To turn on debug-logging add this to your configuration.yaml

logger:
  default: info
  logs:
    custom_components.magicmirror: debug

Have started work on diagnostics. This will be expanded on in the future as it is more clear what is needed to include to resolve issues. To download diagnostics, go into your device and press DOWNLOAD DIAGNOSTICS. This downloads a txt-file you can post in you issue. All sensitive data should be redacted here, so no need to worry, but you can inspect it if you want.