Updated Sep 06, 2008 by cavalcantii
Labels:	Featured

how_to_install

Software installing instructions: Amora 1.1

Cellphone S60 3ed

If you have Python installed

ATTENTION: the installing SIS package is only for S60 3ed, if you have a S60 2ed., please use client source version and check further instructions at hacker page.

ATTENTION: Amora client needs to be installed in the same drive where you installed Python for S60, i.e. you must install it in drive 'E' if you had installed Python in drive 'E'.

ATTENTION: Ubuntu Hardy (8.04) has a faulty bluez-utils package that breaks several bluetooth client apps (including Amora). You can see more information here and here. There is a really not-recomended way to workaround it.

Simply download and install amora-version.sis to your cellphone. Assuming that you had sent the file to your cellphone using bluetooth as a message:

Selecting it will display the questions: Install Amora: assistant?

Select Yes. Then it will display a security warning (its fine, choose continue in the screens bellow)

Of course you can send the SIS file to cellphone in several different ways too (using USB cable, copying to memory card, etc) and later select it using the S60 file browser.

tips

Mouse cursor moving speed can be increased in Configuration screen -> M. delta (mouse delta). A suggested value when running Amora client is to increase it to 5 pixels.

Image screenshot rotation (useful for devices with 240x320 resolution) can be activated in Configuration screen -> Image -> Rotate

When controlling the desktop (a.k.a. 'started mode') you can reset as also toggle the stopwatch. If you dont want to see the stopwatch, just turn it off in Configuration -> Clock

Autoscreen mode will trigger a screenshot for each mouse click (with the cellphone joystick). This allow you to advance to the next slide in a presentation and at the same time get a screenshot

Autoscreen has a default wait value of 2s (between the mouse click and the screenshot). If your computer cannot advance to the next slide within 2s, you can change the wait time in Configuration -> A. screen (ranging from 1.0s up to 5.0)

If in early steps of installing you see this image dialog

this means that you don't have Python installed. Just advance to next section where you can find instructions.

If you DONT have Python installed

Download the file amora-version-deps.sis to your cellphone. It has Python (required dependency) and Python Scriptshell (optional) bundled together with Amora client for Nokia S60 smartphones.

Just follow through the screens selecting continue, as bellow:

Symbian certificate control

It might happen Amora installation fail in silence thanks to Symbian certificate test (currently the SIS is signed with a fake certicate). As a workaround, you can turn certificate check acessing 'Application Manager' app and changing the setting as bellow:

PC server

Ubuntu users

Just download and install the Debian package. To install, run in a terminal:

$ sudo dpkg -i amora-server-version.deb

And if it installed fine, you should be able to start the server running a terminal:

$ amorad

Installing from source

Software dependencies

For server side, to compile the source code, you will need:

gcc compiler
Xlibs
XTest libs
BlueZ libs
Imlib2 libs
D-BUS libs

And also XTest extension enabled in you X server (default on Ubuntu). So, in Ubuntu simply run in your terminal:

$ sudo apt-get install gcc libxext-dev libbluetooth2-dev libimlib2-dev libxtst-dev libdbus-1-dev

remark: you might need 'pkg-config' if you don't have it installed already.

Installing

After installing the dependencies, extract server app tarball with:

$ tar -zxvf amora-server-x.y.tar.gz

where x.y is the current download version.

Change to the extracted directory and execute the following commands:

$ mkdir build

$ cd build

$ ../configure

$ make

It will generate an executable file named 'amorad', you must start the application (and make sure that the bluetooth dongle is connected to the computer):

$ ./amorad

User group

Do you have questions, suggestions, bug reports or wish to share your experience with Amora? Please, visit Amora discussion group at: http://groups.google.com/group/amora-user

Comment by maiquel.sampaio, Nov 11, 2007

I would like to know if I could run Amora in my N-Gage (1ed Symbian).

Thanks in advance,

Comment by cavalcantii, Nov 27, 2007

Dear Maiquel

I dont have access to a S60 1 edition device, and AFAIK, Nokia stopped supporting it. If you can make it work, please report back to us.

I started developing using PythonForS60? 1.3.19, if I recall correctly.

Best regards

Adenilson

Comment by johnsu01, Jan 08, 2008

Maybe it's silly, but if you really want to list all the dependencies, pkg-config should probably also be there. I had a relatively fresh Debian system and had to install that in order for configure to work.

Comment by cavalcantii, Jan 14, 2008

John

It seems that Ubuntu already includes it. But I will edit the wiki article with a remark.

By the way, could you test the Amora 1.0 Debian package and report back if it worked? (if possible, post result in http://groups.google.com/group/amora-user)

Best regards

Adenilson

Comment by distratios, Jan 15, 2008

Installed Amora 1.0 Debian Package on Kubuntu 7.10 and amora_debs.sis on Nokia N91. From Python shell Bluetooth connection works. However, amora does not even start. Screen goes white for a glimpse, that's all. The same with and without running amora server.

Regards

Panos

Comment by cavalcantii, Jan 15, 2008

Dear Panos

I fixed that bug, and the new SIS amora-1.0-1 should work fine now. Thanks for the report. :-)

Best regards

Adenilson

Comment by euphaar, Jan 16, 2008

This looks interesting... You have 64-bit deb for Ubuntu? If not, can you provide me the source deb? I'll try to create a 64-bit version to try out.

Thanks!

Comment by cavalcantii, Jan 18, 2008

Dear Friend

I had just uploaded a Debian package for Ubuntu 7.10 AMD64. You can give it a try and please report back if it worked fine?

The url: http://amora.googlecode.com/files/amora-server_1.0-0_amd64.deb

Best regards

Adenilson

Comment by AlexYeCu, Feb 08, 2009

Ive got a problem after my fedora 9 update. Now nothing changes after selecting a PCs device in Search devices menu and I can`t select a port, etc. Nothing interesting in log. Different versions of client and server tried. Oh, installing 1.1-1 client I see a question if I want install 1.01(0) version (and 1.00(0) if 1.0-1 sis file) — looks strange.

Comment by cavalcantii, Feb 08, 2009

Alex

Maybe this is somehow related with a faulty BlueZ package? Check more information (for Ubuntu) here: http://groups.google.com/group/amora-user/browse_thread/thread/d075c2aa2a1915b

This kind of behavior can happen if the bluez daemon is not answering correctly to client requests concerning which services are available in the host.

If this is the case, even python S60 bluetooth terminal will not work too.

If you need further help, I suggest to move this discussion to support forum: http://groups.google.com/group/amora-user

Best regards

Adenilson

Comment by AlexYeCu, Feb 08, 2009

Yeah, I`ve got the same bug on Fedora. These updates can solve the problem: bluez-libs-3.35-1.fc9.i386.rpm bluez-utils-3.35-3.fc9.i386.rpm Now I have working amora, thank you.

Comment by philip.tellis, Jun 23, 2009

libbluetooth2 does not exist any more.

Comment by david.oernberg, Oct 11, 2009

Tried this on my Nokia 5800. Didn't work. Phone is freezin. Think it can't handle the touchscreen. It sure was promising when I read about the projekt.

Is there another one out there that tested this on a Nokia 5800? And managed to make this work?

Comment by cavalcantii, Oct 11, 2009

Dear David

You are right, indeed amora will not run fine in a touch screen device (e.g. 5800 or N97) since it lacks a real keyboard. I'm waiting for the upcoming Python S60 2.0 version be released to write a version of amora for touchscreen cellphones.

Probably it will look like this:

Regards

Adenilson