Skip to content

Deep Linking

Jump to bottom
1hitsong edited this page Oct 26, 2024 · 4 revisions

Requires viv 1.0.8

Definition of variables

<Roku IP Address> - the IP address of the Roku device you want to launch media on

<collectionType> - the type of media the collection you want to play contains

<contentID> - the guid ID of the media you want to play

<MediaType> - the type of media you want to play

<seriesID> - the guid ID of the TV series you want to play

Sample URL

This is what a URL will look like that you will need to post to for deep linking to work. The static parts of the URL are also important.

http://<Roku IP Address>:8060/launch/782030?contentID=<contentID>&MediaType=<MediaType>

:8060 - the port number the Roku device watches for commands. Without it, the Roku device will never receive your commands.

782030 - is the channel ID for viv. Without it, the Roku device does not know which channel to launch.

Deep linking without relaunching viv

You can deep link to content without relaunching viv by sending an input command instead of a launch command. Everything except the command will remain the same as it uses all the same code behind the scenes.

- http://<Your Roku IP Address>:8060/launch/782030?contentID=<Your Desired Content ID>&MediaType=<MediaType>
+ http://<Your Roku IP Address>:8060/input?contentID=<Your Desired Content ID>&MediaType=<MediaType>

Example URLs for each media type

Remember to change the <Roku IP Address> and <contentID> variables to your values. The values used below are examples and will not work for you.

- http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=audio
+ http://<Your Roku IP Address>:8060/launch/782030?contentID=<Your Desired Content ID>&MediaType=audio

Audio

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=audio

Audiobook

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=audiobook

Boxset

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=boxset

Collection Folder

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=collectionfolder&collectionType=movies

Valid collectionType values are:

  • books - use for audiobooks
  • boxsets
  • collectionfolder
  • homevideos - use for photos
  • movies
  • music
  • musicvideos
  • tvshows

Live TV Channel

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=tvchannel

Live TV Program

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=program

Movie

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=movie

Music Album

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=musicalbum

Music Artist

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=musicartist

Music Video

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=musicvideo

Person

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=person

Photo

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=photo

Photo Album

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=photoalbum

Playlist

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=playlist

Recording

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=recording

TV Episode

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=episode

TV Season

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=season&seriesID=91bbfa36933c45a59a13c381293fa372

TV Series

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=series

User View

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=userview&collectionType=movies

Valid collectionType values are:

  • books - use for audiobooks
  • boxsets
  • collectionfolder
  • homevideos - use for photos
  • movies
  • music
  • musicvideos
  • tvshows

Video

http://192.31.111.79:8060/launch/782030?contentID=eaac8225ae7d41d59b338a70067a47d3&MediaType=video
Clone this wiki locally