Version 2.10.0

New in this release

• Referencing content across different geographical regions. In the example below, the target storefront is "tw" for Taiwan:

let album = MCatalog.album(id: "1223618217")
let equivalentAlbum = try await album.equivalent(for: "tw")

let albums = MCatalog.albums(ids: ["1223618217", "1603171516"])
let equivalentAlbums = try await albums.equivalents(for: "tw")

• Map explicit to clean-equivalent content:

let song = MCatalog.song(id: "1603171970")
let cleanSong = try await song.clean

let songs = MCatalog.songs(ids: ["1603171970", "1531327246"])
let cleanSongs = try await songs.clean

Version 2.9.0

New in this release - BREAKING RELEASE 🚨

• Replaced MLibrary with MHistory for recently added and played methods.
• Added MDataRequest for custom data request with custom developer token.

Version 2.8.0

New in this release

You don't have to import MusicKit now

I have updated the sample project Musadora with a lot of changes, making it the best MusicKit and Apple Music API sample app.

Version 2.7.1

New in this release

Added more methods to APlayer and SPlayer to make it easy to work with the music player.

Directly use APlayer.shared.play(station: station) or SPlayer.shared.play(item: item) where item is the music recommendation item (consisting of either album, playlist, or station).

Version 2.7.0

New in this release

New methods on station genres and personal station

Version 2.6.0

New in this release

• Added the allGenres method to MCatalog to get all genres from Apple Music across all Apple Music storefronts.

• Added storefronts method to MCatalog to get all the Apple Music storefronts.

Version 2.5.1

New in this Release

Update the library methods for watchOS 9, tvOS 16 and iOS 16.

Version 2.5.0

New in this Release

• Updated library methods to be the same as catalog ones.
• Added APlayer and SPlayer for easier access to the music players.
• Update search and search suggestions with an option to just say the type as .all.

Version 2.4.0

New in this release

Added a method for fetching Apple stations:

MCatalog.appleStations()

Version 2.3.0

New in Version 2.3.0

Added the new chart and global playlists that Apple Music API added in version 1.2!

Example usage:

Fetch the charting playlists from the Apple Music catalog for the particular storefront. In the following example, the method fetches the charting playlists in India:

let playlists = try await MCatalog.chartPlaylists(storefront: "IN")

If no storefront is provided, the method retrieves the charting playlists for the current user's storefront.

let playlists = try await MCatalog.chartPlaylists()

Fetch all the charting playlists from the Apple Music catalog for all the storefronts. In the following example, the method fetches the charting playlists globally:

let playlists = try await MCatalog.globalChartPlaylists()