Skip to content

Deep Linking

Jump to bottom
1hitsong edited this page Oct 25, 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.

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