IPhone URL Schemes

From akosma wiki

This page centralizes code samples for URL schemes available in many iPhone applications, not only in Apple's but in many others. It also includes programming tips and references about implementing apps registering or consuming URL schemes.

If you own an iPhone app, feel free to edit this page to add the schemes you've implemented in your application, for others to use. The important thing is to showcase code samples, ready for others to use.

Contents 1 Programming Tips 1.1 Registering your own URL schemes 1.2 Note about URL Encoding in Objective-C 2 Apple iPhone Applications 2.1 Safari 2.2 Maps 2.3 Phone 2.4 SMS 2.5 Mail 2.6 YouTube 2.7 iTunes 2.8 App Store 2.9 iBooks 3 Third Party Applications 3.1 AirSharing 3.2 Alocola 3.3 Appigo Notebook 3.4 Appigo Todo 3.5 Duo 3.6 ChatCo 3.7 Credit Card Terminal 3.8 Darkslide (formerly Exposure) 3.9 Echofon / Echofon Pro (formerly Twitterfon / Twitterfon Pro) 3.10 Eureka 3.11 Facebook 3.12 Geocaching Buddy ( GCBuddy ) 3.13 Geopher Lite 3.14 Google Earth 3.15 iTranslate ~ the universal translator 3.16 Loan Plan - Amortization Calculator 3.17 Navigon 3.18 Notitas 3.19 pic2shop 3.20 Portscan 3.21 Round Tuit 3.22 Ships² Viewer 3.23 Site Check 3.24 TimeLog 3.25 Tweetie 3.26 Twinkle 3.27 Twittelator Pro 3.28 Twitterriffic / Twitterriffic Premium 3.29 Unfragment 3.30 Wikiamo 3.31 Yummy 3.32 Swiss Phone Book by local.ch (from version 1.5) 3.33 Seesmic

Programming Tips

Registering your own URL schemes

Please check this page in iPhone Developer Tips.

Note about URL Encoding in Objective-C

There can be some problems with NSString's stringByAddingPercentEscapesUsingEncoding: method since it does not encode some reserved characters for URLs; you might prefer to use this code instead:

CFStringRef encoded = CFURLCreateStringByAddingPercentEscapes(kCFAllocatorDefault, 
                                                              (CFStringRef)textToEncode,
                                                              NULL, 
                                                              (CFStringRef)@";/?:@&=+$,", 
                                                              kCFStringEncodingUTF8);

The Core Foundation CFURLCreateStringByAddingPercentEscapes() function provides more options and is more suitable for complex texts.

Similarly, if you want to remove the URL encoding from a string, for example in the application:handleOpenURL: UIApplicationDelegate method, use this code:

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url 
{
    NSString *query = [url query];
    CFStringRef clean = CFURLCreateStringByReplacingPercentEscapes(kCFAllocatorDefault, 
                                                                   (CFStringRef)query, 
                                                                   CFSTR(""));

    [controller doSomething:(NSString *)clean];
    CFRelease(clean);
}

Apple iPhone Applications

Safari

Any URL starting with http:// which does not point to maps.google.com or www.youtube.com is sent to Safari:

NSString *stringURL = @"http://wiki.akosma.com/";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Apparently feed:// opens http://reader.mac.com in Safari.

Maps

URLs starting with http://maps.google.com open up the "Maps" application automatically:

NSString *title = @"title";
float latitude = 35.4634;
float longitude = 9.43425;
int zoom = 13;
NSString *stringURL = [NSString stringWithFormat:@"http://maps.google.com/maps?q=%@@%1.6f,%1.6f&z=%d", title, latitude, longitude, zoom];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

It seems that maps:// also opens up the Maps application.

Phone

The phone links start with "tel:" but must not contain spaces or brackets (it can contain dashes and "+" signs, though):

NSMutableString *phone = [[@"+ 12 34 567 89 01" mutableCopy] autorelease];
[phone replaceOccurrencesOfString:@" " 
                       withString:@"" 
                          options:NSLiteralSearch 
                            range:NSMakeRange(0, [phone length])];
[phone replaceOccurrencesOfString:@"(" 
                       withString:@"" 
                          options:NSLiteralSearch 
                            range:NSMakeRange(0, [phone length])];
[phone replaceOccurrencesOfString:@")" 
                       withString:@"" 
                          options:NSLiteralSearch 
                            range:NSMakeRange(0, [phone length])];
NSURL *url = [NSURL URLWithString:[NSString stringWithFormat:@"tel:%@", phone]];
[[UIApplication sharedApplication] openURL:url];

SMS

To open the SMS application, just use the sms: protocol in your URL:

NSString *stringURL = @"sms:";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

You can specify a phone number, but apparently not a default text for your message:

NSString *stringURL = @"sms:+12345678901";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

The same restrictions apply as for phone URLs, regarding spaces, brackets and dashes.

Mail

These URLs launch Mail and open the compose message controller:

NSString *stringURL = @"mailto:test@example.com";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

You can also provide more information, for a customized subject and body texts:

NSString *subject = @"Message subject";
NSString *body = @"Message body";
NSString *address = @"test1@akosma.com";
NSString *cc = @"test2@akosma.com";
NSString *path = [NSString stringWithFormat:@"mailto:%@?cc=%@&subject=%@&body=%@", address, cc, subject, body];
NSURL *url = [NSURL URLWithString:[path stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding]];
[[UIApplication sharedApplication] openURL:url];

You might also omit some information:

NSString *subject = @"Message subject";
NSString *path = [NSString stringWithFormat:@"mailto:?subject=%@", subject];
NSURL *url = [NSURL URLWithString:[path stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding]];
[[UIApplication sharedApplication] openURL:url];

For more complex body texts, you might want to use the CFURLCreateStringByAddingPercentEscapes() function, as explained above in this page.

YouTube

URLs starting with http://www.youtube.com open up the "YouTube" application automatically:

NSString *stringURL = @"http://www.youtube.com/watch?v=WZH30T99MaM";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

It also works with this URL (which normally brings the Flash video player used by YouTube):

NSString *stringURL = @"http://www.youtube.com/v/WZH30T99MaM";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

iTunes

To open up iTunes, use this URL:

NSString *stringURL = @"http://phobos.apple.com/WebObjects/MZStore.woa/wa/viewAlbum?i=156093464&id=156093462&s=143441";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

App Store

Very similar to the iTunes URLs:

NSString *stringURL = @"http://itunes.apple.com/WebObjects/MZStore.woa/wa/viewSoftware?id=294409923&mt=8";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

iBooks

(source: http://akos.ma/aqdr)

NSString *stringURL = @"itms-books:";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

NSString *stringURL = @"itms-bookss:";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Third Party Applications

Most URL schemes in this list come from App Lookup.

AirSharing

Launch the application:

NSString *stringURL = @"airsharing://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Alocola

Launch the application:

NSString *stringURL = @"alocola://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Appigo Notebook

Launch the application:

NSString *stringURL = @"appigonotebook://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Appigo Todo

Launch the application:

NSString *stringURL = @"appigotodo://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Create a new task:

NSString *template = @"appigotodo://com.example.xyzapp/import?name=%@&note=%@&due-date=%@&priority=%@&repeat=%@";
NSString *name = @"Buy%20some%20milk";
NSString *note = @"Stop%20on%20the%20way%20home%20from%20work.";
NSString *dueDate = @"2009-07-16";
NSString *priority = @"1";
NSString *repeat = @"101";
NSString *stringURL = [NSString stringWithFormat:template, name, note, dueDate, priority, repeat];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Duo

Launch the application and pre-populate the update field with your desired Tweet/Facebook update. Optional: Provide Duo with the custom URL and return path to your app to provide the user with a button to return to your app.

NSString *appID = @"Your Apps Name";
NSString *updateInfo = @"The Tweet/Status Update";
NSString *returnScheme = @"Your Apps Return URL Scheme";
NSString *returnPath = @"Your/Apps/Return/Path";
NSString *baseURL = @"duoxx://updateFaceTwit?";
	
NSString *encodedUpdateInfo = [updateInfo stringByAddingPercentEscapesUsingEncoding:NSASCIIStringEncoding];
NSString *urlString = [NSString stringWithFormat:@"%@BLappID=%@;BLupdateInfo=%@;BLreturnScheme=%@;BLreturnPath=%@", 
						   baseURL, appID, encodedUpdateInfo, returnScheme, returnPath];

NSURL *url = [NSURL URLWithString:urlString];
[[UIApplication sharedApplication] openURL:url];

ChatCo

NSString *stringURL = @"irc://irc.example.domain/roomName";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

NSString *stringURL = @"irc://irc.example.domain/Nickname@roomName";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

NSString *stringURL = @"irc://irc.example.domain/Nickname!Realname@roomName";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Credit Card Terminal

Launch the application:

NSString *stringURL = @"com-innerfence-ccterminal://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Darkslide (formerly Exposure)

To launch the application:

NSString *stringURL = @"exposure://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Echofon / Echofon Pro (formerly Twitterfon / Twitterfon Pro)

(Source)

NSString *message = @"http://test.com/";
NSString *stringURL = [NSString stringWithFormat:@"twitterfon:///post?%@", message];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

NSString *message = @"http://test.com/";
NSString *stringURL = [NSString stringWithFormat:@"twitterfonpro:///post/username?%@", message];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

The "post" parameter in the URL only works for simple URLs; if you want to post URL-encoded text, try the following:

NSString *message = @"hello%20from%20TwitterFon!";
NSString *stringURL = [NSString stringWithFormat:@"twitterfonpro:///message?%@", message];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Eureka

Substitute eureka for http e.g. eureka://en.wikipedia.org/wiki/Apple

NSString *page = @"en.wikipedia.org/wiki/Apple";
NSString *stringURL = [NSString stringWithFormat:@"eureka://%@", page];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Facebook

This information comes from the iPhoneDevTools website.

NSURL *url = [NSURL URLWithString:@"fb://<insert function here>"];
[[UIApplication sharedApplication] openURL:url];

You can use these options:

• fb://profile – Open Facebook app to the user’s profile
• fb://friends – Open Facebook app to the friends list
• fb://notifications – Open Facebook app to the notifications list (NOTE: there appears to be a bug with this URL. The Notifications page opens. However, it’s not possible to navigate to anywhere else in the Facebook app)
• fb://feed – Open Facebook app to the News Feed
• fb://events – Open Facebook app to the Events page
• fb://requests – Open Facebook app to the Requests list
• fb://notes- Open Facebook app to the Notes page
• fb://albums – - Open Facebook app to Photo Albums list

Geocaching Buddy ( GCBuddy )

URL scheme is gcbuddy:// so to launch the application:

NSString *stringURL = @"gcbuddy://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

To add a cache to gcbuddy (simple example):

NSString *stringURL = @"gcbuddy://add/cache?id=GC12345&name=A%20test%20cache";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

See the full documentation for all optional parameters.

Geopher Lite

NSString *lat = @"12.345";
NSString *lon = @"6.789";
NSString *waypoint = @"GC12345";
NSString *stringURL = [NSString stringWithFormat:@"geopherlite://setTarget;lat=%@;lon=%@;waypoint=%@", lat, lon, waypoint];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Google Earth

To launch the application:

NSString *stringURL = @"comgoogleearth://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

iTranslate ~ the universal translator

To launch the application:

NSString *stringURL = @"itranslate://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

To translate a text:

NSString *text = @"Hello%20World"; // Text must be URL-encoded...!
NSString *stringURL = [NSString stringWithFormat:@"itranslate://translate?from=en&to=de&text=%@", text];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

You can find a list of all supported language codes here: http://en.wikipedia.org/wiki/Google_Translate#Language_Codes

Loan Plan - Amortization Calculator

To launch the application:

NSString *stringURL = @"loanplan://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Navigon

Example of a URL to start navigation to an address:

navigon://-|-|CHE|8052|Z=C3=9CRICH|KATZENBACHSTRASSE|51|-|-|***|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-

Notitas

To launch the application:

NSString *stringURL = @"notitas://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

To create a new note:

NSString *note = @"your%20note%20here"; // It must be URL-encoded...!
NSString *stringURL = [NSString stringWithFormat:@"notitas:///new?%@", note];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

pic2shop

See the full documentation, code samples, and online demo.

Start the barcode scanner, read the barcode, then call back the given URL with the UPC/EAN digits. The callback URL can be another iPhone custom URL (p2sclient: in the example below) or a web site:

NSURL *url = [NSURL URLWithString:@"pic2shop://scan?callback=p2sclient%3A//EAN"]; 
[[UIApplication sharedApplication] openURL:url]

Lookup a product by UPC/EAN:

NSURL *url = [NSURL URLWithString:@"pic2shop://lookup?ean=9780321503619"]; 
[[UIApplication sharedApplication] openURL:url]

Portscan

Launch a scan:

NSString *ip = @"192.168.1.1";
NSString *stringURL = [NSString stringWithFormat:@"portscan://%@", ip];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Round Tuit

Add new items to the todo list:

roundtuit://add/[todo item 1]/[todo item 2]/[todo item 3]/...

NSArray *todos = [NSArray arrayWithObjects:@"todo item 1", @"todo item 2"];
NSString *stringURL = [NSString stringWithFormat:@"roundtuit://add/%@", [todos componentsJoinedByString:@"/"]];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Ships² Viewer

To launch the application:

NSString *stringURL = @"ships2://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Site Check

To launch the application:

NSString *stringURL = @"checkit://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Check current url:

NSString *whatever = @"http://whatever.com";
NSString *stringURL = [NSString stringWithFormat:@"checkit://%@", whatever];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

TimeLog

To launch the application:

NSString *stringURL = @"timelog://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Start a timer for a project

NSString * clientName = @"John%20Appleseed";
NSString * projectName = @"Just%20another%20project";
NSString * categoryName = @"Webdesign";
NSString *stringURL = [NSString stringWithFormat:@"timelog://start?client=%@&project=%@&category=%@", clientName,projectName, categoryName];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Tweetie

To launch the application:

NSString *stringURL = @"tweetie://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Start a tweet with a shortened URL:

NSString *shortened_url = @"http://your.url.com";
NSString *stringURL = [NSString stringWithFormat:@"tweetie://%@", shortened_url];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Send a message:

NSString *message = @"your%20message%20here"; // It must be URL-encoded...!
NSString *stringURL = [NSString stringWithFormat:@"tweetie:///post?message=%@", message];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Twinkle

To launch the application:

NSString *stringURL = @"twinkle://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

To send a message:

NSString *stringURL = @"twinkle://message=text&url=http://foo&image=http://path.to/image.jpg";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Twittelator Pro

The author has really done a great job documenting this URL scheme! Check it out!

Launch the application:

NSURL* url = [NSURL URLWithString:@"twit://"];
[[UIApplication sharedApplication] openURL:url];

Send a message:

NSString *message = @"URL%20encoded%20message%20here";
NSString *stringURL = [NSString stringWithFormat:@"twit:///post?message=%@", message];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Twitterriffic / Twitterriffic Premium

To launch the application:

NSString *stringURL = @"twitterrific://";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

To write a tweet:

NSString *message = @"hello!";
NSString *stringURL = [NSString stringWithFormat:@"twitterrific:///post?message=%@", message];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Unfragment

(1.4 or above, formerly Shattered)

To launch a Flickr photo puzzle with hidden message:

NSMutableDictionary* code = [NSMutableDictionary dictionaryWithCapacity:7];

[code setObject:senderNameString forKey:@"name"];
[code setObject:messageString forKey:@"message"];

[code setObject:photoSourceURLString forKey:@"URL"];
[code setObject:photoIdString forKey:@"id"];
[code setObject:photoSecretString forKey:@"secret"];

[code setObject:[NSNumber numberWithInt:numberOfPieces] forKey:@"piece"];
[code setObject:[NSNumber numberWithBool:rotationOnOrOff] forKey:@"rotation"];

NSString* JSONString = [code JSONRepresentation];
NSData* data = [JSONString dataUsingEncoding:NSUTF8StringEncoding];

NSString* base64String = [data base64Encoding]; //modified Base64 for URL

NSString* unfragmentURLString = [NSString stringWithFormat:@"unfragment://?code=%@", base64String];

NSURL *url = [NSURL URLWithString:unfragmentURLString];
[[UIApplication sharedApplication] openURL:url];

Wikiamo

NSString *stringURL = [NSString stringWithFormat:@"wikiamo://%@", page];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

NSString *stringURL = [NSString stringWithFormat:@"wikipedia://%@", page];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Yummy

NSString *stringURL = [NSString stringWithFormat:@"yummy://post?url=%@&title=%@", encoded_url, encoded_title];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Swiss Phone Book by local.ch (from version 1.5)

URL examples to launch a search for a name or phone number:

localch://tel/q?vikram

localch://tel/q?0443091040

NSString *stringURL = [NSString stringWithFormat:@"localch://tel/q?%@", encoded_query];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Seesmic

Open app on Spaces (Page 1)

NSString *stringURL = [NSString stringWithString:@"x-seesmic://spaces"];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Open app on Main Timeline for the Twitter account “mathieu”

NSString *username = @"mathieu";
NSString *stringURL = [NSString stringWithFormat:@"x-seesmic://twitter_timeline?twitter_screen_name=%@", username];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Open app on Replies for account “mathieu”

NSString *username = @"mathieu";
NSString *stringURL = [NSString stringWithFormat:@"x-seesmic://twitter_replies?twitter_screen_name=%@", username];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Open app on Retweets for account “mathieu”

NSString *username = @"mathieu";
NSString *stringURL = [NSString stringWithFormat:@"x-seesmic://twitter_retweets?twitter_screen_name=%@", username];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Open app on Direct Messages for account “mathieu”

NSString *username = @"mathieu";
NSString *stringURL = [NSString stringWithFormat:@"x-seesmic://twitter_messages?twitter_screen_name=%@", username];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Open app on the Twitter profile view for “mathieu”

NSString *username = @"mathieu";
NSString *stringURL = [NSString stringWithFormat:@"x-seesmic://twitter_profile?twitter_screen_name=%@", username];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Open app on tweet view for Tweet ID “2814526203”

NSString *tweet_id = @"2814526203";
NSString *stringURL = [NSString stringWithFormat:@"x-seesmic://twitter_status?id=%@", tweet_id];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Open app on the Twitter search results for query “Apple iPhone”

// Query will be encoded using stringByAddingPercentEscapesUsingEncoding
NSString *search_query = @"Apple%20iPhone";
NSString *stringURL = [NSString stringWithFormat:@"x-seesmic://twitter_search?query=%@", search_query];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Open app on the Facebook Main Timeline (if the user added a Facebook account, or else the Spaces view will be launched)

NSString *stringURL = [NSString stringWithString:@"x-seesmic://facebook_timeline"];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Open app on Composer view for the Twitter account “mathieu” and with the content “this is a tweet” in the text field

// Query will be encoded using stringByAddingPercentEscapesUsingEncoding
NSString *message = @"this%20is%20a%20tweet";
NSString *username = @"mathieu";
NSString *stringURL = [NSString stringWithFormat:@"x-seesmic://update?twitter_screen_name=%@&status=%@", username, message];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

// Query will be encoded using stringByAddingPercentEscapesUsingEncoding
NSString *message = @"this%20is%20a%20tweet%20with%20a%20url%3A%20http%3A%2F%2F";
NSString *username = @"mathieu";
NSString *stringURL = [NSString stringWithFormat:@"x-seesmic://update?twitter_screen_name=%@&status=%@", username, message];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Open the Composer view without knowing the account and with the content “this is a tweet” in the text field

// Query will be encoded using stringByAddingPercentEscapesUsingEncoding
NSString *message = @"this%20is%20a%20tweet";
NSString *stringURL = [NSString stringWithFormat:@"x-seesmic://update?status=%@", message];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];

Open app on Composer view (no content, no account app will select default account)

NSString *stringURL = [NSString stringWithString:@"x-seesmic://update"];
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];