MusadoraKit
The ultimate companion to MusicKit.
MusadoraKit is a Swift framework that uses the latest MusicKit and Apple Music API, making it easy to integrate Apple Music into your app. It uses the new async/await pattern introduced in Swift 5.5. Currently, it is available for iOS 15.0+, macOS 12.0+, watchOS 8.0+ and tvOS 15.0+.
It goes well with my book on Exploring MusicKit and Apple Music API, as all the documentation and references are mentioned in the book. Otherwise, the code itself is well documented.
Support
You can support my open-source by buying my book, "Exploring MusicKit and Apple Music API" or by buying me a book!
Catalog
To easily access the Apple Music Catalog, you can use pre-defined methods from MusadoraKit. The method are similar across the music items.
Example of working with fetching a catalog song by its identifier:
let song = try await MusadoraKit.catalogSong(id: "1613834314", with: [.albums])
Example of searching the catalog:
let searchResponse = try await MusadoraKit.catalogSearch(for: "weeknd", types: [Song.self, Artist.self])
print(searchResponse.songs)
print(searchResponse.artists)
Library
While this is natively not available in MusicKit, you can fetch library resources using MusadoraKit that uses Apple Music API under the hood. The method are similar across the music items.
Example of fetching all library songs in alphabetical order:
let songs = try await MusadoraKit.librarySongs()
Example of searching the user's library:
let searchResponse = try await MusadoraKit.librarySearch(for: "hello", types: [Song.self])
print(searchResponse.songs)
Recommendations
You can take advantage of Apple's Music recommendation system and use it in your app. For example, to fetch the default recommendations:
let recommendations = try await MusadoraKit.recommendations()
guard let recommendation = recommendations.first else { return }
print(recommendation.albums)
print(recommendation.playlists)
print(recommendation.stations)
History
You can also fetch historial data from the user's library. For example, to get the recently played resources:
let recentlyPlayedItems = try await MusadoraKit.recentlyPlayed()
let recentlyPlayedAlbums: [Album] = recentlyPlayedItems.compactMap { item in
guard case let .album(album) = item else { return nil }
return album
}
MusicCatalogResourcesRequest:
To fetch multiple catalog music items by their identifiers in the same request. For example:
let request = MusicCatalogResourcesRequest(types: [.songs: ["1456313177"], .albums: ["1531125029", "1575203352"]])
let response = try await request.response()
print(response.songs)
print(response.albums)
MusicLibraryResourcesRequest:
To fetch multiple library music items by their identifiers in the same request. For example:
let request = MusicLibraryResourcesRequest(types: [.songs: ["i.pmzqzM0S2rl5N4L"], .playlists: ["p.PkxVBgps2zOdV3r"]])
let response = try await request.response()
print(response.songs)
print(response.playlists)
I hope you love working with MusadoraKit!
7.6k Jan 6, 2023
250 Dec 27, 2022
1 Jan 21, 2022
0 Jun 16, 2022
1.6k Dec 29, 2022
97 Apr 10, 2021
141 Dec 24, 2022
1 Oct 24, 2021
4 Mar 4, 2022
7 Nov 21, 2022
17 Nov 20, 2022
196 Jan 8, 2023
0 Feb 7, 2022