python-linkplay 0.2.3__tar.gz → 0.2.5__tar.gz

{python_linkplay-0.2.3/src/python_linkplay.egg-info → python_linkplay-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python_linkplay
-Version: 0.2.3
+Version: 0.2.5
 Summary: A Python Library for Seamless LinkPlay Device Control
 Author: Velleman Group nv
 License: MIT
@@ -48,16 +48,18 @@ Welcome to python-linkplay, a powerful and user-friendly Python library designed
 4. Metadata Retrieval: Retrieve essential metadata such as track information, artist details, and album data, enabling you to enhance the user interface and display relevant information in your applications.
 
 ## LinkPlay API documentation
-
-- https://github.com/n4archive/LinkPlayAPI
-- https://github.com/nagyrobi/home-assistant-custom-components-linkplay
-- https://github.com/ramikg/linkplay-cli
 - https://developer.arylic.com/httpapi/
 - http://airscope-audio.net/core2/pdf/airscope-module-http.pdf
 - https://www.wiimhome.com/pdf/HTTP%20API%20for%20WiiM%20Mini.pdf
 - https://www.wiimhome.com/pdf/HTTP%20API%20for%20WiiM%20Products.pdf
+
+## LinkPlay references
+- https://github.com/n4archive/LinkPlayAPI
+- https://github.com/nagyrobi/home-assistant-custom-components-linkplay
+- https://github.com/ramikg/linkplay-cli
 - https://github.com/DanBrezeanu/wiim-extended-http-api
 - https://github.com/cvdlinden/wiim-httpapi
+- https://community.openhab.org/t/linkplay-binding/161995
 
 ## Multiroom
 

{python_linkplay-0.2.3 → python_linkplay-0.2.5}/README.md

@@ -20,16 +20,18 @@ Welcome to python-linkplay, a powerful and user-friendly Python library designed
 4. Metadata Retrieval: Retrieve essential metadata such as track information, artist details, and album data, enabling you to enhance the user interface and display relevant information in your applications.
 
 ## LinkPlay API documentation
-
-- https://github.com/n4archive/LinkPlayAPI
-- https://github.com/nagyrobi/home-assistant-custom-components-linkplay
-- https://github.com/ramikg/linkplay-cli
 - https://developer.arylic.com/httpapi/
 - http://airscope-audio.net/core2/pdf/airscope-module-http.pdf
 - https://www.wiimhome.com/pdf/HTTP%20API%20for%20WiiM%20Mini.pdf
 - https://www.wiimhome.com/pdf/HTTP%20API%20for%20WiiM%20Products.pdf
+
+## LinkPlay references
+- https://github.com/n4archive/LinkPlayAPI
+- https://github.com/nagyrobi/home-assistant-custom-components-linkplay
+- https://github.com/ramikg/linkplay-cli
 - https://github.com/DanBrezeanu/wiim-extended-http-api
 - https://github.com/cvdlinden/wiim-httpapi
+- https://community.openhab.org/t/linkplay-binding/161995
 
 ## Multiroom
 

python_linkplay-0.2.5/src/linkplay/__version__.py

@@ -0,0 +1 @@
+__version__ = '0.2.5'

{python_linkplay-0.2.3 → python_linkplay-0.2.5}/src/linkplay/bridge.py

@@ -7,12 +7,15 @@ from linkplay.consts import (
     INPUT_MODE_MAP,
     LOGGER,
     PLAY_MODE_SEND_MAP,
+    AudioOutputHwMode,
     ChannelType,
     DeviceAttribute,
     EqualizerMode,
     InputMode,
     LinkPlayCommand,
     LoopMode,
+    MetaInfo,
+    MetaInfoMetaData,
     MultiroomAttribute,
     MuteMode,
     PlayerAttribute,
@@ -128,6 +131,7 @@ class LinkPlayPlayer:
     bridge: LinkPlayBridge
     properties: dict[PlayerAttribute, str]
     custom_properties: dict[PlayerAttribute, str]
+    metainfo: dict[MetaInfo, dict[MetaInfoMetaData, str]]
 
     previous_playing_mode: PlayingMode | None = None
 
@@ -135,6 +139,7 @@ class LinkPlayPlayer:
         self.bridge = bridge
         self.properties = dict.fromkeys(PlayerAttribute.__members__.values(), "")
         self.custom_properties = dict.fromkeys(PlayerAttribute.__members__.values(), "")
+        self.metainfo = dict.fromkeys(MetaInfo.__members__.values(), {})
 
     def to_dict(self):
         """Return the state of the LinkPlayPlayer."""
@@ -147,6 +152,18 @@ class LinkPlayPlayer:
         )  # type: ignore[assignment]
 
         self.properties = fixup_player_properties(properties)
+        if self.bridge.device.manufacturer == MANUFACTURER_WIIM:
+            try:
+                self.metainfo: dict[
+                    MetaInfo, dict[MetaInfoMetaData, str]
+                ] = await self.bridge.json_request(LinkPlayCommand.META_INFO)  # type: ignore[assignment]
+            except LinkPlayInvalidDataException as exc:
+                if getattr(exc, "data", None) == "Failed":
+                    self.metainfo = {}
+                else:
+                    raise
+        else:
+            self.metainfo = {}
 
         # handle multiroom changes
         if self.bridge.device.controller is not None and (
@@ -277,6 +294,14 @@ class LinkPlayPlayer:
         ):
             await self.bridge.request(LinkPlayCommand.SEEK.format(position))
 
+    async def set_audio_output_hw_mode(self, mode: AudioOutputHwMode) -> None:
+        """Set the audio hardware output."""
+        await self.bridge.request(LinkPlayCommand.AUDIO_OUTPUT_HW_MODE_SET.format(mode))
+
+    async def get_audio_output_hw_mode(self) -> None:
+        """Get the audio hardware output."""
+        await self.bridge.json_request(LinkPlayCommand.AUDIO_OUTPUT_HW_MODE)
+
     @property
     def muted(self) -> bool:
         """Returns if the player is muted."""
@@ -300,6 +325,13 @@ class LinkPlayPlayer:
         """Returns if the currently playing album."""
         return self.properties.get(PlayerAttribute.ALBUM, "")
 
+    @property
+    def album_art(self) -> str:
+        """Returns the url to the album art."""
+        return self.metainfo.get(MetaInfo.METADATA, {}).get(
+            MetaInfoMetaData.ALBUM_ART, ""
+        )
+
     @property
     def volume(self) -> int:
         """Returns the player volume, expressed in %."""

{python_linkplay-0.2.3 → python_linkplay-0.2.5}/src/linkplay/consts.py

@@ -100,6 +100,9 @@ class LinkPlayCommand(StrEnum):
     PLAY_PRESET = "MCUKeyShortClick:{}"
     TIMESYNC = "timeSync:{}"
     WIIM_EQ_LOAD = "EQLoad:{}"
+    META_INFO = "getMetaInfo"
+    AUDIO_OUTPUT_HW_MODE_SET = "setAudioOutputHardwareMode:{}"
+    AUDIO_OUTPUT_HW_MODE = "getNewAudioOutputHardwareMode"
 
 
 class LinkPlayTcpUartCommand(StrEnum):
@@ -470,3 +473,50 @@ class MultiroomAttribute(StrEnum):
 
     def __repr__(self):
         return self.value
+
+
+class MetaInfo(StrEnum):
+    METADATA = "metaData"
+
+    def __str__(self):
+        return self.value
+
+    def __repr__(self):
+        return self.value
+
+
+class MetaInfoMetaData(StrEnum):
+    """Defines the metadata within the metainfo."""
+
+    ALBUM_TITLE = "album"
+    TRACK_TITLE = "title"
+    TRACK_SUBTITLE = "subtitle"
+    ALBUM_ART = "albumArtURI"
+    SAMPLE_RATE = "sampleRate"
+    BIT_DEPTH = "bitDepth"
+    BIT_RATE = "bitRate"
+    TRACK_ID = "trackId"
+
+    def __str__(self):
+        return self.value
+
+    def __repr__(self):
+        return self.value
+
+
+class AudioOutputHwMode(StrEnum):
+    """Defines a output mode for the hardware."""
+
+    OPTICAL = "1"
+    LINE_OUT = "2"
+    COAXIAL = "3"
+    HEADPHONES = "4"
+
+
+# Map between a play mode and how to activate the play mode
+AUDIO_OUTPUT_HW_MODE_MAP: dict[AudioOutputHwMode, str] = {  # case sensitive!
+    AudioOutputHwMode.OPTICAL: "optical",
+    AudioOutputHwMode.LINE_OUT: "line-out",
+    AudioOutputHwMode.COAXIAL: "co-axial",
+    AudioOutputHwMode.HEADPHONES: "headphones",
+}

{python_linkplay-0.2.3 → python_linkplay-0.2.5}/src/linkplay/exceptions.py

@@ -7,4 +7,6 @@ class LinkPlayRequestException(LinkPlayException):
 
 
 class LinkPlayInvalidDataException(LinkPlayException):
-    pass
+    def __init__(self, message: str = "Invalid data received", data: str | None = None):
+        super().__init__(message)
+        self.data = data

{python_linkplay-0.2.3 → python_linkplay-0.2.5}/src/linkplay/utils.py

@@ -82,7 +82,7 @@ async def session_call_api_json(
     except json.JSONDecodeError as jsonexc:
         url = API_ENDPOINT.format(endpoint, command)
         raise LinkPlayInvalidDataException(
-            f"Unexpected JSON ({result}) received from '{url}'"
+            message=f"Unexpected JSON ({result}) received from '{url}'", data=result
         ) from jsonexc
 
 

{python_linkplay-0.2.3 → python_linkplay-0.2.5/src/python_linkplay.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python_linkplay
-Version: 0.2.3
+Version: 0.2.5
 Summary: A Python Library for Seamless LinkPlay Device Control
 Author: Velleman Group nv
 License: MIT
@@ -48,16 +48,18 @@ Welcome to python-linkplay, a powerful and user-friendly Python library designed
 4. Metadata Retrieval: Retrieve essential metadata such as track information, artist details, and album data, enabling you to enhance the user interface and display relevant information in your applications.
 
 ## LinkPlay API documentation
-
-- https://github.com/n4archive/LinkPlayAPI
-- https://github.com/nagyrobi/home-assistant-custom-components-linkplay
-- https://github.com/ramikg/linkplay-cli
 - https://developer.arylic.com/httpapi/
 - http://airscope-audio.net/core2/pdf/airscope-module-http.pdf
 - https://www.wiimhome.com/pdf/HTTP%20API%20for%20WiiM%20Mini.pdf
 - https://www.wiimhome.com/pdf/HTTP%20API%20for%20WiiM%20Products.pdf
+
+## LinkPlay references
+- https://github.com/n4archive/LinkPlayAPI
+- https://github.com/nagyrobi/home-assistant-custom-components-linkplay
+- https://github.com/ramikg/linkplay-cli
 - https://github.com/DanBrezeanu/wiim-extended-http-api
 - https://github.com/cvdlinden/wiim-httpapi
+- https://community.openhab.org/t/linkplay-binding/161995
 
 ## Multiroom
 

python_linkplay-0.2.3/src/linkplay/__version__.py

@@ -1 +0,0 @@
-__version__ = '0.2.3'