Zum Hauptinhalt springen

Sennheiser AMBEO Soundbar Smart-Home-Integration, kostenlos und Open Source

Sennheiser AMBEO Soundbar-Integration für Gladys Assistant

Steuert und überwacht Sennheiser AMBEO Soundbars Max, Plus und Mini im lokalen Netzwerk.

Auf GitHub ansehenAlle Integrationen
Info

Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.

Controls an AMBEO Soundbar Max, Plus or Mini over your local network (no cloud). The Plus is the reference model; Mini and Max are supported the same way.

Setup​

  1. Find the soundbar's IP address (Smart Control app or your router).
  2. Enter it in the integration's Configuration screen.
  3. Press Test the connection: it reads the soundbar now and says what it answered (model, firmware, number of inputs, volume). If it reports an error, the address is wrong or the soundbar is not reachable on its port 80.
  4. Run a device scan: one device with all settings your model supports is created.

Device features​

Power, volume, mute, input, sound profile, night mode, AMBEO mode, voice enhancement, sound feedback, subwoofer, LED/logo/display brightness, Bluetooth pairing, eco mode, audio codec and now playing (read-only). Plus and Mini also expose the center volume; the Max exposes the AMBEO level and the center/side/up-firing levels instead.

Power follows the model: the Max can be woken from standby and put back, the button of the widget is hidden on the other models.

A model that does not answer a whole group of settings (some firmware versions do not) still appears: what it does not answer is logged and skipped.

Widget "Soundbar remote"​

Power on/off, volume down/up (step configurable), mute, and one button per selectable input.

Scenes​

Action "Play a sound on the soundbar" plays an MP3 or WAV:

  • File of the "sounds" folder: the integration serves the file itself and the soundbar fetches it. The folder lives in the integration's own data volume, and the default sound is named in the configuration (leave the scene field empty to use it). A three second sample tone (tone.wav) ships with the integration and is installed on first start.
  • http(s) URL: a direct link to the file, reachable by the soundbar.

The optional volume field sets the volume before playing.

Action "Read the soundbar state" returns volume, mute, input, sound profile and codec, readable by the following steps as {{outputs.<key>}}.

Action "Set the soundbar volume" sets an absolute volume.

Trigger "Volume crossed a limit" fires when the volume goes above the "too loud" limit or below the "too quiet" limit set in the configuration. The trigger carries the direction, the limit and the new volume. It fires once per crossing: for a plain "volume above X" condition, use Gladys' own "device state changed" trigger on the volume feature.

Notes​

The soundbar API is not officially documented; the paths follow the open-source pyambeo library. Playback of a file is not verified against a device yet.

This is an independent, unofficial project. It is not affiliated with, authorised, endorsed or sponsored by Sennheiser electronic SE & Co. KG or any of its subsidiaries, and it is not an official Sennheiser product or service.

Sennheiser and AMBEO are trademarks or registered trademarks of Sennheiser electronic SE & Co. KG, used here only to describe the hardware this integration works with. All other trademarks, product names and company names are the property of their respective owners.

Konfigurationseinstellungen​

Diese Einstellungen fragt Sennheiser AMBEO Soundbar in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
IP-Adresse der SoundbarstringJaIP-Adresse oder Hostname der Soundbar (in der Smart-Control-App oder in Ihrem Router zu finden).
Abfrageintervall (s)numberNeinWie oft der Zustand gelesen wird, in Sekunden (mindestens eine Minute).
Lautstärkeschritt im WidgetnumberNeinLautstärkeeinheiten, die die Tasten „Lauter“ und „Leiser“ ändern.
Töne der SzenensectionNeinDie Tondateien werden von der Integration selbst bereitgestellt: Öffnen Sie den Töne-Port der Integration, legen Sie dort Ihre MP3- oder WAV-Dateien ab und laden Sie diesen Bildschirm neu. Beim ersten Start wird ein Beispielton von drei Sekunden installiert.
Standard-TondateistringNeinDateiname, der abgespielt wird, wenn eine Szene keinen nennt. Beispiel: tone.wav, oder tone.mp3 sobald Sie ihn ablegen.
Zu laut oberhalbnumberNeinLöst „Lautstärke überschreitet eine Grenze“ aus, wenn die Lautstärke darüber steigt. 0 schaltet ab.
Zu leise unterhalbnumberNeinLöst „Lautstärke überschreitet eine Grenze“ aus, wenn die Lautstärke darunter fällt. 0 schaltet ab.

So installierst du Sennheiser AMBEO Soundbar in Gladys​

  1. Öffne in Gladys Integrationen: Sennheiser AMBEO Soundbar erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/tomgermany/gladys-sennheiser-ambeo:1.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/tomgermany/gladys-sennheiser-ambeo.

Sennheiser AMBEO Soundbar benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

Sennheiser AMBEO Soundbar ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von tomgermany veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am