diff --git a/FHEM/98_BOSEST.pm b/FHEM/98_BOSEST.pm
index e49381c0b..0254f6e04 100755
--- a/FHEM/98_BOSEST.pm
+++ b/FHEM/98_BOSEST.pm
@@ -2517,109 +2517,255 @@ sub BOSEST_readingsSingleUpdateIfChanged {
=pod
=item device
-=item summary Easily autodiscover and control your BOSE SoundTouch devices
-=item summary_DE Autodiscover und einfache Steuerung deiner BOSE SoundTouch Geräte
+=item summary Control your BOSE SoundTouch devices
+=item summary_DE Steuerung deiner BOSE SoundTouch Lautsprecher
=begin html
BOSEST
-
- BOSEST is used to control a BOSE SoundTouch system (one or more SoundTouch 10, 20 or 30 devices)
- Note: The followig libraries are required for this module:
- - libwww-perl
- libmojolicious-perl
- libxml-simple-perl
- libnet-bonjour-perl
- libev-perl
- liburi-escape-xs-perl
- sox
- libsox-fmt-mp3
- Use sudo apt-get install libwww-perl libmojolicious-perl libxml-simple-perl libnet-bonjour-perl libev-perl to install this libraries.
Please note:
- libmojolicious-perl must be >=5.54, but under wheezy is only 2.x avaible.
- Use sudo apt-get install cpanminus and sudo cpanm Mojolicious to update to the newest version
- TTS can be configured as described in the following thread: Link
-
- Questions and/or feedback can be posted on the FHEM forum: Link
-
-
-
- Define
-
- define <name> BOSEST
-
- Example:
-
- define bosesystem BOSEST
- Defines BOSE SoundTouch system. All devices/speakers will show up after 60s under "Unsorted" in FHEM.
-
-
-
-
-
- Set
+BOSEST is used to control a BOSE SoundTouch system (one or more SoundTouch 10, 20 30, 300 or Portable devices)
+ Note: The following libraries are required for this module:
+
+ - libwww-perl
- libmojolicious-perl
- libxml-simple-perl
- libnet-bonjour-perl
- libev-perl
- liburi-escape-xs-perl
+ - sox
+ - libsox-fmt-mp3
+ Use sudo apt-get install libwww-perl libmojolicious-perl libxml-simple-perl libnet-bonjour-perl libev-perl liburi-escape-xs-perl to install this libraries.
+ Please note: libmojolicious-perl must be >=5.54
+ Use sudo apt-get install cpanminus and sudo cpanm Mojolicious to update to the newest version.
+ TextToSpeach (TTS) can be configured as described in the following thread: Link
+ Questions and/or feedback can be posted on the FHEM forum: Link
+
+
+
+ Define
- set <name> <command> [<parameter>]
- The following commands are defined for the devices/speakers (execpt autoAddDLNAServers is for the "main" BOSEST) :
- General commands
- on - power on the deviceoff - turn the device offpower - toggle on/offvolume [0...100] [+x|-x] - set the volume level in percentage or change volume by ±x from current levelchannel 0...20 - select present to playsaveChannel 07...20 - save current channel to channel 07 to 20play - start/resume to play pause - pause the playbackstop - stop playbacknextTrack - play next trackprevTrack - play previous trackmute on|off|toggle - control volume muteshuffle on|off - control shuffle moderepeat all|one|off - control repeat modebass 0...10 - set the bass levelrecent 0...15 - set number of names in the recent list in readingssource bluetooth,bt-discover,aux mode, airplay - select a local source
- addDLNAServer Name1 [Name2] [Namex] - add DLNA servers Name1 (and Name2 to Namex) to the BOSE libraryremoveDLNAServer Name1 [Name2] [Namex] - remove DLNA servers Name1 (and Name2 to Namex) to the BOSE library
Example: set BOSE_1234567890AB volume 25 Set volume on device with the name BOSE_1234567890AB
-
- Timer commands:
- on-for-timer 1...x - power on the device for x secondsoff-for-timer 1...x - turn the device off and power on again after x secondson-till hh:mm:ss - power on the device until defined timeoff-till hh:mm:ss - turn the device off and power on again at defined timeon-till-overneight hh:mm:ss - power on the device until defined time on the next dayoff-till-overneight hh:mm:ss - turn the device off at defined time on the next day
Example: set BOSE_1234567890AB on-till 23:00:00 Switches device with the name BOSE_1234567890AB now on and at 23:00:00 off
-
- Multiroom commands:
- createZone deviceID - create multiroom zone (defines <name> as zoneMaster) addToZone deviceID - add device <name> to multiroom zoneremoveFromZone deviceID - remove device <name> from multiroom zoneplayEverywhere - play sound of device <name> on all others devicesstopPlayEverywhere - stop playing sound on all devices
Example: set BOSE_1234567890AB playEverywhere Starts Multiroom with device with the name BOSE_1234567890AB as master
-
- TextToSpeach commands (needs Google Translate):
- speak "message" [0...100] [+x|-x] [en|de|xx] - Text to speak, optional with volume adjustment and language to use. The message to speak may have up to 100 lettersspeakOff "message" [0...100] [+x|-x] [en|de|xx] - Text to speak, optional with volume adjustment and language to use. The message to speak may have up to 100 letters. Device is switched off after speakttsVolume [0...100] [+x|-x] - set the TTS volume level in percentage or change volume by ±x from current levelttsDirectory "directory" - set DLNA TTS directory. FHEM user needs permissions to write to that directory. ttsLanguage en|de|xx - set default TTS language (default: en)ttsSpeakOnError 0|1 - 0=disable to speak "not available" textautoAddDLNAServers 0|1 - 1=automatically add all DLNA servers to BOSE library. This command is only for "main" BOSEST, not for devices/speakers!
-
Example: set BOSE_1234567890AB speakOff "Music is going to switch off now. Good night." 30 en Speaks message at volume 30 and then switches off device.
+ define <name> BOSEST
+ Example:
+
+ define bosesystem BOSEST
+ Defines BOSE SoundTouch system. All devices/speakers will show up after 60s under "Unsorted" in FHEM.
+
+
+
+
+Set
+ set <name> <command> [<parameter>]
+ The following commands are defined for the devices/speakers (except autoAddDLNAServers is for the "main" BOSEST) :
+ General commands
+ on - power on the deviceoff - turn the device offpower - toggle on/offvolume [0...100] [+x|-x] - set the volume level in percentage or change volume by ±x from current levelchannel 0...20 - select present to playsaveChannel 07...20 - save current channel to channel 07 to 20play - start to play pause - pause the playbackplaypause - toggle play/pausestop - stop playbacknextTrack - play next trackprevTrack - play previous trackplayTrack name|location|source[|sourceAccount] - searches per DNLA for the track title and plays it
+ additional information:
+
+ - You can search for trackTitle, trackAlbum, trackArtist (german FHEM forum post)
+ - You can test it in the SoundTouch APP: Use the search in the APP to see if a playlist is found and played. It yes it will work with playTrack too. (german FHEM forum post)
+
+ mute on|off|toggle - control volume muteshuffle on|off - control shuffle moderepeat all|one|off - control repeat modebass 0...10 - set the bass levelrecent 0...15 - set number of names in the recent list in readingssource bluetooth,bt-discover,aux mode, airplay - select a local source
+ addDLNAServer Name1 [Name2] [Namex] - add DLNA servers Name1 (and Name2 to Namex) to the BOSE libraryremoveDLNAServer Name1 [Name2] [Namex] - remove DLNA servers Name1 (and Name2 to Namex) to the BOSE library
-
-
- Get
-
-
+ Example: set BOSE_1234567890AB volume 25 Set volume on device with the name BOSE_1234567890AB
+
+ Timer commands:
+ on-for-timer 1...x - power on the device for x secondsoff-for-timer 1...x - turn the device off and power on again after x secondson-till hh:mm:ss - power on the device until defined timeoff-till hh:mm:ss - turn the device off and power on again at defined timeon-till-overneight hh:mm:ss - power on the device until defined time on the next dayoff-till-overneight hh:mm:ss - turn the device off at defined time on the next day
+ Example: set BOSE_1234567890AB on-till 23:00:00 Switches device with the name BOSE_1234567890AB now on and at 23:00:00 off
+
+ Multiroom commands:
+ createZone deviceID[,deviceID] - create multiroom zone and adds device(s) to the multiroom zone addToZone deviceID - add device to multiroom zone removeFromZone deviceID - remove device from multiroom zoneplayEverywhere - play sound of a device on all others devicesstopPlayEverywhere - stop playing sound on all devices
+ Example1: set BOSE_1234567890AB playEverywhere Starts playing the sound of the device BOSE_1234567890AB on allother devices
+ Example2: set BOSE_1234567890AB createZone AB1234567890,12AB34567890 Defines BOSE_1234567890AB as multiroom master
+ and adds BOSE_AB1234567890 and BOSE_12AB34567890 to the multiroom zone
+
+ Note: A "double-tap" (<1s) on a preset button (device or remote control) will toggle playEverywhere/stopPlayEverywhere
+
+ Show clock command (only for ST20/30):
+ clock enable/disable - show or hide clock
+ Example: set BOSE_1234567890AB clock enable Show time in the ST20/30 display.
+
+ TextToSpeach commands (needs Google Translate):
+ speak "message" [0...100] [+x|-x] [en|de|xx] - Text to speak, optional with volume adjustment and language to use.speakOff "message" [0...100] [+x|-x] [en|de|xx] - Text to speak, optional with volume adjustment and language to use. Device is switched off after speak.
+ Example: set BOSE_1234567890AB speakOff "Music is going to switch off now. Good night." 30 en Speaks message at volume 30 and then switches off device.
-
- Attributes
-
- staticIPs IPs - IP addresses (comma separated) of your BOSE devices, should be used only if discovery doesn't work in your network
-
+ DNLA Server command:
+ autoAddDLNAServers 0|1 - 1=automatically add all DLNA servers to BOSE library. This command is only for "main" BOSEST, not for devices/speakers!
+
+
+ Get
+
+
+
+ Attributes
+
+
+ staticIPs IP-Address [,IP-Address] - Manually define the used IP address(es) (comma separated) of your BOSE devices. Should be used only, if BOSEST device detection doesn't work in your network (e.g. several subnets on server, subnet not directly connected, ...)
Example: attr bosesystem staticIPs 192.168.1.52,192.168.1.53speakChannel channel(s) - speaks channel/present name bevor starting a playback, useful for SoundTouch without display (comma separated or range: e.g. 2,3,5,6 or 1-6 ). TTS must be installed.auto-zone on|off - automatic start multiroom zone play, if speakers are playing the same, according to "contentItemLocation"; (default: off)ttsDirectory "directory" - set DLNA TTS directory. FHEM user needs permissions to write to that directory. ttsLanguage en|de|xx - set default TTS language (default: en)ttsSpeakOnError 0|1 - 0=disable to speak "not available" textttsVolume [0...100] [+x|-x] - set the TTS volume level in percentage or change volume by ±x from current levelChannel_07 to Channel_20 name|location|source|[sourceAccount] - define present 07 to 20
When you play something, you can find ContentItemLocationName, ContentItemLocation, etc. in the readings. These data can be used here to define the present.
+
+
+=end html
+
+=begin html_DE
+
+
+BOSEST
+
+BOSEST ist ein Modul um ein BOSE SoundTouch System zu steuern, (ein oder mehrere SoundTouch 10, 20 30, 300 oder Portable Geräte)
+
+Hinweis: Für das BOEST Modul sind folgende Bibliotheken erforderlich:
+
+ - libwww-perl
- libmojolicious-perl
- libxml-simple-perl
- libnet-bonjour-perl
- libev-perl
- liburi-escape-xs-perl
- sox
- libsox-fmt-mp3
+ Rufe sudo apt-get install libwww-perl libmojolicious-perl libxml-simple-perl libnet-bonjour-perl libev-perl liburi-escape-xs-perl auf, um diese Bibliotheken zu installieren.
+ Hinweis:libmojolicious-perl muss mindestens die Version 5.54 haben.
+ Rufe sudo apt-get install cpanminus and sudo cpanm Mojolicious auf, um auf die aktuelle Version zu updaten.
+ Die Konfiguration von TTS (TextToSpeech) ist in diesem FHEM Forum Beitrag beschrieben: Link
+ Fragen und Feedback bitte über das FHEM Forum: Link
+
+
+
+ Define
+
+ define <name> BOSEST
+ Beispiel:
+
+ define bosesystem BOSEST
+ Definiert das BOSE SoundTouch System. Alle Lautsprecher erscheinen innerhalb von ca. 60 s unter "Unsorted" in FHEM.
+
-=end html
+
+
+
+Set
+ set <name> <command> [<parameter>]
+ Die folgenden SET-Kommandos gelten für Lautsprecher (Ausnahme: autoAddDLNAServers ist nur für das Hauptmodul BOSEST) :
+ Allgemein
+ on - Lautsprecher einschaltenoff - Lautsprecher ausschaltenpower - Wechselt zw. on und offvolume [0...100] [+x|-x] - Lautstärke setzen (direkt oder als ±x Differenz zur aktuellen Lautstärke) channel 0...20 - Present auswählensaveChannel 07...20 - Aktuelle Wiedergabe als Present 07 bis 20 speichernplay - Startet die Wiedergabe pause - Pausiert die Wiedergabeplaypause - Wechselt zw. play und pausestop - Stoppt die WiedergabenextTrack - Nächsten Titel spielenprevTrack - Vorherigen Titel spielenplayTrack name|location|source[|sourceAccount] - Sucht per DNLA nach dem Titel und spielt ihn ab
+ Weitere Informationen:
+
+ - "Es ist immer nur eine Suche und die ist nach trackTitle, trackAlbum, trackArtist möglich, so wie in der SoundTouch App" (FHEM Forum Beitrag)
+ - "Einfach in der SoundTouch APP auf die Suche klicken und schauen, ob Playlists gefunden und abgespielt werden können." (FHEM Forum Beitrag)
+
+ mute on|off|toggle - Stummschaltungshuffle on|off - Zufallswiedergaberepeat all|one|off - Wiederholungbass 0...10 - Basseinstellungrecent 0...15 - Anzahl der Namen, die in der recent list in readings aufgeführt werdensource bluetooth,bt-discover,aux mode, airplay - lokale Quelle auswählen
+ addDLNAServer Name1 [Name2] [Namex] - DLNA server Name1 (und Name2 bis Namex) zur BOSE Bibliothek hinzufügenremoveDLNAServer Name1 [Name2] [Namex] - DLNA server Name1 (und Name2 bis Namex) aus der BOSE Bibliothek entfernen
+ Beispiel: set BOSE_1234567890AB volume 25 Setzt die Lautstärke des Lautsprechers BOSE_1234567890AB auf 25.
+
+ Zeiten:
+ on-for-timer 1...x - Schaltet den Lautsprecher für x Sekunden einoff-for-timer 1...x - Schaltet den Lautsprecher für x Sekunden auson-till hh:mm:ss - Schaltet den Lautsprecher bis zur angegebenen Zeit einoff-till hh:mm:ss - Schaltet den Lautsprecher bis und zur angegebenen Zeit auson-till-overneight hh:mm:ss - Schaltet den Lautsprecher bis zur angegebenen Zeit am nächsten Tag einoff-till-overneight hh:mm:ss - Schaltet den Lautsprecher bis zur angegebenen Zeit am nächsten Tag aus
+ Beispiel: set BOSE_1234567890AB on-till 23:00:00 Schaltet den Lautsprecher BOSE_1234567890AB ein und um 23:00:00 Uhr aus.
+
+ Multiroom:
+ createZone deviceID[,deviceID] - Legt eine Wiedergabe-Zone an und fügt einen oder mehrere Lautsprecher der Wiedergabezone hinzu addToZone deviceID - Fügt einen Lautsprecher einer bestehenden Wiedergabe-Zone zu removeFromZone deviceID - Entfernt einen Lautsprecher aus einer Wiedergabe-ZoneplayEverywhere - Startet "Überall wiedergeben"stopPlayEverywhere - Beendet "Überall wiedergeben"
+ Beispiel 1: set BOSE_1234567890AB playEverywhere Startet die Überall-Wiedergabe (Mit dem Lautsprecher BOSE_1234567890AB als Master-Lautsprecher).
+ Beispiel 2: set BOSE_1234567890AB createZone AB1234567890,12AB34567890 Definiert BOSE_1234567890AB als Master-Lautsprecher und fügt BOSE_AB1234567890 und BOSE_12AB34567890 der Wiedergabe-Zone hinzu
+ Hinweis: Drücken Sie 2x ein Present (innerhalb einer Sekunde) am Lautsprecher oder auf der Fernbedienung, wird "Überall Wiedergeben" ein oder ausgeschaltet.
+
+ Uhr Anzeige (nur für ST20/30):
+ clock enable/disable - Schaltet die Uhrenanzeige im Standby um
+ Beispiel: set BOSE_1234567890AB clock enable Zeigt die Uhr im Standby auf dem Display des ST20/30 an.
+
+ TextToSpeach (benötigt Google Translate):
+ speak "message" [0...100] [+x|-x] [en|de|xx] - Text den der Lautsprecher sagen soll, ggf. mit Lautstärkeangabe, die für diese Ansage verwendet werden soll. Nach der Ansage setzt der Lautsprecher die Wiedergabe fort.speakOff "message" [0...100] [+x|-x] [en|de|xx] - Text den der Lautsprecher sagen soll, ggf. mit Lautstärkeangabe, die für diese Ansage verwendet werden soll. Nach der Ansage schaltet der Lautsprecher ab.
+ Beispiel: set BOSE_1234567890AB speakOff "Ab isn Bett." 30 en Spricht die Meldung mit Lautstärke 30 und schaltet den Lautsprecher dann aus.
+
+ DNLA Server:
+ autoAddDLNAServers 0|1 - 1=automatisch alle DLNA servers zur BOSE Bibliothek hinzufügen. Dieser Parameter ist nur für das Hauptmodul BOSEST, nicht für die Lautsprecher!
+
+
+
+ Get
+
+
+
+ Attribute
+
+
+ staticIPs IP-Address [,IP-Address] - Manuelle Angabe der IP Adresse(n). Sollte nur verwendet werden, wenn die automatiche Erkennung nicht funktioniert. (z.B. bei mehreren Sub-Netzwerken oder wenn Teile des Netzwerks manuell verbunden werden, ...)
Beispiel: attr bosesystem staticIPs 192.168.1.52,192.168.1.53speakChannel channel(s) - Ansage des aktuellen Present vor der Wiedergabe, sinnvoll für SoundTouch Lautsprecher ohne Display (Angabe komma-separiert oder als Bereich: z.B. 2,3,5,6 oder 1-6 ). TTS muss eingerichtet sein.auto-zone on|off - "Überall Wiedergabe" automatisch starten, wenn Lautsprecher das gleiche wiedergeben ("contentItemLocation" ist identisch); (Standardwert: off)ttsDirectory "directory" - Angabe des DLNA TTS Verzeichnisses. Der FHEM user muss Schreibrechte in diesem Verzeichnis haben.ttsLanguage en|de|xx - Standardsprache für TTS setzen (default: en)ttsSpeakOnError 0|1 - 0= Ansage "not available" unterdrückenttsVolume [0...100] [+x|-x] - Lautstärke setzen (direkt oder als ±x Differnez zur aktuellen Lautstärke)Channel_07 to Channel_20 name|location|source|[sourceAccount] - Festlegen der Present 07 bis 20
Bei Wiedergabe kann in den readings "ContentItemLocationName, ContentItemLocation, etc. " ausgelesen werden. Dies Daten können dann verwendet werden, um die Presents zu belegen.
+
+
+=end html_DE
=cut