GroomDroid
From Groom
Purpose
GroomDroid is not -strictly speaking- a port of Groom Webserver to Android.
It actually aims at providing a compatibility layer allowing to run the official Groom jarfile on any Android 
device.
To make it quick, GroomDroid provides a full featured webserver for your Android device !
Screenshots
 Server at work |
 Directory listing with DirectoryHandler |
 Directory listing with FancyDirectoryHandler |
Download
 Scan to download from Android market |
Alternatively, the packaged Android application (apk) is available on Sourceforge GroomDroid project page.
The source code is also available on Sourceforge though the project's CVS server.
Configuration and Usage
Configuration
The location of Groom configuration file is hardcoded in GroomDroid.
Groom will always look for /sdcard/groom.conf
Then, the server itself shall be configured exactly in the same way than the regular Groom Webserver, as explained in the Groom Configuration page.
A sample configuration file for Android is available on sourceforge (here).
PHP and other CGI on Android
I have compiled a php-cgi binary working on Android, you can find it on this page: AndroidNativeBinaries.
I have tested it with GroomDroid and it works like a charm. However, this is still experimental...
Let's consider you've installed php-cgi binary in the following location: /data/php-cgi, as explained here: AndroidNativeBinaries. Modify the following properties in your /sdcard/groom.conf:
Handler.PhpHandler.Authorize = true Handler.CgiHandler.Authorize = true Handler.PhpHandler.Binary = /data/php-cgi
And ensure the php and php3 extensions are routed to PhpHandler as explained in groom Configuration.
I have not tested any CGI other than PHP, but I can safely assume they shall also work once compiled for Android.
Usage
Using GroomDroid is very simple. Actually, the server starts the first time you run GroomDroid till it is killed (by you or by the system in case of extreme lack of memory).
Then you only have 3 actions in the menu:
- Clear logs': clear the log panel, no action on the server itself
- Kill Server: kill both the server and the GroomDroid GUI. The only safe and sure manner to shutdown the server. Keep in mind that otherwise the server is still running in background when leaving GroomDroid GUI.
- Preferences: through this screen you can set the verbosity level, from 0 (show nothing) to 10 (show all traces). The default is 3, which should be okay for common use.
