Adding support for Genius Lyrics metadata provider (#2337)

diff --git a/music_assistant/providers/genius_lyrics/__init__.py b/music_assistant/providers/genius_lyrics/__init__.py
new file mode 100644 (file)
index 0000000..853567c
--- /dev/null
+++ b/music_assistant/providers/genius_lyrics/__init__.py
@@ -0,0 +1,129 @@
+"""
+The Genius Lyrics Metadata provider for Music Assistant.
+
+Used for retrieval of lyrics.
+"""
+
+from __future__ import annotations
+
+import asyncio
+from typing import TYPE_CHECKING
+
+from music_assistant_models.enums import ProviderFeature
+from music_assistant_models.media_items import MediaItemMetadata, Track
+
+from music_assistant.models.metadata_provider import MetadataProvider
+
+if TYPE_CHECKING:
+    from music_assistant_models.config_entries import ConfigEntry, ConfigValueType, ProviderConfig
+    from music_assistant_models.provider import ProviderManifest
+
+    from music_assistant.mass import MusicAssistant
+    from music_assistant.models import ProviderInstanceType
+
+from lyricsgenius import Genius
+
+from .helpers import clean_song_title, cleanup_lyrics
+
+SUPPORTED_FEATURES = {
+    ProviderFeature.TRACK_METADATA,
+}
+
+
+async def setup(
+    mass: MusicAssistant, manifest: ProviderManifest, config: ProviderConfig
+) -> ProviderInstanceType:
+    """Initialize provider(instance) with given configuration."""
+    return GeniusProvider(mass, manifest, config)
+
+
+async def get_config_entries(
+    mass: MusicAssistant,
+    instance_id: str | None = None,
+    action: str | None = None,
+    values: dict[str, ConfigValueType] | None = None,
+) -> tuple[ConfigEntry, ...]:
+    """
+    Return Config entries to setup this provider.
+
+    instance_id: id of an existing provider instance (None if new instance setup).
+    action: [optional] action key called from config entries UI.
+    values: the (intermediate) raw values for config entries sent with the action.
+    """
+    # ruff: noqa: ARG001
+    return ()  # we do not have any config entries (yet)
+
+
+class GeniusProvider(MetadataProvider):
+    """Genius Lyrics provider for handling lyrics."""
+
+    async def handle_async_init(self) -> None:
+        """Handle async initialization of the provider."""
+        self._genius = Genius("public", skip_non_songs=True, remove_section_headers=True)
+
+    @property
+    def supported_features(self) -> set[ProviderFeature]:
+        """Return the features supported by this Provider."""
+        return SUPPORTED_FEATURES
+
+    async def get_track_metadata(self, track: Track) -> MediaItemMetadata | None:
+        """Retrieve synchronized lyrics for a track."""
+        if track.metadata and (track.metadata.lyrics or track.metadata.lrc_lyrics):
+            self.logger.debug("Skipping lyrics lookup for %s: Already has lyrics", track.name)
+            return None
+
+        if not track.artists:
+            self.logger.debug("Skipping lyrics lookup for %s: No artist information", track.name)
+            return None
+
+        artist_name = track.artists[0].name
+
+        if not track.name or len(track.name.strip()) == 0:
+            self.logger.debug(
+                "Skipping lyrics lookup for %s: No track name information", artist_name
+            )
+            return None
+
+        song_lyrics = await asyncio.to_thread(self._fetch_lyrics, artist_name, track.name)
+
+        if song_lyrics:
+            metadata = MediaItemMetadata()
+            metadata.lyrics = song_lyrics
+
+            self.logger.debug("Found lyrics for %s by %s", track.name, artist_name)
+            return metadata
+
+        self.logger.debug("No lyrics found for %s by %s", track.name, artist_name)
+        return None
+
+    def _fetch_lyrics(self, artist: str, title: str) -> str | None:
+        """Fetch lyrics - NOTE: not async friendly."""
+        # blank artist / title?
+        if artist is None or len(artist.strip()) == 0 or title is None or len(title.strip()) == 0:
+            self.logger.error("Cannot fetch lyrics without artist and title")
+            return None
+
+        # clean song title to increase chance and accuracy of a result
+        cleaned_title = clean_song_title(title)
+        if cleaned_title != title:
+            self.logger.debug(f'Song title was cleaned: "{title}"  ->  "{cleaned_title}"')
+
+        self.logger.info(f"Searching lyrics for artist='{artist}' and title='{cleaned_title}'")
+
+        # perform search
+        song = self._genius.search_song(cleaned_title, artist, get_full_info=False)
+
+        # second search needed?
+        if not song and " - " in cleaned_title:
+            # aggressively truncate title from the first hyphen
+            cleaned_title = cleaned_title.split(" - ", 1)[0]
+            self.logger.info(f"Second attempt, aggressively cleaned title='{cleaned_title}'")
+
+            # perform search
+            song = self._genius.search_song(cleaned_title, artist, get_full_info=False)
+
+        if song:
+            # attempts to clean lyrics of erroneous text
+            return cleanup_lyrics(song)
+
+        return None

diff --git a/music_assistant/providers/genius_lyrics/helpers.py b/music_assistant/providers/genius_lyrics/helpers.py
new file mode 100644 (file)
index 0000000..74b8106
--- /dev/null
+++ b/music_assistant/providers/genius_lyrics/helpers.py
@@ -0,0 +1,49 @@
+"""Helpers for the Genius Lyrics provider."""
+
+import re
+
+from lyricsgenius.types import Song
+
+
+def clean_song_title(song_title: str) -> str:
+    """Clean song title string by removing metadata that may appear."""
+    # Keywords to look for in parentheses, brackets, or after a hyphen
+    keywords = (
+        r"(remaster(?:ed)?|anniversary|instrumental|live|edit(?:ion)?|"
+        r"single(s)?|stereo|album|radio|version|feat(?:uring)?|mix|bonus)"
+    )
+
+    # Regex pattern to match metadata within parentheses or brackets
+    paren_bracket_pattern = rf"[\(\[][^\)\]]*\b({keywords})\b[^\)\]]*[\)\]]"
+    cleaned_title = re.sub(paren_bracket_pattern, "", song_title, flags=re.IGNORECASE)
+
+    # Regex pattern to match a hyphen followed by metadata (keywords or a year)
+    hyphen_pattern = rf"(\s*-\s*(\d{{4}}|{keywords}).*)$"
+    cleaned_title = re.sub(hyphen_pattern, "", cleaned_title, flags=re.IGNORECASE)
+
+    # Remove any dangling hyphens or extra spaces
+    cleaned_title = re.sub(r"\s*-\s*$", "", cleaned_title).strip()
+
+    # Remove any leftover unmatched parentheses or brackets
+    return re.sub(r"\s[\(\[\{\]\)\}\s]+$", "", cleaned_title).strip()
+
+
+def cleanup_lyrics(song: Song) -> str:
+    """Clean lyrics string hackishly remove erroneous text that may appear."""
+    # Pattern1: match digits at beginning followed by "Contributors" and text followed by "Lyrics"
+    pattern1 = r"^(\d+) Contributor(.*?) Lyrics"
+    lyrics = re.sub(pattern1, "", song.lyrics, flags=re.DOTALL)
+
+    # Pattern2: match ending with "Embed"
+    lyrics = lyrics.rstrip("Embed")
+
+    # Pattern3: match ending with Pyong Count
+    lyrics = lyrics.rstrip(str(song.pyongs_count))
+
+    # Pattern4: match "See [artist] LiveGet tickets as low as $[price]"
+    pattern4 = rf"See {song.artist} LiveGet tickets as low as \$\d+"
+    lyrics = re.sub(pattern4, "", lyrics)
+
+    # Pattern5: match "You might also like" not followed by whitespace
+    pattern5 = r"You might also like(?!\s)"
+    return re.sub(pattern5, "", lyrics)

diff --git a/music_assistant/providers/genius_lyrics/icon.svg b/music_assistant/providers/genius_lyrics/icon.svg
new file mode 100644 (file)
index 0000000..3638415
--- /dev/null
+++ b/music_assistant/providers/genius_lyrics/icon.svg
@@ -0,0 +1,947 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   version="1.1"
+   id="svg2"
+   width="682.66669"
+   height="682.66669"
+   viewBox="0 0 682.66669 682.66669"
+   sodipodi:docname="icon.svg"
+   inkscape:version="1.1.2 (0a00cf5339, 2022-02-04)"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <defs
+     id="defs6" />
+  <sodipodi:namedview
+     id="namedview4"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     showgrid="false"
+     inkscape:zoom="1.2788086"
+     inkscape:cx="341.33334"
+     inkscape:cy="340.94235"
+     inkscape:window-width="2560"
+     inkscape:window-height="1339"
+     inkscape:window-x="0"
+     inkscape:window-y="32"
+     inkscape:window-maximized="1"
+     inkscape:current-layer="g8" />
+  <g
+     inkscape:groupmode="layer"
+     inkscape:label="Image"
+     id="g8">
+    <image
+       width="682.66669"
+       height="682.66669"
+       preserveAspectRatio="none"
+       xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAgAAAAIACAYAAAD0eNT6AAAA0GVYSWZJSSoACAAAAAoAAAEEAAEA
+AAAAAgAAAQEEAAEAAAAAAgAAAgEDAAMAAACGAAAAEgEDAAEAAAABAAAAGgEFAAEAAACMAAAAGwEF
+AAEAAACUAAAAKAEDAAEAAAACAAAAMQECAA0AAACcAAAAMgECABQAAACqAAAAaYcEAAEAAAC+AAAA
+AAAAAAgACAAIACcRAAA9AAAAJxEAAD0AAABHSU1QIDIuMTAuMzQAADIwMjQ6MDE6MTAgMTI6MDE6
+NDkAAQABoAMAAQAAAAEAAAAAAAAAv4YnMQAAAYRpQ0NQSUNDIHByb2ZpbGUAAHicfZE9SMNQFIVP
+U6VSKh3aQcQhQ3WyICrSUatQhAqhVmjVweT1F5o0JCkujoJrwcGfxaqDi7OuDq6CIPgD4uzgpOgi
+Jd6XFFrEeOHxPs675/DefYDQqjHV7JsAVM0yMqmkmMuvioFX+BBEBAmEZWbqc5KUhmd93VM31V2c
+Z3n3/VmDhaLJAJ9IPMt0wyLeIJ7ZtHTO+8RRVpELxOfE4wZdkPiR64rLb5zLDgs8M2pkM/PEUWKx
+3MNKD7OKoRJPE8cKqkb5Qs7lAuctzmqtwTr35C8MFbWVZa7TGkEKi1iCBBEKGqiiBgtx2jVSTGTo
+POnhH3b8ErkUclXByLGAOlTIjh/8D37P1ixNTbpJoSTQ/2LbH6NAYBdoN237+9i22yeA/xm40rr+
+egtIfJLe7GqxIyC8DVxcdzVlD7jcAYaedNmQHclPSyiVgPcz+qY8ELkFgmvu3DrnOH0AsjSr9A1w
+cAiMlSl73ePdA71z+7enM78fcIxypudu1ukAAA14aVRYdFhNTDpjb20uYWRvYmUueG1wAAAAAAA8
+P3hwYWNrZXQgYmVnaW49Iu+7vyIgaWQ9Ilc1TTBNcENlaGlIenJlU3pOVGN6a2M5ZCI/Pgo8eDp4
+bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIiB4OnhtcHRrPSJYTVAgQ29yZSA0LjQuMC1F
+eGl2MiI+CiA8cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjIt
+cmRmLXN5bnRheC1ucyMiPgogIDxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSIiCiAgICB4bWxu
+czp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIKICAgIHhtbG5zOnN0RXZ0
+PSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvc1R5cGUvUmVzb3VyY2VFdmVudCMiCiAgICB4
+bWxuczpkYz0iaHR0cDovL3B1cmwub3JnL2RjL2VsZW1lbnRzLzEuMS8iCiAgICB4bWxuczpHSU1Q
+PSJodHRwOi8vd3d3LmdpbXAub3JnL3htcC8iCiAgICB4bWxuczp0aWZmPSJodHRwOi8vbnMuYWRv
+YmUuY29tL3RpZmYvMS4wLyIKICAgIHhtbG5zOnhtcD0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAv
+MS4wLyIKICAgeG1wTU06RG9jdW1lbnRJRD0iZ2ltcDpkb2NpZDpnaW1wOjI2MmE3ZWViLTJmNzMt
+NGU5ZC04ODBmLTlkOTgzMzkyZjk4NyIKICAgeG1wTU06SW5zdGFuY2VJRD0ieG1wLmlpZDo3ZWZk
+NTEwYy1jZjJhLTRjZGQtYTg1ZC00Y2I4YWJlZGZkNzUiCiAgIHhtcE1NOk9yaWdpbmFsRG9jdW1l
+bnRJRD0ieG1wLmRpZDo4NDVmNWY5MS02Nzg4LTRmZTItYWE5NC1hZDgzMjY1OWNjMjEiCiAgIGRj
+OkZvcm1hdD0iaW1hZ2UvcG5nIgogICBHSU1QOkFQST0iMi4wIgogICBHSU1QOlBsYXRmb3JtPSJM
+aW51eCIKICAgR0lNUDpUaW1lU3RhbXA9IjE3MDQ5MTY5MTE4NTE3MjAiCiAgIEdJTVA6VmVyc2lv
+bj0iMi4xMC4zNCIKICAgdGlmZjpPcmllbnRhdGlvbj0iMSIKICAgeG1wOkNyZWF0b3JUb29sPSJH
+SU1QIDIuMTAiCiAgIHhtcDpNZXRhZGF0YURhdGU9IjIwMjQ6MDE6MTBUMTI6MDE6NDktMDg6MDAi
+CiAgIHhtcDpNb2RpZnlEYXRlPSIyMDI0OjAxOjEwVDEyOjAxOjQ5LTA4OjAwIj4KICAgPHhtcE1N
+Okhpc3Rvcnk+CiAgICA8cmRmOlNlcT4KICAgICA8cmRmOmxpCiAgICAgIHN0RXZ0OmFjdGlvbj0i
+c2F2ZWQiCiAgICAgIHN0RXZ0OmNoYW5nZWQ9Ii8iCiAgICAgIHN0RXZ0Omluc3RhbmNlSUQ9Inht
+cC5paWQ6OTFjZDQ0MGMtNmI2OS00ZjY3LThkNjUtNmE3MzgyMDc5ZTliIgogICAgICBzdEV2dDpz
+b2Z0d2FyZUFnZW50PSJHaW1wIDIuMTAgKExpbnV4KSIKICAgICAgc3RFdnQ6d2hlbj0iMjAyNC0w
+MS0xMFQxMjowMTo1MS0wODowMCIvPgogICAgPC9yZGY6U2VxPgogICA8L3htcE1NOkhpc3Rvcnk+
+CiAgPC9yZGY6RGVzY3JpcHRpb24+CiA8L3JkZjpSREY+CjwveDp4bXBtZXRhPgogICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAK
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
+ICAgICAgICAgICAgICAKICAgICAgICAgICAgICAgICAgICAgICAgICAgCjw/eHBhY2tldCBlbmQ9
+InciPz5Rp15KAAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAAsSAAALEgHS3X78AAAAB3RJTUUH
+6AEKFAEz2fqhYAAAIABJREFUeNrsvfmTZNd15/c59973spZegEZjYWOlSFAUKYkURVGkREkjaShq
+GVETI4/GoYiZsH8e/+bwP+Hwbw6HxnbYlmwtI4oaUuICkiJIglgJEGBj773R+75Ud3Xl8u49xz/c
+l9XVjSYBDXvNPh9GshpZWVmVb7nne88qo6X/wXAcx3Ec57Yi+CFwHMdxHBcAjuM4juO4AHAcx3Ec
+xwWA4ziO4zguABzHcRzHcQHgOI7jOI4LAMdxHMdxXAA4juM4juMCwHEcx3EcFwCO4ziO47gAcBzH
+cRzHBYDjOI7jOC4AHMdxHMdxAeA4juM4jgsAx3Ecx3FcADiO4ziO4wLAcRzHcRwXAI7jOI7jAsBx
+HMdxHBcAjuM4juO4AHAcx3EcxwWA4ziO4zguABzHcRzHcQHgOI7jOI4LAMdxHMdxXAA4juM4juMC
+wHEcx3EcFwCO4ziO47gAcBzHcRzHBYDjOI7jOC4AHMdxHMdxAeA4juM4jgsAx3Ecx3FcADiO4ziO
+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
+"
+       id="image10" />
+  </g>
+</svg>

diff --git a/music_assistant/providers/genius_lyrics/manifest.json b/music_assistant/providers/genius_lyrics/manifest.json
new file mode 100644 (file)
index 0000000..25a87ab
--- /dev/null
+++ b/music_assistant/providers/genius_lyrics/manifest.json
@@ -0,0 +1,12 @@
+{
+  "type": "metadata",
+  "domain": "genius_lyrics",
+  "stage": "alpha",
+  "name": "Genius Lyrics",
+  "description": "Genius.com is a free service for finding song lyrics and annotations.",
+  "codeowners": ["@robert-alfaro"],
+  "requirements": ["lyricsgenius==3.6.5"],
+  "documentation": "https://www.music-assistant.io/metadata/",
+  "multi_instance": false,
+  "icon": "mdi-script-text"
+}

diff --git a/requirements_all.txt b/requirements_all.txt
index 7a48fe633cae76baa5c8c960cda72fd750db51f7..7fbd582eab8ce456043d5b399c6f653c43500602 100644 (file)
--- a/requirements_all.txt
+++ b/requirements_all.txt
@@ -28,6 +28,7 @@ hass-client==1.2.0
 ibroadcastaio==0.4.0
 ifaddr==0.2.0
 liblistenbrainz==0.6.0
+lyricsgenius==3.6.5
 mashumaro==3.16
 music-assistant-frontend==2.15.3
 music-assistant-models==1.1.53