A CLI tool for controlling Roku devices over a local network.
- Scan your network for Roku devices using the SSDP protocol
- Simulate remote controller keypresses (ex: down, volume up, home, etc)
- Show a list of all apps installed on the Roku device and launch any of them
- Create and execute macros (JSON files with a list of commands)
- Interactive mode with keyboard controls
- Go v1.25.6
Older/newer versions may work but Remoku has only been tested with this version.
- You must have Go installed on your computer first.
- Run
go install github.com/CDX-1/remoku/cmd/remoku@latest - Run
remokuto use the tool
- Ensure that in
Settings > System > Advanced system settingsthat 'Control by mobile apps' is set to 'Enabled' - Make sure that your computer and the Roku device are on the same network
- You can check your Rokus IP address by going to
Settings > Network > About > IP Address
Valid inputs include:
- home
- back
- up
- down
- left
- right
- ok (or 'select')
- play
- pause
- vup
- vdown
- mute
- power (or 'off')
- on
remoku press up # move selector up
remoku press home # open home screen
remoku press vup # increase volumeremoku apps # get a list of installed apps
remoku launch <appId> # launch an appWant to create your own macros? See MACROS.md for more information.
remoku macro macros/example.json # execute commands in example.jsonremoku interactive # launches interactive moderemoku press home --ip <ip_address> # opens home screen on the device at <ip_address>