Add MusicMe music provider by JulienDeveaux · Pull Request #3393 · music-assistant/server

JulienDeveaux · 2026-03-14T15:27:45Z

Summary

Add a new music provider for MusicMe (musicme.com), a French legal music streaming service operated by ApachNetwork with a catalogue of 13M+ tracks from major and independent labels.

Features

Search: artists, albums, tracks (with web search fallback for niche queries)
Browse: new releases (by genre), top artists, radios by theme, homepage highlights
Recommendations: powers the Discover page with 4 sections (featured, new releases, top artists, radios)
Artist details: albums, top tracks (derived from recent albums)
Radios: 26 thematic radios and artist mixes
Playlists: user playlist listing
Streaming: AAC in MP4 container, 44.1kHz stereo, ~111kbps via ephemeral ticket-based URLs

Supported features

LIBRARY_PLAYLISTS, LIBRARY_RADIOS
SEARCH
ARTIST_ALBUMS, ARTIST_TOPTRACKS
BROWSE, RECOMMENDATIONS

Notes

Requires a MusicMe account (paid subscription for full streaming)
MusicMe is primarily available in France
Uses a dedicated HTTP session to isolate auth cookies from other providers
Streaming tickets are single-use and ephemeral (generated on-demand before each playback)
The dataservice API uses a lightweight XOR cipher for response obfuscation (not encryption)

github-actions · 2026-03-14T15:28:55Z

🔒 Dependency Security Report

✅ No dependency changes detected in this PR.

Copilot

Pull request overview

Adds a new MusicMe provider integration that supports search, browse, recommendations, library radios/playlists, and streaming via ticket-based URLs.

Changes:

Introduces the MusicMe provider implementation (auth, API client/decryption, model parsing, streaming).
Adds provider metadata (manifest) and icons for UI display.
Implements browsing/recommendations surfaces backed by MusicMe dataservice endpoints.

Reviewed changes

Copilot reviewed 2 out of 4 changed files in this pull request and generated 6 comments.

File	Description
music_assistant/providers/musicme/manifest.json	Registers the new MusicMe provider and its metadata.
music_assistant/providers/musicme/icon.svg	Adds MusicMe colored icon asset.
music_assistant/providers/musicme/icon_monochrome.svg	Adds MusicMe monochrome icon asset.
music_assistant/providers/musicme/init.py	Implements the MusicMe provider: login, dataservice calls/decryption, search/browse, library, and streaming.

music_assistant/providers/musicme/__init__.py

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Adds a new MusicMe provider integration to Music Assistant, enabling search/browse/library/recommendations and streaming via MusicMe’s dataservice + ticketed streams.

Changes:

Introduces the MusicMe provider implementation (auth, dataservice API access, item parsing, browsing, recommendations, streaming URLs).
Adds provider manifest metadata and provider icons (standard + monochrome).
Implements a web-search fallback when the dataservice search returns no results.

Reviewed changes

Copilot reviewed 2 out of 4 changed files in this pull request and generated 13 comments.

File	Description
music_assistant/providers/musicme/manifest.json	Registers the new MusicMe provider and its metadata for discovery/configuration.
music_assistant/providers/musicme/init.py	Core provider implementation: login, API calls/decryption, search/browse/library, and streaming ticket URL generation.
music_assistant/providers/musicme/icon.svg	Adds the provider icon asset.
music_assistant/providers/musicme/icon_monochrome.svg	Adds a monochrome icon variant asset.

JulienDeveaux · 2026-03-14T15:47:42Z

music_assistant/providers/musicme/__init__.py

+_CLIENT_JSON = json.dumps(
+    {"type": "desktop-web", "context": "www.musicme.com", "app": "mmplayer"}


the MusicMe dataservice expects literal JSON in the query string. URL-encoding breaks the API.

JulienDeveaux · 2026-03-14T15:48:08Z

music_assistant/providers/musicme/__init__.py

+    def _build_base_params(self) -> str:
+        """Build the common query string for dataservice API calls."""
+        parts = ["format=json", f"partnerid={PARTNER_ID}", f"client={_CLIENT_JSON}"]
+        if self._user_id:
+            parts.append(f"userid={self._user_id}")
+        return "&".join(parts)


the MusicMe dataservice expects literal JSON in the query string. URL-encoding breaks the API.

music_assistant/providers/musicme/__init__.py

+            folder = RecommendationFolder(
+                name="A l'affiche",
+                item_id=f"{self.instance_id}_home",
+                provider=self.instance_id,
+                icon="mdi-star",
+            )


music_assistant/providers/musicme/__init__.py

+        radio = Radio(
+            item_id=radio_id,
+            provider=self.instance_id,
+            name=radio_obj.get("name", "Radio"),
+            provider_mappings={
+                ProviderMapping(
+                    item_id=radio_id,
+                    provider_domain=self.domain,
+                    provider_instance=self.instance_id,
+                )
+            },
+        )


music_assistant/providers/musicme/__init__.py

+        playlist = Playlist(
+            item_id=playlist_id,
+            provider=self.instance_id,
+            name=playlist_obj.get("name", playlist_obj.get("title", "Playlist")),
+            provider_mappings={
+                ProviderMapping(
+                    item_id=playlist_id,
+                    provider_domain=self.domain,
+                    provider_instance=self.instance_id,
+                )
+            },
+        )


music_assistant/providers/musicme/__init__.py

OzGav · 2026-03-15T01:44:06Z

music_assistant/providers/musicme/__init__.py

+
+SUPPORTED_FEATURES = {
+    ProviderFeature.LIBRARY_PLAYLISTS,
+    ProviderFeature.LIBRARY_RADIOS,


This should only be declared if the user creates a curated set of radio stations that are pulled from the provider.

OzGav · 2026-03-15T01:47:08Z

music_assistant/providers/musicme/__init__.py

+        """Handle async initialization of the provider."""
+        if not self.config.get_value(CONF_USERNAME) or not self.config.get_value(CONF_PASSWORD):
+            msg = "Invalid login credentials"
+            raise LoginFailed(msg)


Suggested change

raise LoginFailed(msg)

raise SetupFailedError(msg)

MIssing credentials is not a login failure

OzGav · 2026-03-15T01:48:42Z

music_assistant/providers/musicme/__init__.py

+    def _session(self) -> aiohttp.ClientSession:
+        """Return the provider's dedicated HTTP session."""
+        if self._http_session is None or self._http_session.closed:
+            self._http_session = aiohttp.ClientSession()


Maybe I'm wrong but this seems a bit of a hack to address an error state by restarting a closed session?

OzGav · 2026-03-15T01:49:27Z

music_assistant/providers/musicme/__init__.py

+
+    # ---- search ----
+
+    @use_cache(3600 * 24)


This would mean a user would see the same search results for 24 hours regardless of what they search for

OzGav · 2026-03-15T01:50:58Z

music_assistant/providers/musicme/__init__.py

+
+        if not result.artists and not result.albums and not result.tracks:
+            self.logger.debug("API search empty, trying web search fallback")
+            web_result = await self._web_search_fallback(search_query, media_types, limit)


Why is this needed? What is wrong with the API?

OzGav · 2026-03-15T01:55:05Z

music_assistant/providers/musicme/__init__.py

+
+    # ---- library ----
+
+    async def get_library_radios(self) -> AsyncGenerator[Radio, None]:


Related to LIBRARY_RADIOS. This method is only for when the provider allows the user to create a curated list of stations (for example TuneIn). If the user selects stations to be added to the library from a large list then that is what browse is for. If MusicMe allows user to save a list of favourite stations then all good.

OzGav · 2026-03-15T01:56:08Z

music_assistant/providers/musicme/__init__.py

+        data = await self._api_get(f"/airplay/{prov_radio_id}?resources=tracks")
+        if data and "item" in data:
+            return self._parse_radio(data["item"])
+        async for radio in self.get_library_radios():


Why would this be required and why would you not raise MediaNotFoundError immediately?

OzGav · 2026-03-15T01:57:09Z

music_assistant/providers/musicme/__init__.py

+        if not data:
+            return
+        items: Any = data.get("results", {})
+        if isinstance(items, dict) and "items" in items:


What is going on here. Why dont you know what the API will return?

OzGav · 2026-03-15T01:59:25Z

music_assistant/providers/musicme/__init__.py

+            if art_obj.get("id"):
+                track.artists.append(self._parse_artist(art_obj))
+        if track_obj.get("album"):
+            track.album = self._parse_album(


I think an ItemMapping should be created here as there is no data to populate the album?

OzGav · 2026-03-15T02:01:11Z

music_assistant/providers/musicme/__init__.py

+        url = f"{url}{sep}{self._build_base_params()}"
+
+        self.logger.debug("GET %s", endpoint.split("?")[0])
+        async with self._session.get(url) as response:


There is no error handling here if there is some sort of connection problem?

OzGav · 2026-03-15T02:04:56Z

Also this is very long for one file. We generally like to see the following structure
init.py
constants.py
helpers.py - Put your decrypt function in here
provider.py

and also install and run pre-commit before pushing any changes. Currently this provider has a number of mypy issues.

feat: musicme provider

c901069

Copilot AI review requested due to automatic review settings March 14, 2026 15:27

Copilot started reviewing on behalf of JulienDeveaux March 14, 2026 15:28 View session

Copilot AI reviewed Mar 14, 2026

View reviewed changes

fix: multi instance potential issue

1750e8b

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings March 14, 2026 15:38

Copilot started reviewing on behalf of JulienDeveaux March 14, 2026 15:38 View session

pr review fixes

bf52e12

Copilot AI reviewed Mar 14, 2026

View reviewed changes

pr review fix

4e632dd

OzGav added this to the 2.9.0 milestone Mar 15, 2026

OzGav added the new-provider label Mar 15, 2026

OzGav reviewed Mar 15, 2026

View reviewed changes

		_CLIENT_JSON = json.dumps(
		{"type": "desktop-web", "context": "www.musicme.com", "app": "mmplayer"}


		# ---- library ----

		async def get_library_radios(self) -> AsyncGenerator[Radio, None]:

Uh oh!

Conversation

JulienDeveaux commented Mar 14, 2026

Summary

Features

Supported features

Notes

Uh oh!

github-actions bot commented Mar 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔒 Dependency Security Report

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

OzGav commented Mar 15, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

github-actions bot commented Mar 14, 2026 •

edited

Loading