Rewwwoot - The web interface

Rewwwoot is a web interface to ReMoot that makes it possible to use any web browser as a remote
control. It turns gadgets like Palm pilots, the Nokia N800 or even cell phones into remotes for your
multimedia apps.

rewwwoot is written in Ruby.


Installation

Use a pre-compiled package like a .deb (Remember that rewwwoot.deb depends on remoot.deb)

If not on Debian or Ubuntu, you have two options:
1. using the install-script:

To install rewwwoot, simply run the script install.rb as root:

sudo ./install.rb


This installs rewwwoot in /usr/bin and places the "libraries" in your ruby sitedir,

copies the configfile to /etc/rewwwootrc and copies the htdocs to
/var/rewwwoothtdocs

To uninstall, run uninstall.rb as root:

sudo ./uninstall.rb


2. or, if you don't trust me: manually

Rename main.rb to rewwwoot and copy it to /usr/bin. make it executable

rename the dir "lib" to "rewwwoot" and copy it to your ruby sitedir.
If you do not know where this is, se the part above labeled "1."

copy htdocs to /var/rewwwoothtdocs
copyt rewwwootrc to /etc

To uninstall: undo the above.


Usage and configuration

Start daemoot
Start rewwwoot
Point your browser to the IP-address of host computer and default port number(14300), ex. 192.168.1.101:14300

Generally no configuration is necessary. Rewwwoot should run just fine using the default configuration,
although it is recommended to change the "allowed IPs" to the ip of the gadget you are going to use.

Configuration of portnumber and allowed IP's are stored in a file called rewwwootrc in ~/.rewwwoot
The configfile uses YAML-syntax (www.yaml.org):

allowFrom: [ips need to be in a list separated by commas: [value1, value2].
You can use wildcards to replace ip groups. Example. To allow every ip in
the local network: 192.168.0.*]

htdocs: /path/to/document/root/ending/with/slash/ (default ~/.rewwwoot/htdocs)

port: port to use as an integer (default 14300)

Example config:

allowFrom: [127.0.0.1, 192.168.0.*]
port: 14300
htdocs: /home/user/.rewwwoot/htdocs/


This config would allow all incomming traffic from the local computer and from every adress
beginning with 192.168.0. (the last "group" is wildcarded). It would also serve pages to the local computer.

If rewwwoot cannot find values in the config or in the commandline args it will fall back on the default values:

port: 14300
htdocs: ~/.rewwwoot/htdocs
allowFrom: []

Tips and tricks

Rewwwoot uses the ruby standard library webserver Webrick. It is indeed a good piece of software, but it is dead slow.

For maximum pleasureā„¢ you should install the ruby server library Mongrel version 1.0.1 or later. This is most easily done by using rubygems. This will make rewwwoot alot faster (benchmarks on mongrel vs webrick shows that mongrel sometimes can be up to one second faster PER REQUEST(!)).


License

Rewwwoot is licensed under the Academic Free License version 3.0

Thanks

Thanks to Boldie for the default artwork and for bugtesting.
Mr D. Odenhall for being my ruby mentor.

Comments