Skip to content

snipsco/snips-skill-roku

Repository files navigation

Snips Skill Roku

Latest Version Build Status MIT License

Note: Roku Search is only available in English, and only available for registered accounts in the U.S., Canada (English only), Ireland and the U.K

Snips Manager

It is recommended that you use this skill with the Snips Manager. Simply add the following section to your Snipsfile:

  skills:
    - pip: https://github.com/snipsco/snips-skills-roku
      package_name: snipsroku
      params:
        roku_device_ip: <ROKU_DEVICE_IP>

Usage

The skill allows you to control Roku TV. You can use it as follows:

    from snipsroku.snipsroku import SnipsRoku


    roku = SnipsRoku(<ROKU_DEVICE_IP>)
    # Go to home screen
    roku.home_screen()

    # Get dict with installed apps and apps id
    roku.get_apps()

    # Launch a specifc app already installed
    id = roku.get_app_id("Youtube")
    roku.launch_app(id)

    # Search for content
    roku.search_content("tv-show", "Friends")

    # Launch a specific series or movie. For instance, Black Mirror season 4
    roku.search_content("tv-show", "Black Mirror", None, True, "Netflix", 4)

The ROKU_DEVICE_IP is used to identify your Roku device in the network. You can either obtain the IP through the Roku interface if you navigate to Settings > Network > About and note down what is next to "IP address". Alternatively, please follow the instructions here.

Contributing

Please see the Contribution Guidelines.

Copyright

This skill is provided by Snips as Open Source software. See LICENSE.txt for more information.