Swift library for the unofficial Tidal API: login, search, playlists, favorites, artists, albums, mixes, lyrics, and downloads with metadata. It's the library behind the TidalSwift app and the tidal command line tool.
Requires macOS 14 or iOS 17 and Swift 6.2.
Add the package to your Package.swift:
dependencies: [
.package(url: "https://github.com/melgu/TidalSwiftLib", .upToNextMinor(from: "0.1.0"))
],
targets: [
.target(name: "MyApp", dependencies: ["TidalSwiftLib"])
]In Xcode, choose File › Add Package Dependencies… and enter the URL, with the dependency rule "Up to Next Minor Version".
Until 1.0.0, the API is still settling: a new minor version (0.2.0) can contain breaking changes, a new patch version (0.1.1) doesn't.
Session is the entry point. It stores the login in the login Keychain under the service you pass, so give each app its own.
import TidalSwiftLib
let session = Session(config: nil, keychainService: "com.example.MyApp")
if !session.loadSession() {
for await state in session.startAuthorization() {
switch state {
case .waiting:
break
case .pending(let loginUrl, let expiration):
print("Open \(loginUrl) before \(expiration) and approve the login")
case .success:
session.saveConfig()
case .failure(let error):
print("Login failed: \(error)")
}
}
}
if let results = await session.search(for: "Jacob Collier") {
for album in results.albums {
print(album.title)
}
}The library logs with OSLog under the subsystem de.melgu.TidalSwiftLib and never writes to stdout, so command line tools can use stdout for their output.
TidalSwiftLib is licensed under the GNU General Public License v3.0. Apps that use it have to be released under the GPL as well.