Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Export soundfiles from your own app into the AudioShare app for iPhone, iPad and iPod touch.

AudioShare SDK

This SDK will let you export audio to, or import audio from, the AudioShare app for iPhone, iPad and iPod touch.

AudioShare - audio document manager, is a simple tool to manage all your sounds in a single place on your device, with easy transferring of sounds between AudioShare and other apps or your computer. Read more about it here:


First, copy the files AudioShareSDK.h and AudioShareSDK.m into your project.

Don't forget to import the header:

#import "AudioShareSDK.h"

iOS 9 Support

Since iOS 9, apps must whitelist URL schemes to allow querying them with canOpenURL, which this SDK does.

For your app to work with this SDK on iOS 9, you must add the following entry to your Info.plist:


AudioShare SDK now uses ARC

If your project is not ARC-enabled, you'll need to enable ARC for AudioShareSDK.m:

  1. Select the project in the left-hand Project Navigator tree.

  2. Click on the "Build Phases" tab at the top.

  3. Click on "Compile Sources" category to show the enclosed files.

  4. Select to highlight the AudioShareSDK.m file.

  5. Double-click on the right-hand side of the selected row, under the "Compiler Flags" column.

  6. Type: -fobjc-arc into the field, and press the return key to commit the new compiler flag.

Export to AudioShare

The typical usage is to have a button or menu item labelled "Export to AudioShare" that transfers a soundfile from your own app into AudioShare. Just put the following line in the code that gets called when the user taps the button:

[[AudioShare sharedInstance] addSoundFromPath:thePathToYourFile withName:@"My Sound"];

In case you have your sound in memory, you can send an NSData instead:

[[AudioShare sharedInstance] addSoundFromData:yourSoundData withName:@"My Sound"];

These methods will check that a recent enough version of AudioShare is installed, and otherwise present the user with the option to view the app on the App Store. If AudioShare was installed, it will open AudioShare and import the audio, and return YES if successfull.

Import from AudioShare

Since AudioShare version 2.5, you can also easily import sound from AudioShare into your own app.

  1. First, declare a new URL type in your Info.plist with the scheme yourAppName.audioshare. Replace yourAppName with a unique name for your app, but keep the .audioshare suffix.

  2. Then, in your app delegates openURL handler method, call checkPendingImport:withBlock: to handle the import:

    if([[AudioShare sharedInstance] checkPendingImport:url withBlock:^(NSString *path) {
      // Move the temporary file into our Documents folder
      NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
      NSString *documentsDirectory = [paths objectAtIndex:0];
      NSString *destination = [documentsDirectory stringByAppendingPathComponent:[path lastPathComponent]];
      [[NSFileManager defaultManager] moveItemAtPath:path toPath:destination error:nil];
      // Load the imported file
      [mySoundEngine loadSample:destination];
    }]) {
      return YES;
  3. To initiate the import from your app, add a button named "Import from AudioShare" which simply calls:

    [[AudioShare sharedInstance] initiateSoundImport];

This will launch AudioShare (if version 2.5 or later is installed), which will display an "Import into app: YourAppName" button. When the user taps this button in AudioShare, it will launch your application where the call to checkPendingImport:withBlock: will grab the imported soundfile.


The addSoundFrom* and initiateSoundImport methods should always be called from the main thread. If you need to call it from another thread, you must wrap the call in a block dispatched on the main thread. Example:

    dispatch_async(dispatch_get_main_queue(), ^(void) {
        [[AudioShare sharedInstance] addSoundFromURL:theUrlToYourFile
                                            withName:@"My Sound"];

Supported formats

AudioShare supports all soundfile formats, bit depths and rates, that has built-in support in iOS: AIFF, AIFC, WAVE, SoundDesigner2, Next, MP3, MP2, MP1, AC3, AAC_ADTS, MPEG4, M4A, CAF, 3GP, 3GP2, AMR. Additionally, it supports standard MIDI files.


You are free to incorporate this code in your own application, for the purpose of launching and/or transferring sounds to/from the AudioShare app.

If you do, please drop me a message at so that I can add your app to the list of implementing apps on

Copyright (C)2012-2015 Jonatan Liljedahl

Something went wrong with that request. Please try again.