To download the Watchsend library and get an API key, create an account or sign in .

Getting started

Download the SDK, then add libWatchsend.a and Watchsend.h to your project. Link your binary with libWatchsend.a, CoreGraphics.framework, QuartzCore.framework, SystemConfiguration.framework, OpenGLES.framework, and libicucore.dylib:

Set your API key and connect to the Watchsend server when your app starts:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.

    [Watchsend startWithAPIKey:@"YOUR_API_KEY_HERE"];
    return YES;


Include WatchsendApplication.h:

#include "WatchsendApplication.h"

Change one line in your application's main.m from:

return UIApplicationMain(argc, argv, nil, NSStringFromClass([AppDelegate class]));


return UIApplicationMain(argc, argv, NSStringFromClass([WatchsendApplication class]), NSStringFromClass([AppDelegate class]));

That's it! Watchsend will now record user sessions which you can view from the Watchsend dashboard.


Watchsend will automatically start recording when you start your app and stop when your app quits. You can also manually stop and start recording with [Watchsend finishRecording] and [Watchsend startRecording], respectively.


To help you segment users, organize recordings, and run experiments, Watchsend lets you tag devices and individual recordings. Tags appear in the Watchsend dashboard.

Add a tag to the device at any time:

[Watchsend addTagToCurrentDevice:@"MyApplication v1.0"];
[Watchsend addTagToCurrentDevice:username];

You can also add tags to individual recordings.

[Watchsend addTagToCurrentSession:@"Signup flow"];

Blocking out views

Watchsend lets you block out certain views to prevent recording sensitive information such as credit card numbers and passwords. To prevent a view from appearing in recordings:

[Watchsend occludeView:myView];