ScrobbleKit is a modern Swift library designed to simplify interactions with the Last.fm API on Apple platforms. It provides a clean, async/await-based interface for seamless integration with your Swift apps.
To begin using ScrobbleKit, you'll need to create an instance of SBKManager by providing your API and Secret key from Last.fm.
import ScrobbleKit
let manager = SBKManager(apiKey: "YOUR_API_KEY", secret: "YOUR_SECRET_KEY")ScrobbleKit supports async/await for all API methods. Here's an example of how to fetch album information:
do {
let album = try await manager.getInfo(forAlbum: .albumArtist(album: "Random Access Memories",
artist: "Daft Punk"))
print("Album name: \(album.name)")
print("Artist: \(album.artist)")
print("Tracks: \(album.tracklist.count)")
} catch {
print("Error fetching album info: \(error)")
}For methods requiring authentication, you'll need to start a session:
do {
let session = try await manager.startSession(username: "YOUR_USERNAME", password: "YOUR_PASSWORD")
print("Authenticated as: \(session.name)")
} catch {
print("Authentication failed: \(error)")
}For detailed information on all available API methods and models, check out the full documentation.
- iOS 13.0+
- macOS 10.15+
- watchOS 6.0+
- tvOS 13.0+
- Swift 5.5+
Add the following to your Package.swift file:
dependencies: [
.package(url: "https://github.com/tfmart/ScrobbleKit.git", from: "0.1.0")
]Or add it directly in Xcode using File > Add Packages > Search or Enter Package URL.
Contributions to ScrobbleKit are welcome! Please feel free to submit a Pull Request or to open an Issue.
ScrobbleKit is available under the MIT license. See the LICENSE file for more info.