Revision as of 07:09, 12 February 2012

LinuxMCE Orbiter for Android

This wiki page serves 2 purposes: To serve as an intermediate install guide for the Android LinuxMCE Orbiter, and to serve as a point of reference for future developers.

History

The Android orbiter is the result of a very tricky process. We utilize the LinuxMCE libraries, qt libraries, and wrap them inside java for execution on the Android device. Besides using vanilla Qt Creator, we also utilize Neccesitas, a cross platform compiler that takes the Native c++ and wraps it for executing inside the Android JNI

Installation

Please note, you will need 50mb of storage space on the devices internal storage. NOT the sd card. You will also need to install via wifi!!

• Download the testing apk: http://lasmarthomes.com/QOrbiter-release.apk
• Install the .apk
• When it is finished, it will ask you for to download Ministro II, which in turns might need additional libs which are automatically downloaded.

. Do this and let it finish. QOrbiter is now installed!

Configuration

You will need to prepare for the addition of the device to your system before it can be used by following these steps.

• Create a new QOrbiter device as a child of the core. MAKE SURE to set the default user and location. Make a note of the device number
• Quick Reload the router when asked.
• Generate the orbiter config by visiting this page http://<you-core-address>/lmce-admin/qOrbiterGenerator.php?d=<the-device-number>

Now you will need to decide on a skin. Eventually, this will be a cleaner process. For the moment, it isnt :) All skins live on the core and will be accessible from http://<your-route-ip>/lmce-admin/skins The following instructions are for the core machine.

All skins need a skins directory:

mkdir -p /var/www/lmce-admin/skins

svn co http://svn.linuxmce.org/svn/branches/LinuxMCE-1004/src/qOrbiter/qOrbiter_src/qml /var/www/lmce-admin/skins

Now your skins are installed.

Running the device

• Assuming the previous steps were completed, you can now connect.
• The default ip it connects to is 192.168.80.1
• Enter the device number you previously made note of for the device number
• If your core address is not standard, it will hang. you can kill the device and edit the config.xml at the location listed below.

The configuration file is located on the SDCard under /LinuxMCE

Remote Access

In order to use qOrbiter from outside your internal LMCE network, you need to:

• Open ports 2757 & 3450 on your firewall via webadmin
• Change the host line in LinuxMCE/config.xml on your Android device to your CORE's external IP address.