Update custom_components/samsung_soundbar/manifest.json

## [0.4.1] Media Mystique: The Great Data Disappearing Act!

### Fixed

- Made media data (*track title*, *artist*, *length*) optional to acoomodate soundbars that don't provide this information (🥲)

### Added

- Add translations for the english translation file

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.4.1] Media Mystique: The Great Data Disappearing Act!
+
+### Fixed
+
+- Made media data (*track title*, *artist*, *length*) optional to acoomodate soundbars that don't provide this information (🥲)
+
+### Added
+
+- Add translations for the english translation file
+
 ## [0.4.0] Started with an "ick", but is now packed with new features 💪
 
 > ⚠️ Please read the following carefully:

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Samuel Spagl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -2,6 +2,9 @@
 
 Welcome to YASSI, the Home Assistant integration designed to bring comprehensive control over your Samsung Soundbar into your smart home ecosystem.
 
+> [!NOTE]
+> Please use service calls for setting the attribute of a custom capability instead of the entity. (See #43 for more information)
+
 **Table of Contents:**
 <!-- TOC -->
 * [Why YASSI](#why-yassi)

custom_components/samsung_soundbar/api_extension/SoundbarDevice.py

@@ -72,18 +72,19 @@ class SoundbarDevice:
             await self._update_equalizer()
 
     async def _update_media(self):
-        self.__media_artist = self.device.status._attributes["audioTrackData"].value[
+        if "audioTrackData" in self.device.status._attributes:
-            "artist"
+            self.__media_artist = self.device.status._attributes["audioTrackData"].value[
-        ]
+                "artist"
-        self.__media_title = self.device.status._attributes["audioTrackData"].value[
+            ]
-            "title"
+            self.__media_title = self.device.status._attributes["audioTrackData"].value[
-        ]
+                "title"
-        if self.__media_title != self.__old_media_title:
+            ]
-            self.__old_media_title = self.__media_title
+            if self.__media_title != self.__old_media_title:
-            self.__media_cover_url_update_time = datetime.datetime.now()
+                self.__old_media_title = self.__media_title
-            self.__media_cover_url = await self.get_song_title_artwork(
+                self.__media_cover_url_update_time = datetime.datetime.now()
-                self.__media_artist, self.__media_title
+                self.__media_cover_url = await self.get_song_title_artwork(
-            )
+                    self.__media_artist, self.__media_title
+                )
 
     async def _update_soundmode(self):
         await self.update_execution_data(["/sec/networkaudio/soundmode"])
@@ -372,11 +373,15 @@ class SoundbarDevice:
 
     @property
     def media_duration(self) -> int | None:
-        return self.device.status.attributes.get("totalTime").value
+        attr = self.device.status.attributes.get("totalTime", None)
+        if attr:
+            return attr.value
 
     @property
     def media_position(self) -> int | None:
-        return self.device.status.attributes.get("elapsedTime").value
+        attr = self.device.status.attributes.get("elapsedTime", None)
+        if attr:
+            return attr.value
 
     async def media_play(self):
         await self.device.play(True)

custom_components/samsung_soundbar/manifest.json

@@ -1,12 +1,16 @@
 {
   "domain": "samsung_soundbar",
   "name": "Samsung Soundbar",
-  "codeowners": ["@samuelspagl"],
+  "codeowners": [
+    "@samuelspagl"
+  ],
   "config_flow": true,
   "documentation": "https://www.example.com",
   "integration_type": "hub",
   "iot_class": "cloud_polling",
   "issue_tracker": "https://github.com/samuelspagl/ha_samsung_soundbar/issues",
-  "requirements": ["pysmartthings"],
+  "requirements": [
-  "version": "0.4.0"
+    "pysmartthings==0.7.8"
+  ],
+  "version": "0.4.1"
 }

custom_components/samsung_soundbar/translations/de.json

@@ -107,11 +107,27 @@
     },
     "set_speaker_level":{
         "name": "Lautsprecher level verändern",
-        "description": "Verändere die Lautstärke der einzelnen Lautsprecher"
+        "description": "Verändere die Lautstärke der einzelnen Lautsprecher",
+        "fields":{
+                "speaker_identifier": {
+                    "name": "Lautsprecher",
+                    "description": "Auszuwählender Lautsprecher"
+                },
+                "level": {
+                    "name": "Lautstärke Level",
+                    "description": "Lautstärke Level zwischen -6 und 6."
+                }
+            }
     },
     "set_rear_speaker_mode":{
         "name": "Modus der hinteren Lautsprecher setzen",
-        "description": "Nutze deine Rücklautsprecher, als 'Vorder-' oder 'Rücklautsprecher'."
+        "description": "Nutze deine Rücklautsprecher, als 'Vorder-' oder 'Rücklautsprecher'.",
+        "fields":{
+                "speaker_mode": {
+                    "name": "Lautsprecher Modus",
+                    "description": "Nutze den Lautsprecher als Front oder Rear Speaker."
+                }
+            }
     },
     "set_active_voice_amplifier":{
         "name": "Stimmenverstärker setzen",

custom_components/samsung_soundbar/translations/en.json

@@ -1,18 +1,18 @@
 {
-    "config":{
+    "config": {
-        "step":{
+        "step": {
-            "user":{
+            "user": {
                 "data": {
                     "api_key": "SmartThings API Token",
                     "device_id": "Device ID",
-                    "device_name":"Device Name",
+                    "device_name": "Device Name",
                     "device_volume": "Max Volume (int)"
-                  },
+                },
-                  "description": "Please enter your credentials.",
+                "description": "Please enter your credentials.",
-                  "title": "Authentication"
+                "title": "Authentication"
             },
-            "device":{
+            "device": {
-                "data" : {
+                "data": {
                     "settings_advanced_audio": "Enable 'Advanced Audio switches' capabilities (NightMode, BassMode, VoiceEnhancer)",
                     "settings_eq": "Enable 'EQ selector' capabilities",
                     "settings_soundmode": "Enable 'Soundmode selector' capabilities",
@@ -21,8 +21,8 @@
                 "description": "Some soundbars have a different featureset than others. Please the features supported by your soundbar (visible in the SmartThings App).",
                 "title": "Device Settings"
             },
-            "reconfigure_confirm":{
+            "reconfigure_confirm": {
-                "data" : {
+                "data": {
                     "settings_advanced_audio": "Enable 'Advanced Audio switches' capabilities (NightMode, BassMode, VoiceEnhancer)",
                     "settings_eq": "Enable 'EQ selector' capabilities",
                     "settings_soundmode": "Enable 'Soundmode selector' capabilities",
@@ -59,5 +59,95 @@
                 "Front": "Front"
             }
         }
-  }
+    },
+    "services": {
+        "select_soundmode": {
+            "name": "Select Sound Mode",
+            "description": "Choose between 'Standard', 'Surround', 'Game', and 'Adaptive Sound'."
+        },
+        "set_woofer_level": {
+            "name": "Set Subwoofer Level",
+            "description": "Change the volume of your subwoofer.",
+            "fields": {
+                "level": {
+                    "name": "Volume Level",
+                    "description": "Subwoofer level, from -12 to +6"
+                }
+            }
+        },
+        "set_night_mode": {
+            "name": "Set Night Mode",
+            "description": "Turn 'Night Mode' on/off.",
+            "fields": {
+                "enabled": {
+                    "name": "On/Off",
+                    "description": "See name."
+                }
+            }
+        },
+        "set_bass_enhancer": {
+            "name": "Set Bass Mode",
+            "description": "Turn 'Bass Mode' on/off.",
+            "fields": {
+                "enabled": {
+                    "name": "On/Off",
+                    "description": "See name."
+                }
+            }
+        },
+        "set_voice_enhancer": {
+            "name": "Set Voice Enhancer",
+            "description": "Turn 'Voice Enhancer' on/off.",
+            "fields": {
+                "enabled": {
+                    "name": "On/Off",
+                    "description": "See name."
+                }
+            }
+        },
+        "set_speaker_level": {
+            "name": "Change Speaker Level",
+            "description": "Change the volume of individual speakers.",
+            "fields":{
+                "speaker_identifier": {
+                    "name": "Speaker Identifier",
+                    "description": "Identifier of the speaker."
+                },
+                "level": {
+                    "name": "Level",
+                    "description": "Level of the Speaker from -6 to 6."
+                }
+            }
+        },
+        "set_rear_speaker_mode": {
+            "name": "Set Rear Speaker Mode",
+            "description": "Use your rear speakers as 'Front' or 'Rear' speakers.",
+            "fields":{
+                "speaker_mode": {
+                    "name": "Speaker mode",
+                    "description": "Weather the speaker are used as rear / front speakers."
+                }
+            }
+        },
+        "set_active_voice_amplifier": {
+            "name": "Set Voice Amplifier",
+            "description": "Turn 'Voice Amplifier' on/off.",
+            "fields": {
+                "enabled": {
+                    "name": "On/Off",
+                    "description": "See name."
+                }
+            }
+        },
+        "set_space_fit_sound": {
+            "name": "Set SpaceFitSound",
+            "description": "Turn 'SpaceFitSound' on/off.",
+            "fields": {
+                "enabled": {
+                    "name": "On/Off",
+                    "description": "See name."
+                }
+            }
+        }
+    }
 }