{"id":21980909,"url":"https://github.com/rryam/musadorakit","last_synced_at":"2025-10-19T11:29:29.973Z","repository":{"id":37254288,"uuid":"392431254","full_name":"rryam/MusadoraKit","owner":"rryam","description":"The ultimate companion to MusicKit.","archived":false,"fork":false,"pushed_at":"2025-09-30T04:15:20.000Z","size":24155,"stargazers_count":408,"open_issues_count":0,"forks_count":30,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-09-30T06:10:25.646Z","etag":null,"topics":["apple-music-api","applemusic","ios","ios-swift","musickit","musickit-ios","swift","swift-library","swift5","swiftpackage"],"latest_commit_sha":null,"homepage":"http://exploringmusickit.com","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rryam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"rryam"}},"created_at":"2021-08-03T19:24:28.000Z","updated_at":"2025-09-30T04:11:29.000Z","dependencies_parsed_at":"2023-02-15T11:15:34.555Z","dependency_job_id":"777e6014-8628-4528-a6fa-d26feabe7b3a","html_url":"https://github.com/rryam/MusadoraKit","commit_stats":{"total_commits":437,"total_committers":4,"mean_commits":109.25,"dds":"0.013729977116704761","last_synced_commit":"5cb3db81cef3afb45fe99c4c35b84166ba6319ea"},"previous_names":[],"tags_count":81,"template":false,"template_full_name":null,"purl":"pkg:github/rryam/MusadoraKit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rryam%2FMusadoraKit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rryam%2FMusadoraKit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rryam%2FMusadoraKit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rryam%2FMusadoraKit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rryam","download_url":"https://codeload.github.com/rryam/MusadoraKit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rryam%2FMusadoraKit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000688,"owners_count":26082850,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple-music-api","applemusic","ios","ios-swift","musickit","musickit-ios","swift","swift-library","swift5","swiftpackage"],"created_at":"2024-11-29T17:14:16.165Z","updated_at":"2025-10-19T11:29:29.965Z","avatar_url":"https://github.com/rryam.png","language":"Swift","funding_links":["https://github.com/sponsors/rryam"],"categories":[],"sub_categories":[],"readme":"# MusadoraKit\n\nMusadoraKit (pronounced 'myu' za' 'do' 'ra') is the ultimate companion to MusicKit. It makes working with MusicKit and Apple Music API much easier, with one-liner API implementations.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src= \"https://github.com/rryam/MusadoraKit/blob/main/MusadoraKitIcon.png\" alt=\"MusadoraKit Logo\" width=\"256\"/\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Swift-6.0+-fa7343?style=flat\u0026logo=swift\u0026logoColor=white\" alt=\"Swift 6.0+\"\u003e\n  \u003cbr\u003e\n  \u003cimg src=\"https://img.shields.io/badge/iOS-15.0+-000000?style=flat\u0026logo=apple\u0026logoColor=white\" alt=\"iOS 15.0+\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/macOS-12.0+-000000?style=flat\u0026logo=apple\u0026logoColor=white\" alt=\"macOS 12.0+\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/watchOS-8.0+-000000?style=flat\u0026logo=apple\u0026logoColor=white\" alt=\"watchOS 8.0+\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/tvOS-15.0+-000000?style=flat\u0026logo=apple\u0026logoColor=white\" alt=\"tvOS 15.0+\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/visionOS-1.0+-000000?style=flat\u0026logo=apple\u0026logoColor=white\" alt=\"visionOS 1.0+\"\u003e\n\u003c/p\u003e\n\n## Exploring MusicKit and Apple Music API Book\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://academy.rudrank.com/product/musickit\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Book-Exploring%20MusicKit%20%26%20Apple%20Music%20API-blue?style=for-the-badge\u0026logo=book\u0026logoColor=white\" alt=\"Exploring MusicKit and Apple Music API Book\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\nI have written a book on MusicKit and Apple Music API, [\"Exploring MusicKit and Apple Music API\"](https://academy.rudrank.com/product/musickit).\n\nIt has all the documentation and references you need to get started with MusicKit and Apple Music API.\n\n## Installation\n\nSwift Package Manager handles the distribution of Swift code and comes built into the Swift compiler.\n\nTo add MusadoraKit to your project, simply include it in your `Package.swift` file:\n\n```swift\ndependencies: [\n    .package(url: \"https://github.com/rryam/MusadoraKit.git\", .upToNextMajor(from: \"7.5.1\"))\n]\n```\n\n## Quick Start\n\nGet up and running with MusadoraKit in minutes. Here is an example of searching for music:\n\n```swift\nimport MusadoraKit\n\nTask {\n    do {\n        let searchResponse = try await MCatalog.search(for: \"The Weeknd\", types: [.songs], limit: 5)\n        print(\"Found \\(searchResponse.songs.count) songs!\")\n    } catch {\n        print(\"Search failed: \\(error)\")\n    }\n}\n```\n\n## Sponsors\n\n\u003cp align=\"leading\"\u003e\n  \u003cimg src= \"https://is3-ssl.mzstatic.com/image/thumb/Purple116/v4/cd/40/fe/cd40fe7c-b0f8-30aa-0b41-4a76e7968766/AppIcon-1x_U007emarketing-0-0-0-10-0-0-85-220.png/246x0w.webp\" alt=\"PlaylistAI Logo\" width=\"64\"/\u003e\n\u003c/p\u003e\n\n[PlaylistAI](https://twitter.com/playlist_ai) by [Brett Bauman](https://twitter.com/brettunhandled)\n\n## [Documentation using DocC](https://rryam.github.io/MusadoraKit/documentation/musadorakit/musadorakit/)\n\n## Musadora Sample App\nI have open-sourced an app I worked on last year called Musadora. (MusadoraKit started as RRMusicKit for the Musadora app!) \n\nI am slowly adding all the methods used in MusadoraKit to it, so you can refer to how easy it is to use the pkage.\n\n## Apps Using MusadoraKit\n\n- [Music Mate](https://apps.apple.com/app/musicmate-music-map-friends/id1605379758): Meet music friends on the world map.\n- [Sonar](https://apps.apple.com/ca/app/sonar-music-community/id1626147292): Music \u0026 Community. Stream, Share \u0026 Discover\n- [Tuneder](https://apps.apple.com/us/app/tuneder-song-discovery/id6450867856?itsct=apps_box_badge\u0026itscg=30200): An [open-source](https://github.com/adityasaravana/Tuneder) iOS app that helps Apple Music users discover new songs with a Tinder-like UI.\n- Musadora: Apple Music client focused on playlists\n- Musadora Labs: A companion app to explore MusicKit\n- Euphonic: Apple Music client focused on recommendations\n- [bijou.fm](https://apps.apple.com/app/bijou-fm/id6450460066?platform=iphone): Last.fm client with Apple Music integration\n\n## Table of Contents\n\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Quick Start](#quick-start)\n- [Start Working with MusicKit](#start-working-with-musickit)\n  - [Step 1: Enable MusicKit for Your Bundle Identifier](#step-1-enable-musickit-for-your-bundle-identifier)\n  - [Step 2: Add NSAppleMusicUsageDescription to Info.plist](#step-2-add-nsapplemusicusagedescription-to-infoplist)\n  - [Step 3: Request Authorization for Apple Music](#step-3-request-authorization-for-apple-music)\n- [Testing Connectivity](#testing-connectivity)\n- [Core APIs](#core-apis)\n  - [Catalog](#catalog)\n  - [Searching the Catalog](#searching-the-catalog)\n  - [Library](#library)\n  - [Recommendations](#recommendations)\n  - [History](#history)\n- [Enhanced Features](#enhanced-features)\n  - [Music Player](#music-player)\n  - [Music Summaries (Replay)](#music-summaries-replay)\n  - [Ratings](#ratings)\n  - [100 Best Albums](#100-best-albums)\n  - [Favorites](#favorites)\n- [Advanced Features](#advanced-features)\n  - [Storefronts](#storefronts)\n  - [Referencing content across different geographical regions](#referencing-content-across-different-geographical-regions)\n  - [Explicit to clean-equivalent content](#explicit-to-clean-equivalent-content)\n  - [MusicCatalogResourcesRequest](#musiccatalogresourcesrequest)\n  - [MusicLibraryResourcesRequest](#musiclibraryresourcesrequest)\n  - [Animated Artwork View](#animated-artwork-view)\n- [Contributing](#contributing)\n- [License](#license)\n- [Support](#support)\n\n## Start Working with MusicKit \nFollow the steps below to setup MusicKit for your app:\n\n### Step 1: Enable MusicKit for Your Bundle Identifier\n1. Visit the [Apple Developer Portal](https://developer.apple.com/account).\n2. Navigate to `Certificates, Identifiers \u0026 Profiles`.\n3. Select `Identifiers` from the left panel.\n4. Find your App's Bundle Identifier from the list and select it.\n5. Under `Services`, ensure `MusicKit` is enabled. If not, enable it.\n\n### Step 2: Add `NSAppleMusicUsageDescription` to `Info.plist`\nTo inform the user why your app requires access to their media library, add `NSAppleMusicUsageDescription` to your `Info.plist` file.\n1. Open your project in Xcode.\n2. Select `Info.plist` from the Project Navigator.\n3. Click on the `+` button to add a new key.\n4. Add `NSAppleMusicUsageDescription` as a key.\n5. Set its value to the reason why your app needs access to Apple Music, e.g., `Our app uses Music access to play music and create a pleasant experience.`.\n\n### Step 3: Request Authorization for Apple Music\nBefore your app can interact with Apple Music, it needs to request the user's authorization. This can be done using `MusicAuthorization.request()`. \n\nHere's a Swift code example:\n\n```swift\nimport MusicKit\nimport Observation\n\n@Observable\nclass MusicAuthorizationManager {\n    var isAuthorizedForMusicKit = false\n    var musicKitError: MusicKitError?\n\n    func requestMusicAuthorization() async {\n        let status = await MusicAuthorization.request()\n\n        switch status {\n        case .authorized:\n            isAuthorizedForMusicKit = true\n        case .restricted:\n            musicKitError = .restricted\n        case .notDetermined:\n            musicKitError = .notDetermined\n        case .denied:\n            musicKitError = .denied\n        @unknown default:\n            musicKitError = .notDetermined\n        }\n    }\n}\n```\n\nThis `MusicAuthorizationManager` class checks the authorization status for MusicKit. If the user grants authorization, `isAuthorizedForMusicKit` is set to `true`. If access is denied or restricted, or if the status is not determined, an appropriate `MusicKitError` is set.\n\nRemember to call `requestMusicAuthorization()` at an appropriate time in your application flow to request the user's authorization.\n\n## Testing Connectivity\n\nTest your Apple Music API setup and developer token validity with a simple connectivity check.\n\n### Basic connectivity test:\n\n```swift\nTask {\n    do {\n        try await MusadoraKit.testConnectivity()\n        print(\"Successfully connected to Apple Music API!\")\n    } catch {\n        print(\"Failed to connect: \\(error.localizedDescription)\")\n\n        // Check for specific error types\n        if let urlError = error as? URLError {\n            switch urlError.code {\n            case .userAuthenticationRequired:\n                print(\"Issue with developer token or MusicKit setup\")\n            case .badServerResponse:\n                print(\"Server error - check your configuration\")\n            default:\n                print(\"Network or other error\")\n            }\n        }\n    }\n}\n```\n\nThis method performs a GET request to Apple's test endpoint and validates:\n- Developer token is valid\n- MusicKit capabilities are properly configured\n- Network connectivity to Apple Music API\n- Basic API communication works\n\n## Catalog \n\nTo easily access the Apple Music Catalog, you can use pre-defined methods from MusadoraKit. The methods are similar across the music items. \n\nExample of working with fetching a catalog song by its identifier: \n\n```swift \nlet song = try await MCatalog.song(id: \"1613834314\", with: [.albums])\n```\n\n## Searching the Catalog\n\nExample of searching the catalog: \n\n```swift \nlet searchResponse = try await MCatalog.search(for: \"the weeknd\", types: [.songs, .stations, .albums, .playlists, .artists], limit: 10)\n\nprint(searchResponse.songs)\nprint(searchResponse.artists)\n```\n\n## Library \n\nWhile this is natively not available in MusicKit for iOS 15, you can fetch library resources using MusadoraKit that uses Apple Music API under the hood. The methods are similar across the music items.\n\nExample of fetching all library songs in alphabetical order: \n\n```swift \nlet songs = try await MLibrary.songs()\n```\n\nExample of searching the user's library: \n\n```swift \nlet searchResponse = try await MLibrary.search(for: \"hello\", types: [Song.self])\n\nprint(searchResponse.songs)\n```\n\n## Recommendations \n\nYou can take advantage of Apple's Music recommendation system and use it in your app. For example, to fetch the default recommendations: \n\n```swift \nlet recommendations = try await MRecommendation.default()\n\nguard let recommendation = recommendations.first else { return }\n\nprint(recommendation.albums)\nprint(recommendation.playlists)\nprint(recommendation.stations)\n```\n\n## History\n\nYou can also fetch historial data from the user's library. For example, to get the recently played resources:\n\n```swift\nlet recentlyPlayedItems = try await MLibrary.recentlyPlayed()\n\nlet recentlyPlayedAlbums = try await MLibrary.recentlyPlayedAlbums()\n}\n```\n\n## Music Player\n\nConvenient extensions for Apple's ApplicationMusicPlayer to easily play songs, albums, playlists, and stations with simple one-liner methods.\n\n### Play songs and albums:\n\n```swift\n// Play a single song\ntry await player.play(song: song)\n\n// Play multiple songs\ntry await player.play(songs: songs)\n\n// Play an album\ntry await player.play(album: album)\n\n// Play a playlist\ntry await player.play(playlist: playlist)\n```\n\n### Play with position control:\n\n```swift\n// Insert and play a song at a specific position in queue\ntry await player.play(song: song, at: .afterCurrentEntry)\n\n// Play a personalized recommendation item\ntry await player.play(item: musicPersonalRecommendation)\n```\n\n### Play stations and music videos:\n\n```swift\n// Play a radio station\ntry await player.play(station: station)\n\n// Play a music video (available on iOS 16+, tvOS 16+)\ntry await player.play(musicVideo: musicVideo)\n```\n\n## Music Summaries (Replay)\n\nYou can also fetch your users' Apple Music Replay data. It includes the latest yearly summary as well as the most recent monthly summary (previous calendar month). Both return their top artists, albums, and songs in one request.\n\n### Fetch complete summary:\n\n```swift\nlet summary = try await MSummary.latest()\n\nprint(summary.topArtists)\nprint(summary.topAlbums)\nprint(summary.topSongs)\n```\n\n### Fetch latest monthly summary:\n\n```swift\nlet monthlySummary = try await MSummary.latestMonth()\n\nprint(monthlySummary.topArtists)\nprint(monthlySummary.topAlbums)\nprint(monthlySummary.topSongs)\n```\n\n### Fetch specific categories:\n\n```swift\n// Get only top artists\nlet topArtists = try await MSummary.latestTopArtists()\n\n// Get only top albums\nlet topAlbums = try await MSummary.latestTopAlbums()\n\n// Get only top songs\nlet topSongs = try await MSummary.latestTopSongs()\n\n// Monthly variants\nlet monthlyTopArtists = try await MSummary.latestMonthTopArtists()\nlet monthlyTopAlbums = try await MSummary.latestMonthTopAlbums()\nlet monthlyTopSongs = try await MSummary.latestMonthTopSongs()\n```\n\n### Customize with specific views:\n\n```swift\n// Get only top artists and albums (skip songs)\nlet summary = try await MSummary.latest(views: [.topArtists, .topAlbums])\n```\n\n## Ratings\n\nAdd, retrieve, and manage ratings for your users' favorite Apple Music content. Support for songs, albums, playlists, music videos, and stations.\n\n### Add ratings:\n\n```swift\n// Rate a song as \"liked\"\nlet rating = try await MCatalog.addRating(for: song, rating: .like)\n\n// Rate an album as \"disliked\"\nlet rating = try await MCatalog.addRating(for: album, rating: .dislike)\n\n// Rate a playlist\nlet rating = try await MCatalog.addRating(for: playlist, rating: .love)\n```\n\n### Get current ratings:\n\n```swift\n// Get rating for a song\nlet rating = try await MCatalog.rating(for: song)\n\n// Get rating for an album\nlet rating = try await MCatalog.rating(for: album)\n```\n\n### Remove ratings:\n\n```swift\n// Remove rating from a song\ntry await MCatalog.deleteRating(for: song)\n\n// Remove rating from a playlist\ntry await MCatalog.deleteRating(for: playlist)\n```\n\n### Available rating types:\n- `.like` - Like content\n- `.dislike` - Dislike content\n- `.love` - Love content (hearted)\n\n## 100 Best Albums\n\nAccess Apple's curated collection of the 100 Best Albums of all time. Get individual albums by position or fetch the entire collection.\n\n### Get a specific album:\n\n```swift\n// Get the #1 album\nlet album = try await MRecommendation.hundredBestAlbum(at: 1)\nprint(\"Top album: \\(album.title) by \\(album.artistName)\")\n```\n\n### Get all 100 albums:\n\n```swift\n// Get the complete collection\nlet allAlbums = try await MRecommendation.allHundredBestAlbums()\n\nfor album in allAlbums {\n    print(\"\\(album.title) - \\(album.artistName)\")\n}\n```\n\n### With custom storefront:\n\n```swift\n// Get albums for a specific region\nlet albums = try await MRecommendation.allHundredBestAlbums(storefront: \"gb\")\n```\n\n## Favorites\n\nAdd songs, albums, playlists, artists, music videos, and stations to your users' Apple Music favorites.\n\n### Add to favorites:\n\n```swift\n// Favorite a song\nlet success = try await MCatalog.favorite(song: song)\n\n// Favorite an album\nlet success = try await MCatalog.favorite(album: album)\n\n// Favorite a playlist\nlet success = try await MCatalog.favorite(playlist: playlist)\n\n// Favorite an artist\nlet success = try await MCatalog.favorite(artist: artist)\n```\n\n### Favorite a music video:\n\n```swift\nlet success = try await MCatalog.favorite(musicVideo: musicVideo)\n```\n\n### Favorite a station:\n\n```swift\nlet success = try await MCatalog.favorite(station: station)\n```\n\n## Storefronts\n\nAccess Apple Music storefront information and manage regional content availability.\n\n### Get all available storefronts:\n\n```swift\nlet storefronts = try await MCatalog.storefronts()\n\nfor storefront in storefronts {\n    print(\"\\(storefront.name) (\\(storefront.id))\")\n}\n```\n\n### Get a specific storefront:\n\n```swift\nlet usStorefront = try await MCatalog.storefront(id: \"us\")\nprint(\"US Storefront: \\(usStorefront.name)\")\n```\n\n### Determine the active storefront:\n\nMusicKit exposes the active storefront through `MusicKit.Storefront.current`. Once obtained, you can feed its identifier into MusadoraKit helpers, for example:\n\n```swift\nlet storefront = try await Storefront.current\nlet storefrontDetails = try await MCatalog.storefront(id: storefront.id)\nprint(\"Current region: \\(storefrontDetails.id)\")\n```\n\n## Referencing content across different geographical regions\n\nIn the example below, the target storefront is \"jp\" for Japan:\n\n```swift\nlet album = MCatalog.album(id: \"1223618217\")\nlet equivalentAlbum = try await album.equivalent(for: \"jp\")\n\nlet albums = MCatalog.albums(ids: [\"1223618217\", \"1603171516\"])\nlet equivalentAlbums = try await albums.equivalents(for: \"jp\")\n```\n\n## Explicit to clean-equivalent content:\n\n```swift\nlet song = MCatalog.song(id: \"1603171970\")\nlet cleanSong = try await song.clean\n\nlet songs = MCatalog.songs(ids: [\"1603171970\", \"1531327246\"])\nlet cleanSongs = try await songs.clean\n```\n\n## MusicCatalogResourcesRequest: \n\nTo fetch multiple catalog music items by their identifiers in the same request. For example:\n\n```swift \nlet request = MusicCatalogResourcesRequest(types: [.songs: [\"1456313177\"], .albums: [\"1531125029\", \"1575203352\"]])\nlet response = try await request.response()\n\nprint(response.songs)\nprint(response.albums)\n```\n\n## MusicLibraryResourcesRequest:\n\nTo fetch multiple library music items by their identifiers in the same request. For example:\n\n```swift\nlet request = MusicLibraryResourcesRequest(types: [.songs: [\"i.pmzqzM0S2rl5N4L\"], .playlists: [\"p.PkxVBgps2zOdV3r\"]])\nlet response = try await request.response()\n\nprint(response.songs)\nprint(response.playlists)\n```\n\n## Animated Artwork View\n\nCreate stunning animated backgrounds from music artwork with dynamic mesh gradients. Available on iOS 18, macOS 15, watchOS 11, tvOS 18, and visionOS 2 or later.\n\n### Basic usage:\n\n```swift\nstruct ContentView: View {\n    @ObservedObject private var queue = ApplicationMusicPlayer.shared.queue\n\n    var body: some View {\n        AnimatedArtworkView(queue: queue)\n            .ignoresSafeArea()\n    }\n}\n```\n\n### With custom artwork:\n\n```swift\nAnimatedArtworkView(\n    queue: ApplicationMusicPlayer.shared.queue,\n    artwork: customArtwork,\n    width: 400,\n    height: 400\n)\n```\n\n### Custom gradient points:\n\n```swift\nlet customPoints: [SIMD2\u003cFloat\u003e] = [\n    SIMD2\u003cFloat\u003e(0.0, 0.0), SIMD2\u003cFloat\u003e(0.5, 0.0), SIMD2\u003cFloat\u003e(1.0, 0.0),\n    SIMD2\u003cFloat\u003e(0.0, 0.5), SIMD2\u003cFloat\u003e(0.8, 0.2), SIMD2\u003cFloat\u003e(0.2, 0.8),\n    SIMD2\u003cFloat\u003e(1.0, 0.5), SIMD2\u003cFloat\u003e(0.0, 1.0), SIMD2\u003cFloat\u003e(0.5, 1.0),\n    SIMD2\u003cFloat\u003e(1.0, 1.0), SIMD2\u003cFloat\u003e(0.3, 0.7), SIMD2\u003cFloat\u003e(0.7, 0.3),\n    SIMD2\u003cFloat\u003e(0.1, 0.9), SIMD2\u003cFloat\u003e(0.9, 0.1), SIMD2\u003cFloat\u003e(0.4, 0.6),\n    SIMD2\u003cFloat\u003e(0.6, 0.4)\n]\n\nAnimatedArtworkView(\n    queue: queue,\n    points: customPoints\n)\n```\n\nThis view automatically extracts dominant colors from the current playing song's artwork and creates a beautiful animated mesh gradient background that responds to the music.\n\n## Contributing\n\nI welcome contributions to MusadoraKit! Here is how you can help:\n\n1. **Fork the repository** and create a feature branch\n2. **Make your changes** following the existing code style\n3. **Add tests** for new functionality\n4. **Update documentation** as needed\n5. **Submit a pull request** with a clear description\n\n### Development Setup\n\n1. Clone the repository\n2. Open `Package.swift` in Xcode or VS Code forks or CLIs\n3. Run tests to ensure everything works\n4. Make your changes and test them\n\n### Code Style\n\n- Follow SwiftLint rules (run `swiftlint lint`)\n- Use Swift 6.2+ features where appropriate\n- Maintain backward compatibility when possible\n- Document public APIs with DocC comments\n\n## License\n\nMusadoraKit is available under the MIT license. See [LICENSE](LICENSE) for more information.\n\n## Support\n\n- [Documentation](https://rryam.github.io/MusadoraKit/)\n- [Issues](https://github.com/rryam/MusadoraKit/issues)\n- [Discussions](https://github.com/rryam/MusadoraKit/discussions)\n- [Twitter](https://x.com/rudrankriyam)\n\nI hope you love working with MusadoraKit!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frryam%2Fmusadorakit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frryam%2Fmusadorakit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frryam%2Fmusadorakit/lists"}