---
title: "Bluesound"
description: "Steuerung von Wiedergabe, Lautstärke, Presets und Multiroom-Gruppen auf Bluesound BluOS Playern über die lokale HTTP-API auf Port 11000."
url: "https://taphome.com/de/compatibility/bluesound/"
language: de
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["http","audio","bluos","multiroom","network-audio","packet-parser","mdns"]
  questions: ["Wie werden Bluesound Player in TapHome integriert?","Was steuert die Bluesound Vorlage für TapHome?","Wie findet man die IP-Adresse eines BluOS-Players?","Warum bleibt der Bluesound Gruppierungsschalter in TapHome ausgeschaltet?","Welcher Preset-Slot sollte mit der Bluesound Vorlage verwendet werden?","Funktioniert die Bluesound Vorlage für TapHome auch mit NAD- und DALI-Playern?"]
---

# Bluesound

Kommunikation: Packet Parser → HTTP

- [Offizielle Bluesound Website](https://www.bluesound.com/)
- [BluOS Plattform](https://bluos.io/)

> Netzwerkadresse
> 
> TapHome erreicht dieses Gerät unter der beim Import eingegebenen Adresse. Geben Sie dem Gerät eine feste Adresse — eine IP-Reservierung im Router oder seinen mDNS-Namen, falls es einen unterstützt —, sonst funktioniert die Integration nicht mehr, sobald der Router die Adresse ändert.
> 
> [Netzwerkvorbereitung](https://taphome.com/de/docs/setup/network-preparation/)

## Integrationsanleitung

Bluesound ist eine Multiroom-Audio-Serie auf Basis von **BluOS**, der Streaming-Plattform von Lenbrook für verlustfreies Audio bis 24 Bit/192 kHz. Jeder BluOS-Player stellt im lokalen Netzwerk die **BluOS Custom Integration API** bereit: einfache HTTP-GET-Anfragen auf **TCP-Port 11000**, Antworten als UTF-8-XML, ohne Authentifizierung und ohne Cloud-Konto. TapHome kommuniziert direkt über das LAN mit dem Player.

Die Vorlage ist nicht modellspezifisch — sie enthält keine Modell- oder Herstellerbindung und spricht ausschließlich die HTTP-API an, gilt also für die gesamte aktuelle Serie (NODE, NODE X, NODE NANO, NODE ICON, POWERNODE, POWERNODE EDGE, PULSE, PULSE M, PULSE MINI, PULSE FLEX, PULSE CINEMA, PULSE CINEMA MINI, PULSE SOUNDBAR, VAULT und HUB) sowie für frühere Generationen. Da BluOS auch von NAD Electronics, DALI, PSB Speakers, Monitor Audio, Roksan, Cyrus und Peachtree ausgeliefert wird, stellen Player dieser Marken dieselbe API bereit und reagieren auf dieselben Anfragen.

## Netzwerkverbindung

Es ist keine Verkabelung erforderlich. Ein BluOS-Player wird über den Einrichtungsassistenten der BluOS Controller App per Ethernet oder WLAN ins Heimnetz eingebunden, danach erreicht TapHome ihn über HTTP. Einzige Voraussetzung: Die TapHome-Steuereinheit und der Player müssen sich im selben LAN-Segment befinden, und Port 11000 muss zwischen beiden offen sein.

> [!NOTE]
> Port 11000 gilt für jeden BluOS-Player mit einer dokumentierten Ausnahme: Der NAD CI580 beherbergt vier Streamer-Knoten in einem Gehäuse auf den Ports 11000 / 11010 / 11020 / 11030. Die Vorlage spricht ausschließlich Port 11000 an und steuert auf einem CI580 daher Knoten 1.

## Konfiguration

### IP-Adresse des Players ermitteln

Die Adresse wird im Diagnostics-Bildschirm der BluOS Controller App angezeigt:

- **Android / iOS** — Reiter **Players** → Player auswählen → Reiter **Home** → **Settings** → unter **Help & Support** auf **Diagnostics** tippen.
- **Windows / macOS** — **Player Drawer** → Player auswählen → linker **Navigation Drawer** → **Help → Diagnostics**.

Derselbe Bildschirm listet unter **Other Players** auch die Adressen der übrigen Player im Netzwerk auf. Ohne die App liefert der Aufruf von `http://<player_ip>:11000/SyncStatus` im Browser das Attribut `id` des Players (Adresse und Port) zusammen mit seinem Attribut `mac`.

### Adresse dauerhaft festhalten

Die Vorlage spricht den Player über seine IP-Adresse an, eine geänderte DHCP-Lease legt die Integration also unbemerkt still. Lenbrook empfiehlt ausdrücklich eine **DHCP-Reservierung im Router** statt einer am Player konfigurierten statischen Adresse:

1. Öffnen Sie die Administrationsoberfläche des Routers und suchen Sie die Einstellungen für DHCP- bzw. LAN-Reservierungen.
2. Tragen Sie die MAC-Adresse des Players ein — die Antwort auf `/SyncStatus` enthält sie, sie lässt sich also ohne App über HTTP auslesen.
3. Weisen Sie die Adresse zu, die der Player behalten soll, und speichern Sie.
4. Starten Sie den Player neu, damit er seine Lease erneuert, und prüfen Sie, ob er die reservierte Adresse übernommen hat.

### Import der Vorlage

Die Vorlage hat einen einzigen Importparameter, **IpAddress** (Platzhalter `192.168.0.1`). Geben Sie die Adresse des Players ein; Port 11000 und das Anfrageformat sind bereits Bestandteil der Vorlage.

### Erforderliche Einrichtung nach dem Import — Mit Player gruppieren

Der Schalter **Mit Player gruppieren** wird mit der Variablen `IP` auf dem wörtlichen Platzhalter `192.168.x.x` ausgeliefert. Das ist kein funktionierender Standardwert — solange er nicht ersetzt wird, sucht das Leseskript `192.168.x.x` unter den Secondary-Playern, findet es nie, und der Schalter bleibt dauerhaft aus.

Öffnen Sie nach dem Import der Vorlage das Gerät **Mit Player gruppieren** in der TapHome App und setzen Sie `IP` auf die Adresse des Players, der als Gruppen-Secondary hinzugefügt werden soll. Verwenden Sie dazu den oben beschriebenen Diagnostics-Bildschirm (**Other Players** listet genau diese Adressen auf) oder lesen Sie `/SyncStatus` auf einem beliebigen Player im Netzwerk aus.

> [!WARNING]
> Alle übrigen Geräte der Vorlage funktionieren, sobald **IpAddress** ausgefüllt ist. **Mit Player gruppieren** ist das einzige Gerät, das nach dem Import einen zweiten Wert benötigt — bleibt `192.168.x.x` stehen, wirkt der Schalter defekt, statt einen Fehler zu melden.

## Gerätefunktionen

### Wiedergabesteuerung

Fünf Taster steuern die Wiedergabe:

- **Play** — startet die aktuelle Audioquelle. Ein pausierter Player wird fortgesetzt, ein gestoppter dagegen nicht erneut gestartet.
- **Pause** — sendet ein *Umschalten*, derselbe Taster pausiert also einen laufenden Player und setzt einen pausierten fort. Läuft ein Alarm mit Timeout, wird dieser Timeout durch das Pausieren zugleich abgebrochen.
- **Stop** — stoppt die Wiedergabe. Anders als bei Pause lässt sich ein gestoppter Player mit Play nicht fortsetzen. Auch das Stoppen bricht einen laufenden Alarm-Timeout ab.
- **Nächster Titel** — springt in der Wiedergabeliste vorwärts und am Listenende zurück zum ersten Titel, unabhängig von der Wiederholungseinstellung.
- **Vorheriger Titel** — startet den aktuellen Titel neu, wenn er länger als vier Sekunden läuft, andernfalls wird zum vorherigen Titel gesprungen.

Diese Taster wirken auf die **Wiedergabeliste**. Wenn der Player einen Radiosender streamt oder von einem physischen Eingang wiedergibt, ist die Liste nicht die Audioquelle, und Vor- bzw. Zurückspringen steht nicht zur Verfügung — die API behandelt diesen Fall über einen eigenen Endpunkt, den die Vorlage nicht nutzt.

### Lautstärke

**Lautstärke** ist ein Dimmer. Er liest den Pegel des Players (0–100) und skaliert ihn auf den Dimmerbereich 0,0–1,0; beim Schreiben wird der Wert als ganze Prozentzahl zurückgesendet. Das Ausschalten des Dimmers **sendet einen Stummschaltbefehl** statt Lautstärke 0, sodass der eigene Pegel des Players erhalten bleibt und beim Aufheben der Stummschaltung wiederhergestellt wird.

Beide Schreibvorgänge enthalten `tell_slaves=1`, was dem **Gruppen-Lautstärkeregler** in der BluOS Controller App entspricht: Ist der Player Gruppen-Primary, ändert sich die Lautstärke aller Player der Gruppe gemeinsam und nicht nur die des angesprochenen Players.

> [!NOTE]
> Der nutzbare Lautstärkebereich wird in der BluOS Controller App unter **Settings → Player → Audio** konfiguriert und liegt typischerweise bei −80…0 dB. Alle Pegel werden in diesen Bereich eingepasst, ein TapHome-Dimmer auf 100 % bedeutet also nicht zwangsläufig 0 dB. Player mit festem Line-Pegel melden überhaupt keine nutzbare Lautstärke; der Dimmer zeigt dann einen unsinnigen Pegel an, statt einen Fehler zu melden.

> [!WARNING]
> Der Lautstärke-Dimmer fragt den Player alle 2,5 Sekunden ab, während die BluOS-API von Integrationen ohne Long Polling **höchstens eine Anfrage alle 30 Sekunden** erwartet. Bei einem einzelnen Player sind das ein paar kleine Anfragen pro Minute, über ein ganzes Haus voller Player summiert sich das jedoch — behalten Sie das bei ausgelastetem WLAN im Blick und bevorzugen Sie in stark belasteten Netzen kabelgebundene Player.

### Zufallswiedergabe und Wiederholung

**Zufallswiedergabe** schaltet das Mischen der Wiedergabeliste ein und aus. Das Mischen baut die Liste neu auf; beim Ausschalten wird die ursprüngliche Reihenfolge wiederhergestellt.

**Wiederholung** ist ein dreistufiger Schalter — **Keine Wiederholung**, **Titel wiederholen** und **Alle wiederholen**. TapHome ordnet diese Stufen genau umgekehrt zur API an, und die Vorlage wendet dieselbe Umsetzung beim Lesen wie beim Schreiben an, sodass beide Richtungen konsistent bleiben.

Beide Geräte lesen ihren Zustand aus einem Wert, den das Modul bei seiner eigenen 30-Sekunden-Statusabfrage zwischenspeichert, statt eigene Anfragen zu senden. Das hält den Netzwerkverkehr gering, kostet aber bis zu 30 Sekunden, bis eine in der BluOS App vorgenommene Änderung in TapHome sichtbar wird.

### Presets

**Preset** ruft ein auf dem Player gespeichertes Preset ab — einen Radiosender, eine Playlist oder einen Eingang. Presets lassen sich ausschließlich in der BluOS Controller App anlegen und löschen; die API kann sie nur laden.

Das Gerät arbeitet nur schreibend: Es sendet den Preset-Befehl, liest aber nie zurück, welches Preset läuft — der Schalter spiegelt den tatsächlichen Zustand des Players also nicht wider.

> [!WARNING]
> Verwenden Sie die Preset-Slots **1–9**. Slot 0 sendet die Preset-ID 64 statt 0, was eher nach einem übrig gebliebenen Platzhalter als nach einem echten Preset aussieht. Preset-IDs müssen zudem nicht fortlaufend sein — ein Player kann die Presets 1, 2, 3, 5, 7 und 8 enthalten. Prüfen Sie deshalb in der BluOS Controller App, welche IDs tatsächlich vorhanden sind, bevor Sie einen Slot in eine Szene einbinden.

### Multiroom-Gruppierung

**Mit Player gruppieren** hängt einen zweiten BluOS-Player an diesen an. Der von TapHome angesprochene Player wird zum **Primary**: Er wählt die Musikquelle aus und verteilt sein Audiosignal, während der über die Variable `IP` benannte Player als **Secondary** beitritt. Das Ausschalten des Geräts entfernt diesen Player wieder aus der Gruppe. Der Zustand wird aus der Liste der angehängten Secondary-Player zurückgelesen, eine in der BluOS App vorgenommene Gruppierung wird in TapHome also abgebildet.

Aus der Funktionsweise der BluOS-Gruppierung ergeben sich zwei Konsequenzen:

- Nur externe Eingänge am **Primary** erreichen den Rest der Gruppe. Soll TV-Ton von einem optischen oder HDMI-Eingang überall wiedergegeben werden, muss TapHome den Player ansprechen, an dem dieser Eingang anliegt.
- Die BluOS Controller App verwaltet höchstens acht Gruppen mit je acht Playern oder vier Gruppen mit je sechzehn. Ein TapHome-Schalter bedient ein Primary-Secondary-Paar, eine Gruppe aus drei Playern benötigt also einen zweiten Schalter.

> [!NOTE]
> Die Gruppierungsanfragen senden den Singular-Parameter `slave=` zusammen mit dem Plural-Parameter `ports=`, eine Kombination, die die BluOS-API-Dokumentation nicht aufführt. Vermutlich funktioniert es trotzdem, weil 11000 ohnehin der dokumentierte Standardport ist — gut zu wissen ist es dennoch, falls sich ein Gruppenbefehl einmal unerwartet verhält.

### Beispieltaster — Demonstrationen, keine Player-Funktionen

Die Vorlage enthält zwei Taster mit den Namen **Beispiel – Jungle** und **Beispiel – Herunterfahren**. Sie sind **Demonstrationen des URL-Streamings**, keine Fähigkeiten des Players: Jeder von ihnen stoppt die Wiedergabe, leert die Wiedergabeliste und spielt eine einzelne Audiodatei von einer URL ab, die in der Gerätevariablen hinterlegt ist.

Sie sind zum Bearbeiten oder Löschen gedacht. Das Jungle-Beispiel verweist auf einen fremden Sample-Host außerhalb der Kontrolle von TapHome und funktioniert nicht mehr, sobald sich diese Seite ändert. Das Herunterfahren-Beispiel verweist auf eine bei TapHome gehostete MP3 und ist ein brauchbares Muster für einen Türklingel- oder Ansageton, wenn die Adresse durch eine eigene ersetzt wird — beachten Sie dabei, dass die Adresse prozentkodiert sein muss, da sie unverändert an den Player weitergereicht wird.

## Fehlerbehebung

### Der Player antwortet nicht

1. Rufen Sie `http://<player_ip>:11000/SyncStatus` im Browser auf — eine XML-Antwort bedeutet, dass der Player erreichbar und die API aktiv ist.
2. Antwortet er nicht, prüfen Sie die Adresse im Diagnostics-Bildschirm der BluOS Controller App; eine DHCP-Erneuerung kann sie verschoben haben. Richten Sie die oben beschriebene DHCP-Reservierung ein, damit das nicht mehr vorkommt.
3. Versuchen Sie es statt mit der IP-Adresse mit dem mDNS-Hostnamen des Players.
4. Stellen Sie sicher, dass sich TapHome-Steuereinheit und Player im selben Netz bzw. VLAN befinden und nichts Port 11000 zwischen beiden blockiert.

### Der Gruppierungsschalter lässt sich nie einschalten

Die Variable `IP` am Gerät **Mit Player gruppieren** enthält noch den Platzhalter `192.168.x.x` oder eine Adresse, hinter der kein BluOS-Player steht. Setzen Sie sie auf die tatsächliche Adresse des Secondary-Players — siehe Einrichtung nach dem Import weiter oben.

### Ein Preset bewirkt nichts

Entweder liegt auf diesem Player kein Preset hinter dem Slot, oder es wurde Slot 0 verwendet. Öffnen Sie die BluOS Controller App, prüfen Sie, welche Preset-IDs der Player tatsächlich enthält, und ordnen Sie die TapHome-Slots diesen IDs zu. Presets müssen zuerst in der App angelegt werden — die Vorlage kann sie nicht erzeugen.

### Nächster / Vorheriger Titel bewirken nichts

Der Player gibt nicht aus seiner Wiedergabeliste wieder. Radiostreams und physische Eingänge sind nicht listenbasiert, Vor- und Zurückspringen gelten für sie nicht. Starten Sie die Wiedergabe aus einer Playlist, einem Album oder der Liste, dann funktionieren die Taster wieder.

### Änderungen aus der BluOS App erscheinen verzögert

Zufallswiedergabe und Wiederholung werden aus dem zwischengespeicherten Status des Moduls gelesen, der alle 30 Sekunden aktualisiert wird. Die Lautstärke wird häufiger abgefragt. Die Wiedergabetaster und Preset arbeiten nur schreibend und bilden externe Änderungen überhaupt nicht ab.

### Der Player ist stumm, TapHome zeigt aber einen Pegel

Die Stummschaltung wird beim Ausschalten des Lautstärke-Dimmers geschrieben, der Stummschaltzustand aber nie zurückgelesen. Ein über die BluOS Controller App oder deren Fernbedienung stummgeschalteter Player zeigt in TapHome weiterhin seinen vorherigen Dimmerpegel. Schalten Sie den Dimmer aus und wieder ein, um beide wieder in Einklang zu bringen.

## Verfügbare Geräte 12

Diese Geräte erscheinen nach dem Import in TapHome.

Bluesound Modul

Benutzerdefinierte Variablen

Lesen (Modul)

```taphome
var response := SENDHTTPREQUEST("/Status");
shuffle := PARSEXML(response.Content, "//shuffle");
repeat := PARSEXML(response.Content, "//repeat");
```

Nächster Titel Taster Lesen und Schreiben

Springt zum nächsten Titel in der Wiedergabeliste; am Ende der Liste wird unabhängig von der Wiederholungseinstellung zum ersten Titel zurückgesprungen

button push

Tastenstatus schreiben

```taphome
SENDHTTPREQUEST("/Skip");
```

Lautstärke Dimmer Lesen und Schreiben

Lautstärke des Players — beim Ausschalten des Dimmers wird der Player stummgeschaltet statt auf null gesetzt, und die Änderung gilt für alle Player der Gruppe

numeric Einheit: % dimmer

Level lesen

```taphome
var response := SENDHTTPREQUEST("/Volume");
PARSEXML(response.Content, "//volume") / 100;
```

Level schreiben

```taphome
if St
	SENDHTTPREQUEST("/Volume?level=" + round(Le*100) + "&tell_slaves=1");
else
	SENDHTTPREQUEST("/Volume?mute=1&tell_slaves=1");
end
```

Zufallswiedergabe Schalter Lesen und Schreiben

Zufallswiedergabe-Status der Wiedergabeliste — der Status wird aus dem im Modul zwischengespeicherten /Status-Wert gelesen, der Schreibvorgang läuft über HTTP

boolean switch

Werte / Zustände: ${shuffle} · ${noShuffle}

Schaltzustand lesen

```taphome
shuffle
```

Schaltzustand schreiben

```taphome
var response := SENDHTTPREQUEST("/Shuffle?state=" + St);
shuffle := PARSEXML(response.Content, "//playlist/@shuffle");
```

Wiederholung Mehrwertschalter Lesen und Schreiben

Wiederholungsmodus — keine Wiederholung, einen Titel wiederholen oder die gesamte Wiedergabeliste wiederholen

enum multi-value

Werte / Zustände: Keine Wiederholung · Titel wiederholen · Alle wiederholen

Schaltzustand lesen

```taphome
switch(repeat,0,2,1,1,0)
```

Schaltzustand schreiben

```taphome
var tmp := switch(Mu,0,2,1,1,0);
var response := SENDHTTPREQUEST("/Repeat?state=" + switch(Mu,0,2,1,1,0));
repeat := PARSEXML(response.Content, "//playlist/@repeat");
```

Pause Taster Lesen und Schreiben

Wechselt zwischen Pause und Wiedergabe — ein erneuter Tastendruck setzt die Wiedergabe fort

button push

Tastenstatus schreiben

```taphome
SENDHTTPREQUEST("/Pause?toggle=1");
```

Vorheriger Titel Taster Lesen und Schreiben

Startet den aktuellen Titel neu, wenn er länger als vier Sekunden läuft, andernfalls wird zum vorherigen Titel der Wiedergabeliste zurückgesprungen

button push

Tastenstatus schreiben

```taphome
SENDHTTPREQUEST("/Back");
```

Play Taster Lesen und Schreiben

Startet die Wiedergabe der aktuellen Audioquelle — ein pausierter Player wird fortgesetzt, ein gestoppter nicht

button push

Tastenstatus schreiben

```taphome
SENDHTTPREQUEST("/Play");
```

Preset Mehrwertschalter Lesen und Schreiben

Lädt ein auf dem Player gespeichertes Preset — Radiosender, Playlists und Eingänge, die ausschließlich in der BluOS Controller App angelegt werden. Nur schreibend, daher zeigt der Schalter nicht an, welches Preset läuft

enum multi-value

Schaltzustand schreiben

```taphome
SENDHTTPREQUEST("/Preset?id=" + Mu);
```

Beispiel – Jungle Taster Lesen und Schreiben

Demonstration des URL-Streamings, keine Funktion des Players — stoppt die Wiedergabe, leert die Wiedergabeliste und spielt eine einzelne Audiodatei von der konfigurierten Adresse ab

button push

Variable: `encodedURL` — URL-kodierte Adresse des Audiostreams, den diese Taste abspielt. Der ausgelieferte Standardwert verweist auf einen fremden Beispiel-Host und sollte ersetzt werden

Tastenstatus schreiben

```taphome
SENDHTTPREQUEST("/Stop");
SENDHTTPREQUEST("/Clear");
SENDHTTPREQUEST("/Play?url=" + encodedURL);
```

Beispiel – Herunterfahren Taster Lesen und Schreiben

Zweite Demonstration des URL-Streamings — stoppt die Wiedergabe, leert die Wiedergabeliste und spielt eine einzelne Audiodatei von der konfigurierten Adresse ab

button push

Variable: `encodedURL` — URL-kodierte Adresse des Audiostreams, den diese Taste abspielt

Tastenstatus schreiben

```taphome
SENDHTTPREQUEST("/Stop");
SENDHTTPREQUEST("/Clear");
SENDHTTPREQUEST("/Play?url=" + encodedURL);
```

Mit Player gruppieren Schalter Lesen und Schreiben

Fügt einen zweiten BluOS-Player als Gruppen-Secondary hinzu — der von TapHome gesteuerte Player wird zum Gruppen-Primary und verteilt sein Audiosignal. Nach dem Import muss die IP-Adresse des anderen Players eingetragen werden

boolean switch

Werte / Zustände: ON · OFF

Variable: `IP` — IP-Adresse des BluOS-Players, der als Gruppen-Secondary hinzugefügt werden soll. Der ausgelieferte Wert 192.168.x.x ist ein Platzhalter und muss ersetzt werden, sonst bleibt der Schalter dauerhaft aus

Schaltzustand lesen

```taphome
var response := SENDHTTPREQUEST("/SyncStatus");
var slaves := PARSEXML(response.Content, "//SyncStatus/slave/@id");
indexof(slaves, IP) >= 0
```

Schaltzustand schreiben

```taphome
if St
	SENDHTTPREQUEST("/AddSlave?slave=" + IP + "&ports=11000");
else
	SENDHTTPREQUEST("/RemoveSlave?slave=" + IP + "&ports=11000");
end
```

Stop Taster Lesen und Schreiben

Stoppt die Wiedergabe — anders als bei Pause lässt sich ein gestoppter Player mit Play nicht fortsetzen

button push

Tastenstatus schreiben

```taphome
SENDHTTPREQUEST("/Stop");
```

**Verbindung:** Packet Parser → HTTP • Hostname: `{MODEL}-{MAC4}.local`

Mögliche Verbesserungen (17)

- Long Polling — Holds the connection open and returns only when something changes. Would cut request volume substantially and is the mechanism the documented 30 s polling ceiling exists to make unnecessary. The template uses plain repeated GETs on 2.5 s / 10 s / 30 s intervals.
- Now Playing Metadata — Playback state, three-line track description, album art URL, track length and elapsed seconds. The module already fetches /Status every 30 s but only extracts shuffle and repeat from it, so this would cost no extra requests.
- Mute State (read) — The volume dimmer writes /Volume?mute=1 when switched off but never reads mute back, so a player muted from the BluOS app still shows its old dimmer level in TapHome.
- Doorbell Chime — Plays the player's configured chime at its configured chime volume without touching the play queue. The most obviously useful addition for a smart home — the Sample buttons approximate it far more crudely by clearing the queue.
- Direct Input Selection — Switches the player to a physical input by type and index — spdif, analog, coax, bluetooth, arc, earc, phono, computer, aesebu, balanced, microphone. Requires BluOS firmware 4.2.0 or newer; older firmware uses /Play?inputIndex=. Natural fit for a multi-value switch.
- Input Discovery — Lists the inputs actually present on the player, including inputs shared by a BluOS HUB elsewhere on the network. HUB input selection is only supported through this route plus /Play?url=.
- List Presets — Returns the real preset ids, names and artwork. Would let the Preset device show what it is actually switching between instead of a fixed 0–9 list.
- Next / Previous Preset — Steps through presets without knowing their ids — two push buttons would cover it and would not depend on the ids matching.
- Relative Volume Step — Volume up / down by a dB step (typical value 2 dB). Cheaper than the dimmer for wall-button control and does not need the current level to be read first.
- Absolute dB Volume — Sets volume on the dB scale instead of the 0–100 percentage, which is what the player's configured volume range is actually expressed in.
- Play Queue Management — List the queue, delete or move a track, save the queue as a named playlist. The template only uses /Clear, and only inside the two demo buttons.
- Content Browsing and Search — Navigate and search music services, local library, playlists and inputs. A large surface that does not map naturally onto TapHome device models, but it is the reason the template has no way to choose what plays beyond presets.
- Radio Station Actions — Skip, back, love and ban on streaming radio stations that do not use the play queue. This is what Next Track and Previous Track would need to fall back to when /Status carries a &lt;streamUrl&gt;.
- Player Identity and Group Name — MAC address (the value a router DHCP reservation needs), player name, model, brand and the current group name. The grouping switch already fetches /SyncStatus every 30 s, so these would be free service attributes.
- Battery Level — Present only on players with a battery pack, such as PULSE FLEX with the BP100 — state of charge in percent plus a charging flag.
- Bluetooth Mode — Manual, Automatic, Guest or Disabled. Useful for locking guest access to a player from a scene.
- Soft Reboot — The only POST endpoint in the API — the PacketParser HTTP module issues GETs, so this would need a different mechanism.

## Importparameter

Diese Werte geben Sie beim Import des XML ein.

| In der App abgefragt | Standard      |
|----------------------|---------------|
| IP-Adresse           | `192.168.0.1` |

## Quellen

- BluOS Custom Integration API v1.7
  
  [bluos.io](https://bluos.io/wp-content/uploads/2025/06/BluOS-Custom-Integration-API_v1.7.pdf) 2026-08-25
  
  [PDF](https://taphome.com/compatibility/devices/bluesound/manufacturer/bluos-custom-integration-api-v1.7.pdf)
- Bluesound product lineup and BluOS coverage
  
  [www.bluesound.com](https://www.bluesound.com/all-products) 2026-08-25
- BluOS Support — How can I configure a fixed or static IP address for my BluOS Player?
  
  [support.bluos.net](https://support.bluos.net/hc/en-us/articles/360000443067-How-can-I-configure-a-fixed-or-static-IP-address-for-my-BluOS-Player) 2026-08-25
- BluOS Support — How do I find the IP Address of my Player?
  
  [support.bluos.net](https://support.bluos.net/hc/en-us/articles/360000463947-How-do-I-find-the-IP-Address-of-my-Player) 2026-08-25
- BluOS Support — Grouping Players in BluOS
  
  [support.bluos.net](https://support.bluos.net/hc/en-us/articles/360044050794-Grouping-Players-in-BluOS) 2026-08-25

Herstellerdokumente sind © ihrer jeweiligen Eigentümer. Sie werden so bereitgestellt, wie der Hersteller sie veröffentlicht hat, nur zur Information.

## Verwandte Dokumentation

- [Packet-Parser-Integration](https://taphome.com/de/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/de/docs/integration/packet-parser/)
- [Packet-Parser-Funktionen](https://taphome.com/de/docs/script/packet-parser/)
- [Parsing-Funktionen](https://taphome.com/de/docs/script/parsing-functions/)