

Current Developers / Maintainers
--------------------------------
Arto Karppinen (arto.karppinen@iki.fi)
Joni Kokko (t5kojo01@students.oamk.fi)
Harri Vattulainen (t5vaha01@students.oamk.fi)
Sami Mäki (t5masa02@students.oamk.fi)
Sampo Savola (samposav@paju.oulu.fi)


What is Irreco
--------------
Irreco, or Ir Remote Control, is a remote control application for Nokia tablets.

From user perspective, Irreco is made from end user application which allows 
the user to place buttons on the screen, and attach commands to those buttons.
Then the user can control different thigns with irreco.

From programmer perspective, Irreco is made from:
        - UI-editor, which connects commands to buttons.
        - Backend api, which abstracts backend details from irreco, and irreco
          details from backends. 
        - Backends, which handle different devices and give lists of supported 
          commands

	  
Depencies
---------
In addition of the standard Maemo stuff, Irreco needs xmlrpc:

Add to /etc/apt/sources.list:

    deb http://repository.maemo.org/extras/ chinook free
    deb http://repository.maemo.org/extras-devel/ chinook free

XML RPC needs following debs to be installed:

    gengetopt_2.18-1_armel.deb
    libidn11_0.6.5-1_armel.deb
    libidn11-dev_0.6.5-1_armel.deb
    libxmlrpc-c3_1.06.25-2irreco1_armel.deb 
    libxmlrpc-c3-dev_1.06.25-2irreco1_armel.deb

Before those debs you must install libwww0 and libwww-dev

Run in terminal:

     apt-get install libwww0
     apt-get install livwww-dev

Then install debs in following order:

     dpkg -i gengetopt_2.18-1_armel.deb
     dpkg -i libidn11_0.6.5-1_armel.deb
     dpkg -i libidn11-dev_0.6.5-1_armel.deb
     dpkg -i libxmlrpc-c3_1.06.25-2irreco1_armel.deb
     dpkg -i libxmlrpc-c3-dev_1.06.25-2irreco1_armel.deb
	


Irreco project structure
------------------------
irreco                  - Main irreco aplication
irreco/src/api             - Irreco backend api header.
irreco/src/core            - Irreco application.
irreco/src/util            - Irreco util library.
script                  - Scripts for testin irreco and building packages.
backend                 - Irreco backends.
backend/dummy           - Example / Test backend.


Testing / Developing Irreco and backends
----------------------------------------
In order to run Irreco and backends inside the Maemo development eviroment
you need to ./configure both Irreco with the same --prefix and then 
make && install both to the same directory. Plus you need to set certain 
eviromental variables (PATH, LD_LIBRARY_PATH, PKG_CONFIG_PATH) so that Irreco
and the Backend will find everything they need to compile & run.

This is pain in the ass to do manually, so i have written scripts for this 
purpose. To test Irreco and Lirc backend you just need to execute the following
scripts:

    ./script/irreco.sh install
    ./script/backend.sh lirc install
    ./script/test.sh run

The scripts will autogen, configure, make and make install everything. 
The installation directory is ./install in the root of the project trunk.
If you need to give special options to ./configure, you can use

     ./script/backend.sh lirc configure OPTIONS

For example:

    ./script/backend.sh lirc configure --debug=yes

To cleanup the ./install dir you can just delete it:

    rm -rv ./install

To cleanup individual backend or irreco you can run:

    ./script/irreco.sh clean
    ./script/backend.sh lirc clean

Or to clean everything and delete ./install dir:

    ./script/clean.sh







