Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Adaptr iOS SDK


Swift Package Manager

From Xcode 12, you can use Swift Package Manager to add Adaptr to your project.

  1. Select File > Swift Packages > Add Package Dependency. Enter in the "Choose Package Repository" dialog.
  2. In the next page, specify the version resolving rule as "Up to Next Major" with "0.0.1" as its earliest version.
  3. After Xcode checking out the source and resolving the version, you can choose the "Adaptr" library and add it to your app target.

Getting started

The SDK centers around a singleton instance of this AdaptrAudioPlayer class, which has simple methods to control music playback (play, pause, skip). The AdaptrAudioPlayer holds a list of Station objects (stationList), one of which is always considered the active station (activeStation). Once music playback has begun, there is a current song (currentSong).

Typical initialization and setup is as follows:

As early as you can in your app’s lifecycle (preferably in your AppDelegate or initial ViewController) call

[AdaptrAudioPlayer setclientToken:@"demo" secret:@"demo"]

to asynchronously contact the adaptr servers, validate that the client is in a location that can legally play music, and then retrieve a list of available music stations.

AdaptrAudioPlayer *player = [AdaptrAudioPlayer sharedPlayer];

[player whenAvailable:^{
  NSLog(@"music is available!");
  // .. do something, now that you know music is available

  // set player settings
  player.crossfadeInEnabled = true;
  player.secondsOfCrossfade = 4;
  [player play];

 } notAvailable: ^{
    NSLog(@"music is not available!");
    // .. do something, like leave music button hidden

 // Set Notifications for ex to listen for player events
 [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(stateDidChange:) name:AdaptrAudioPlayerPlaybackStateDidChangeNotification object:player];


Complete AppleDocs can be viewed at