Ruku is a Roku™ set-top box remote control, with command line and web interfaces
gem install ruku
The following launches the web interface. See it at localhost:3030
You can use this to scan for or add boxes and start controlling them. I recommend using the keyboard (super snappy controlling!). Arrow keys (and vi directional keys) work, Space plays and pauses, Enter selects, and Esc is home.
You can also just use the command line. Ruku needs to know about your Roku box(es). If you haven't added any boxes with the web interface, try:
This will try to scan your network to find boxes. Read on below if it didn't. Assuming you have a least one box set up, you can start sending commands.
ruku pause # Play/pause ruku left ruku up ruku select ruku fwd # Fast forward ruku back # Rewind
Known commands are: up down left right select home fwd back pause
Making an alias for 'ruku pause' is nice for quick pause/play while computing.
If scanning doesn't work for adding boxes then you'll have to figure out what the IP of the box is - it's available in Settings -> Player Info on the box. Then add it manually:
ruku add IP
Any method of adding boxes creates a '.ruku-boxes' file in your $HOME directory that contains an IP or hostname per line (followed optionally by a colon and a nickname for that box). You can edit or create this yourself. You can see all known boxes with:
For more help:
Git clone URL is
Issues and Bug Reports
You can open issues at Github
Or you can send me an email: firstname.lastname@example.org
Roku and the Roku logo are trademarks of Roku Inc. in the United States and other countries.
Ruku is not made, supported, or endorsed by Roku Inc.
Ruku is MIT licensed.
Aaron Royer <email@example.com>
Ruby 1.8.6 or later
Copyright 2010-2011 by Aaron Royer MIT licensed - see the MIT-LICENSE file included in the distribution
This software is provided “as is” and without any express or implied warranties, including, without limitation, the implied warranties of merchantability and fitness for a particular purpose.