106 lines
2.1 KiB
Markdown
Executable File
106 lines
2.1 KiB
Markdown
Executable File
# rokuc
|
||
|
||
### A cURL based roku remote for home automation
|
||
|
||
This bash script leverages cURL and roku's External Control Protocol ([ECP](https://developer.roku.com/docs/developer-program/debugging/external-control-api.md)), to aid in home automation.
|
||
|
||
## Usage :
|
||
|
||
rokuc -a [ADDRESS] [ [-h] [-v] [-c [ARGS]] [-l [ARGS]] ]
|
||
|
||
- -h Show help file
|
||
|
||
- -v Enable verbos
|
||
|
||
- -a [ADDRESS] Ip address of roku device
|
||
|
||
- -c [ARGS] Commands to Roku control
|
||
|
||
- play, pause, |, p Pause and play
|
||
|
||
- home, # Home menu
|
||
|
||
- select, ok, . Select
|
||
|
||
- vol+, v+, vup, + Volume up
|
||
|
||
- vol-, v-, vdown, - Volume down
|
||
|
||
- mute, m Mute
|
||
|
||
- off, O Turn device off
|
||
|
||
- on, I Turn device on
|
||
|
||
- back, k Back
|
||
|
||
- u, up Button Up
|
||
|
||
- d, down Button Down
|
||
|
||
- l, left Button Left
|
||
|
||
- r, right Button Right
|
||
|
||
- s.5 Sleep 0.5sec
|
||
|
||
- s1 Sleep 1sec
|
||
|
||
- s2 Sleep 2sec
|
||
|
||
- s5 Sleep 5sec
|
||
|
||
- -l [ARGS] Launch Channel
|
||
|
||
- plex
|
||
|
||
- youtube
|
||
|
||
- netflix
|
||
|
||
- hulu
|
||
|
||
- tv
|
||
|
||
- hdmi1
|
||
|
||
- hdmi2
|
||
|
||
- hdmi3
|
||
|
||
- hdmi4
|
||
|
||
- av1
|
||
|
||
### Usage Examples
|
||
|
||
Launch Netflix:
|
||
|
||
```bash
|
||
$> ./rokuc -a 192.168.1.142 -l nexflix
|
||
```
|
||
|
||
Pause/Play:
|
||
|
||
```bash
|
||
$> ./rokuc -a 192.168.1.142 -c pause
|
||
```
|
||
|
||
Multi command: Go home and turn volume down x2
|
||
|
||
```bash
|
||
$> ./rokuc -a 192.168.1.142 -c "# v- v-"
|
||
```
|
||
|
||
Launch plex, wait 5 seconds, move right, select:
|
||
|
||
```bash
|
||
$> /rokuc -a 192.168.11.142 -l plex -c "s5 > ."
|
||
```
|
||
|
||
|
||
|
||
###### Roku ECP documentation: [LINK](https://developer.roku.com/docs/developer-program/debugging/external-control-api.md)
|
||
|
||
|