MuPiBox Dokumentation MuPiBox NG

Home-Assistant-Dashboard

Fertiges YAML für eine schöne MuPiBox-Seite in Home Assistant – Player, Akku, Displaybild, Durchsagen und Wartung – plus Beispiele für Automationen.

Mit der Home-Assistant-Integration bekommst du Player, Akku, WLAN und Wartung der MuPiBox in Home Assistant. Diese Seite liefert dir eine fertige Dashboard-Karte zum Einfügen und zwei Automationen als Vorlage. Es werden nur Karten verwendet, die in Home Assistant schon enthalten sind – kein zusätzliches HACS-Frontend nötig.

Vorher: die Entitätsnamen prüfen

Die Integration benennt die Entitäten nach dem Gerät. In den Beispielen heißt die Box MuPiBox, daher beginnen alle IDs mit mupibox_ (z. B. media_player.mupibox_player). Heißt deine Box anders, etwa „Kinderzimmer“, lautet die ID media_player.kinderzimmer_player.

So prüfst du die IDs: Einstellungen → Geräte & Dienste → MuPiBox → Gerät öffnen und die Entitäten anklicken. Bei einigen Entitäten (Knöpfe, Audioausgabe, Sprachnachricht) hängt der Name von der Sprache ab, in der Home Assistant beim Einrichten lief – diese IDs am besten dort nachsehen.

Entität (englischer Name)Beispiel-ID
Playermedia_player.mupibox_player
Batterysensor.mupibox_battery
Charging / External powerbinary_sensor.mupibox_charging, binary_sensor.mupibox_external_power
Wi-Fi signalsensor.mupibox_wi_fi_signal
CPU temperature / CPU usage / Storage usagesensor.mupibox_cpu_temperature, sensor.mupibox_cpu_usage, sensor.mupibox_storage_usage
Version / Active providersensor.mupibox_version, sensor.mupibox_active_provider
Display (Bild des Touchscreens)camera.mupibox_display
Audio outputselect.mupibox_audio_output
Restart box / Power off boxbutton.mupibox_restart_box, button.mupibox_power_off_box
Speak announcementnotify.mupibox_speak_announcement

Akku- und Ladewerte gibt es nur mit MuPiHAT. Die Sprachnachricht und die Knöpfe zum Neustarten und Ausschalten legt die Integration nur an, wenn du beim Koppeln TTS und Displaynachrichten bzw. Neustart und Ausschalten erlaubt hast.

Die Dashboard-Karte

  1. Im Dashboard oben rechts auf den Stift (Dashboard bearbeiten) tippen.
  2. Karte hinzufügen → ganz unten Manuell wählen.
  3. Den Inhalt löschen, das YAML unten einfügen, Entitäts-IDs bei Bedarf anpassen, Speichern.
type: vertical-stack
cards:
  - type: media-control
    entity: media_player.mupibox_player
  - type: grid
    columns: 3
    square: false
    cards:
      - type: gauge
        entity: sensor.mupibox_battery
        name: Akku
        min: 0
        max: 100
        severity:
          green: 50
          yellow: 20
          red: 0
      - type: tile
        entity: binary_sensor.mupibox_charging
        name: Lädt
      - type: tile
        entity: sensor.mupibox_wi_fi_signal
        name: WLAN
  - type: picture-entity
    entity: camera.mupibox_display
    name: Display der Box
    camera_view: auto
    show_state: false
  - type: entities
    title: Durchsage und Ausgabe
    entities:
      - entity: select.mupibox_audio_output
        name: Audioausgabe
      - type: button
        name: Gute-Nacht-Durchsage
        icon: mdi:weather-night
        action_name: Senden
        tap_action:
          action: perform-action
          perform_action: notify.send_message
          target:
            entity_id: notify.mupibox_speak_announcement
          data:
            message: Gute Nacht! Gleich wird die Musik leiser.
  - type: entities
    title: Wartung
    state_color: true
    entities:
      - entity: sensor.mupibox_version
        name: Version
      - entity: sensor.mupibox_cpu_temperature
        name: CPU-Temperatur
      - entity: sensor.mupibox_storage_usage
        name: Speicher belegt
      - entity: button.mupibox_restart_box
        name: Box neu starten
      - entity: button.mupibox_power_off_box
        name: Box ausschalten

Automation: Gute-Nacht-Durchsage

Jeden Abend um 19:30 Uhr eine Durchsage, danach wird die Lautstärke leiser gestellt. volume_level bezieht sich auf die Maximallautstärke der Box: 0.2 sind 20 % davon. Unter Einstellungen → Automationen & Szenen → Automation erstellen → ⋮ → In YAML bearbeiten einfügen:

alias: MuPiBox – Gute Nacht
triggers:
  - trigger: time
    at: "19:30:00"
actions:
  - action: notify.send_message
    target:
      entity_id: notify.mupibox_speak_announcement
    data:
      message: Gute Nacht! In zehn Minuten ist Schlafenszeit.
  - delay: "00:00:10"
  - action: media_player.volume_set
    target:
      entity_id: media_player.mupibox_player
    data:
      volume_level: 0.2
mode: single

Automation: Hinweis bei schwachem Akku

Schickt eine Nachricht aufs Handy, wenn der Akku unter 15 % fällt und die Box nicht lädt. notify.mobile_app_dein_handy durch deinen eigenen Benachrichtigungsdienst ersetzen.

alias: MuPiBox – Akku schwach
triggers:
  - trigger: numeric_state
    entity_id: sensor.mupibox_battery
    below: 15
conditions:
  - condition: state
    entity_id: binary_sensor.mupibox_charging
    state: "off"
actions:
  - action: notify.mobile_app_dein_handy
    data:
      message: Die MuPiBox hat nur noch {{ states('sensor.mupibox_battery') }} % Akku.
mode: single
© 2026 MuPiBox