AUIMD is a graphical environment for mobile devices, aggregating already 
existing components.

In itself AUIMD brings few added value : its main feature is to gather 
dissociated but proven components, in a single application. The main goal 
of AUIMD is to assemble some already existing existing softwares, instead 
of reinventing them, in order to provide a user friendly environment. 
Currently MPlayer, Matchbox Keyboard, mrxvt are simply integrated through 
XEmbed. AUIMD also acts as a sort of fullscreen window manager so that regular
 X11 applications can be used easily.

Additionnaly AUIMD provides a very basic ground for easy and fast building
of small applications (widgets).

Other components can interact with AUIMD through a DBus interface. For 
instance a new widget can be started through the following method call :

  dbus-send --dest=net.pierrox.auimd /Desktop \
    net.pierrox.auimd.Desktop.StartWidget \
    string:"WebBrowser" \
    array:string:"http://www.pierrox.net/"

AUIMD currently uses Freesmartphone.org APIs for phone calls, and other 
things such as battery level reading.

AUIMD is primarily built using Python/Qt4. It runs on a GNU/Linux platform
providing X11 display, with or without window manager (VGA preferred, but 
support for QVGA is ongoing). AUIMD has been tested on ARM based devices 
with at least 400MHz CPU and 64MB RAM (Eten G500 and HTC Universal).



BUILD / INSTALL
---------------
There is no specific build and install instruction. AUIMD does not need to 
be installed in a specific location on your system and can be run directly 
from the source archive. Simply extract the archive and run auimd.py :

  tar xfz auimd-<version>.tar.gz
  auimd-<version>/auimd.py

AUIMD has some optional but valuable prerequisites though :
 - matchbox-keyboard : if you want an on screen keyboard
 - xrandr : for display rotation
 - mplayer : to play videos
 - mrxvt : tabbed terminal
 - Xephyr : if you want to start arbitrary X11 applications in a window

For Debian like distributions the prerequisites can be installed with :
apt-get install python-qt4 python-qt4-dbus x11-xserver-utils mrxvt mplayer matchbox-keyboard xserver-xephyr python-xlib python-pysqlite2



USAGE
-----

AUIMD - Aggregated User Interface for Mobile Devices.  Usage:

    ./auimd.py [options]

Options:

  -device <device>             Set the hardware type (default='dummy',
                               show available='list').
  -fullscreen                  Use the whole screen and a frameless 
                               window (default=no).
  -no-cursor                   Hide the cursor (default=no).
  -embed <win-id>              Embed into an existing window.
  -help                        Print this message.

Some other Qt/X11 usefull options:

  -display <display>            X11 display to use, default : $DISPLAY
  -geometry <WxH[+X+Y]>         Window geometry, overriden by -fullscreen



KNOWN BUGS
----------
 - XEmbed widgets sometimes fail to load correctly. It is not known yet
   where the problem is.


LICENSE
-------
AUIMD is licensed under the GPLv2. See attached LICENSE joined in this package.
All icons come from the Crystal SVG and Kdeclassic icons from KDE 3.5.10.