https://github.com/wseemann/roku-ecp-wrapper-kotlin
Roku ECP Wrapper is a Kotlin based wrapper for the Roku External Control Protocol (ECP).
https://github.com/wseemann/roku-ecp-wrapper-kotlin
ecp kotlin roku
Last synced: 5 months ago
JSON representation
Roku ECP Wrapper is a Kotlin based wrapper for the Roku External Control Protocol (ECP).
- Host: GitHub
- URL: https://github.com/wseemann/roku-ecp-wrapper-kotlin
- Owner: wseemann
- License: apache-2.0
- Created: 2017-09-24T01:22:26.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-09-22T04:27:40.000Z (9 months ago)
- Last Synced: 2025-09-22T06:22:26.784Z (9 months ago)
- Topics: ecp, kotlin, roku
- Language: Java
- Homepage:
- Size: 186 KB
- Stars: 10
- Watchers: 2
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Roku ECP Wrapper
============================
Overview
--------
Roku ECP Wrapper is a Kotlin based wrapper/client for the [Roku External Control API](https://developer.roku.com/docs/developer-program/dev-tools/external-control-api.md).
Key Features:
--------
Roku ECP Wrapper includes helper functions to:
#### Query
* List all channels and active channels
* Obtain device information
* Obtain player state information
* Retrieve application icons
#### Control
* Perform key event and custom event input
* Launch and install channels
#### Search
* Channels and media
Install
--------
Add the following maven dependency to your project's `build.gradle` file:
dependencies {
implementation 'com.github.wseemann:roku-ecp-wrapper-kotlin:1.5.0'
}
Usage
------------
Sample code:
##### Discover all Roku devices on the local network
List rokuDevices = DeviceRequests.discoverDevices();
##### or, create a new device if you already know the devices IP address
rokuDevice = RokuDevice.create("");
// For example:
rokuDevice = RokuDevice.create("http://192.168.1.20:8060");
##### Once you have a valid RokuDevice object you can use the class to perform actions. For example, retrieve a list of available channels on a device
List channels = rokuDevice.queryAppsRequest();
for (Channel channel: channels) {
// print the channel names
System.out.println(channel.getTitle());
}
##### Start/pause playback on a device
rokuDevice.keyPressRequest(KeyPressKeyValues.PLAY);
License
------------
```
Roku ECP Wrapper: A Kotlin wrapper/client for the Roku External Control API.
Copyright 2025 William Seemann
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.