This documentation will walk you through how to preview, package, and submit your Roku app to the marketplace. You will first need to sideload your app to a Roku device in order to preview and package before submitting.
Note: Your Roku device and the Roku Development Application Installer should be left on and open during this entire process.
Step 1: Sideload Your App to Preview
1. Enable Roku Developer mode on your Roku Device
a. Head to your device and turn the Roku on. Leave this on throughout this entire process. Enabling developer mode starts by pressing a particular sequence of buttons on the official Roku remote (not the remote app on your phone.) In order, press:
Home three times, then
Up two times, then
Right once, then
Left once, then
Right once, then
Left once, then
You will next see the Developer secret screen that includes your unique Roku IP Address and the username which you will want to save for later
Note: your IP address will be unique to you
b. Select "Enable installer and restart"
c. Agree to SDK License Agreement
d. Set your webserver password and save for later
e. Select "Set password and reboot"
2. Verify your Roku device and computer are connected to the same WiFi network
3. Navigate to the Development Application Installer
a. Paste your Roku IP address into your web browser
b. Enter your username generated from Step 1.1.a. and password generated from Step 1.1.d. when prompted
c. Leave this open during the entire process
4. Select "Upload" under the File section to upload the zip file that has been emailed to you in the final step of the Roku Builder Template. Select "Install." If successfully installed, you will see a "success" message in green at the bottom of the Development Application Installer screen and your app will appear on your Roku device in a matter of moments for you to preview. Typically newly added channels appear towards the bottom of your channel list.
Proceed to Step 2 if you approve of this app and are ready to generate a signing key.
Step 2: Generate Signing Key for Your App
You will need to key your Roku Channel using your computer and command line. Keying your channel is done differently depending on the computer you are using, so please read the official Roku documentation on how to generate your key and key your device. Save your developer ID and password for future reference.
Note: If you are using a Mac computer with High Sierra OS, you'll need to first install HomeBrew in order to then install Telnet.
Step 3: Package Your Sideloaded Channel
1. Open the Application Packager
a. Navigate to the Development Application Installer
b. Select "Packager" in the top right hand corner to open the Application Packager window
2. Enter an app name and version and the password created when generating keys in Step 2. Select "Package"
3. The following window will appear displaying the Currently Packaged Application indicating that the package is now available. The signed package can be downloaded using the .pkg link indicated below in the red box. Select this link to download to your computer.
Step 4: Submit to the Roku Channel Store
Now that you have a final, packaged Roku App, you will need to submit your Roku App to the Roku Channel Store. You can choose to either publish a private channel or a public channel.
A private channel will be published right away but is not searchable in the Roku Channel Store. You will be given a Channel URL that you can share with others.
To publish a public channel, you will be added to the Roku Publishing Queue for Roku QA. Roku takes roughly 6-8 weeks to approve and push your app live to the Channel Store.
During the app submission process, type your deep linking parameters in the Test Accounts text box under the Support Information tab like the below image.
- mediaType needs to be provided for all of the following categories: movie, series, season, or episode.
- contentID is the video ID or playlist ID for an active video in the Zype platform. You can find the video ID by clicking on a video in your Zype library, and at the bottom of the details page, you'll find the video ID. We recommend submitting a video ID from a video that does not have a paywall so that Roku is able to play the video during testing.
mediaType - movie; contentID - videoID
mediaType - episode; contentID - videoID
mediaType - season; contentID - playlistID
mediaType - series; contentID - playlistID
Note - Your Roku app will be rejected if the Test Accounts box does not include all of the above deep linking parameters.