In this article
Content does not enter Music Assistant through one universal import process. A connected provider may synchronize items saved to an account, expose a larger catalogue for search and browsing, or contribute an account’s acquired media. Music Assistant’s Builtin provider offers another route: manually adding a URL or selecting a playlist file.
Apple Music, Audible, and Builtin illustrate these differences. Knowing which route an item followed helps explain why some media appears in the library, some appears only while exploring a provider, and some exists because it was entered manually.
Start with the unified-library model
Music Assistant says it holds no music of its own. A music source is the service or location where supported content lives, such as a streaming service, a folder on a disk or NAS, a media server, or a directory of radio stations, podcasts, or audiobooks (Music Sources).
Music Assistant reads from added sources and combines their content into a unified library. That library can contain artists, albums, tracks, playlists, radio stations, podcasts, and audiobooks while retaining the source associated with each item (Music Sources).
“Unified” does not mean that every provider contributes content in the same way. Nor does connecting a source mean that everything it offers is imported. The amount synchronized from a source, and the synchronization schedule, depend on that source’s settings (Music Sources).
The three providers below demonstrate why it is useful to separate account-library synchronization, catalogue visibility, and manual entry.
Three documented entry paths
| Source | What the provider page documents | How it becomes available | Useful classification |
|---|---|---|---|
| Apple Music | Saved artists, albums, and playlists; a wider catalogue for search and browsing | Sign in to an Apple Music account | Saved account items plus catalogue access |
| Audible | The connected account’s acquired audiobook library | Authenticate the Audible account | Account library |
| Builtin provider | Track and radio URLs; playlist files | Enter a full URL or select a file | Manual database entry |
This is a comparison of three documented examples, not a taxonomy for every Music Assistant provider.
Apple Music: saved items beside a searchable catalogue
The Apple Music provider presents two distinct surfaces. After sign-in, saved artists, albums, and playlists can sit alongside content from the user’s other sources. Separately, the Apple Music catalogue is available for searching and browsing (Apple Music provider).
That distinction changes how to interpret an album on screen. An album among saved account items represents library content supplied through the connected account. An album returned by catalogue search may simply be available for discovery. Its presence in search results does not, by itself, show that it was synchronized from the user’s saved library.
The provider’s feature table lists artists, albums, tracks, playlists, and radio as supported media types. However, the description of saved account content specifically names artists, albums, and playlists (Apple Music provider). The documentation supplied here therefore does not establish a separate saved-track import path.
A paid subscription is required to add the Apple Music source (Apple Music provider). None of these statements establishes catalogue completeness or guarantees that a particular catalogue item will be playable.
Audible: acquired audiobooks from an account library
Audible provides the clearest account-library example. Its documentation says that a title obtained through a monthly credit or direct purchase remains in the account library. Connecting the account places that library inside Music Assistant (Audible provider).
The ownership language applies specifically to those acquired audiobook titles. Although the page lists both audiobooks and podcasts as supported media types, the supplied documentation does not describe podcasts as purchased or credit-acquired account content (Audible provider).
This entry path should not be read as access to Audible’s wider store catalogue. Search functionality and browsing by author, narrator, or series are listed as not yet supported on the provider page (Audible provider). The documented model is consequently narrower than Apple Music’s combination of saved items and catalogue discovery.
The Audible provider also requires a paid subscription (Audible provider). These details describe Audible’s documented behavior, not how every audiobook provider works.
Builtin: URLs and playlist files added manually
The Builtin provider does not depend on importing an external account library. It is added automatically and supports manually adding track and radio-station URLs to Music Assistant’s database (Builtin provider).
For a track or radio station, the documented route is straightforward:
- Open Tracks or Radio from the main menu.
- Select the add control in the upper-right corner.
- Enter the complete URL, including
http://orhttps://. - Optionally supply a custom name and image URL.
After submission, the item becomes available in the corresponding view; the documentation notes that a refresh may be required (Builtin provider).
Playlists take a slightly different route. From Playlists, the user selects the playlist-import control and chooses a playlist file in the dialog (Builtin provider). The page does not specify supported playlist formats or say that importing a file creates an independent library record for every referenced track.
Likewise, accepting a URL is not a guarantee that its format is compatible, that the resource will remain available, or that playback will be reliable. The documentation establishes the entry mechanism, not the outcome for every possible URL.
Linking can combine views, not origins
When the same album exists in multiple sources, Music Assistant tries to link the copies so they can appear as one entry rather than several (Music Sources). This process requires enough identifying metadata from the sources, and the documentation explicitly says linking is not guaranteed (Music Sources).
Linking therefore should not be mistaken for a universal match or import process. Apparently identical albums can remain separate, and a combined entry still represents material associated with its original sources.
When an item appears unexpectedly, use a three-part check: determine whether it was synchronized from a provider account library, merely exposed through catalogue search or browsing, or added as a Builtin URL or playlist file. That diagnostic is more useful than assuming everything visible entered Music Assistant in the same way.
This explanation is based only on the cited documentation; no hands-on test was performed. It does not assess catalogue completeness, matching success, authentication security, playback reliability, or providers beyond these three examples.
Sources and further reading
Documentation retrieved October 20, 2026; the pages did not state product or provider version numbers.
No comments yet