mobile_deeplinks.md

Overview

The Twitch iOS and Android applications can be launched externally. This page serves to document how to do so. For support, visit the Twitch Developer Forums.

Checking for the presence of the app

You can check if the Twitch app is installed on the device with something along the following lines:

iOS Objective C

NSURL *twitchURL = [NSURL URLWithString:@"twitch://open"];
if ([[UIApplication sharedApplication] canOpenURL:twitchURL]) {
    // The Twitch app is installed, do whatever logic you need, and call -openURL:
} else {
    // The Twitch app isn't installed, prompt the user to install it!
}

iOS Swift

let twitchURL = NSURL(string: "twitch://open")
if (UIApplication.sharedApplication().canOpenURL(twitchURL!)) {
    // The Twitch app is installed, do whatever logic you need, and call -openURL:
} else {
    // The Twitch app isn't installed, prompt the user to install it!
}

Android

// Where 'packagename' is the package name of the Twitch app:

private boolean isPackageInstalled(String packagename, Context context) {
    PackageManager pm = context.getPackageManager();
    try {
        pm.getPackageInfo(packagename, PackageManager.GET_ACTIVITIES);
        return true;
    } catch (NameNotFoundException e) {
        return false;
    }
}

URL Scheme

URLs starting with twitch:// or ttv:// will open up the Twitch app, if it's installed on the device.

Launch the App

twitch://open

Launch the app and go to a particular stream, game, etc.

Live Stream
twitch://stream/#channel_name or twitch://open?stream=#channel_name

Game Directory
twitch://game/#game_name or twitch://open?game=#game_name

VOD
twitch://video/#video_id or twitch://open?video=#video_id
(For a VOD with URL twitch.tv/some_channel/v/1234567 the video_id is v1234567)

Channel Activity Feed (includes VODs)
twitch://channel/#channel_name or twitch://open?channel=#channel_name

Launch the app and go to the user's following directory (if user is not logged in, goes to the login page):

twitch://following

Launch the app and go to the login page:

twitch://login