Paroli

From Openmoko

(Difference between revisions)
Jump to: navigation, search
(FAQ: tried to pull several disparate main-menu hints together)
 
(28 intermediate revisions by 12 users not shown)
Line 1: Line 1:
 
[[Image:Paroli.png|thumb|Paroli Screenshot]]
 
[[Image:Paroli.png|thumb|Paroli Screenshot]]
Paroli is a new approach to application development on the Openmoko phones. It is actually able, in combination with [[Om2009]] distribution to make Freerunner work as a simple phone.
+
===What is Paroli===
It's based on top of the [[OpenmokoFramework|FSO framework]] and enables the use of it via a core and several services.
+
Paroli a phone application for the Openmoko phones, that can be used for ....
 +
 
 +
 
 +
=== History ===
 +
Originally it was planned to be released with [[Om2009]] distribution but as OM2009 developement slowed down, Paroli was also compiled for [[SHR]]
 +
 
 +
Paroli is based on top of the [[OpenmokoFramework|FSO framework]] and enables the use of it via a core and several services.
  
 
For more information please visit [http://www.paroli-project.org/ Paroli website]
 
For more information please visit [http://www.paroli-project.org/ Paroli website]
  
If you are  interested in helping out with paroli, contribute code or test or or or ... Let us know! Send a mail to [mailto:mirko@openmoko.com Mirko] and/or visit #paroli IRC channel!
+
If you are  interested in helping out with paroli, contribute code or test or or or ... Let us know! Send a mail to [mailto:vegyraupe@paroli-project.org Mirko] and/or visit #paroli IRC channel!
 +
 
 +
== Important links ==
 +
 
 +
* [[Paroli-developer-setup|Paroli developer setup]]
 +
* [[Paroli-application-ideas|Paroli application ideas]]
 +
* [[Paroli-issues|Paroli issues]]
 +
* [[Paroli-background|Change the background image]]
 +
* [[Paroli-e|Some e tips]]
 +
* [[Illume_improvements|Illume keyboard improvements]]
  
 
== Stuff that works ==
 
== Stuff that works ==
Line 17: Line 32:
 
==Installation / download ==
 
==Installation / download ==
  
=== Full distro ===
+
=== Paroli on SHR unstable ===
 +
If you want to try and run paroli in SHR unstable RFN. Flash the latest shr-unstable image from http://shr.bearstech.com/shr-unstable/images/om-gta02/.
 +
 
 +
The image from 08-08-09 has a minor problem with opkg. to fix it
 +
 
 +
opkg-cl update
 +
opkg-cl upgrade
 +
 
 +
then install paroli
 +
 
 +
opkg install paroli
 +
 
 +
Fix the conf files that the paroli installer messes with ( I hope to fix the recipe in the next couple of days. )
 +
 
 +
cp /etc/old_frameworkd.conf /etc/frameworkd.conf
 +
cp /etc/freesmartphone/oevents/old_rules.yaml /etc/freesmartphone/oevents/rules.yaml
 +
 
 +
now if you want to disable the shr phone apps without removing them comment all of the lines out in
 +
 
 +
/etc/X11/Xsession.d/89notifier and /etc/X11/Xsession.d/80ophonekitd
 +
 
 +
if you want the bind-home to ease upgrades add this line to fstab.
 +
 
 +
/media/card/bind-home  /home/root    none        bind                  0  0
 +
 
 +
You should now have a functional paroli on SHR setup. Once you have a working setup it might be better not to run opkg upgrades but only upgrade specific packages when needed.
 +
 
 +
=== Paroli on OM2009 ===
  
 
To install the [[Om2009]] distribution download the uImage and fso-paroli-image from http://downloads.openmoko.org/distro/testing/NeoFreerunner/
 
To install the [[Om2009]] distribution download the uImage and fso-paroli-image from http://downloads.openmoko.org/distro/testing/NeoFreerunner/
Line 41: Line 83:
 
  git clone http://git.paroli-project.org/paroli.git/
 
  git clone http://git.paroli-project.org/paroli.git/
  
== FAQ ==
+
== FAQ/Tips ==
  
''' What's in the main menu? '''
+
===What's in the main menu?===
  
 
* Call-Log is the phone log. It'll show your dialled, answered and missed calls.
 
* Call-Log is the phone log. It'll show your dialled, answered and missed calls.
Line 61: Line 103:
 
** To SMS someone, enter the People list, and slide the contact's name to the right.  A "Msg" button will be exposed, which you can press to start a text message.
 
** To SMS someone, enter the People list, and slide the contact's name to the right.  A "Msg" button will be exposed, which you can press to start a text message.
  
 +
===What's beyond the main menu?===
 +
Check "how do I change the theme" below. By default, the display is set to 'paroli' which gives Paroli a full window, but you can change the theme so that you can access other applications outside Paroli using Illume.
  
'''How do I get to settings?'''
+
===How do I get to settings?===
  
 
Go to the home-screen (the one with the big clock) and hold the AUX-button pressed for 2 seconds.
 
Go to the home-screen (the one with the big clock) and hold the AUX-button pressed for 2 seconds.
  
'''How do I get Illume?'''
 
  
Open settings, click on "display" and then hit "profile" (once) and be patient, after some rumbling on the screen you will have the standard illume look with paroli in windowed mode. It may be necessary to reboot or wait a while before this will work.
+
===How do i get gprs to work? ===
  
''' How do I shut it down? '''
+
Simpy click on Status in Settings - gprs, it toggles from unregistered to active.
  
Hold the power button down for 10 seconds. It will not give you a visual feedback, it just starts shutting down.
+
===How do I change the theme (Illume / Paroli / Paroli-serenity)?===
 +
Open settings, click on "display" and then hit "profile". This will change the profile to the next: after some rumbling on the screen you will have the new theme activated.
 +
* ''paroli'' = Paroli fullscreen
 +
* ''illume'' = Paroli windowed, Illume bar on top
 +
* ''paroli-serenity'' = Paroli windowed, black Illume bar on top
  
''' How do I change the audio profile '''
+
To change to paroli-serenity on command line, run:
 +
DISPLAY=:0 mdbus org.enlightenment.wm.service /org/enlightenment/wm/RemoteObject org.enlightenment.wm.Profile.Set paroli-serenity
 +
 
 +
===How do I shut it down?===
 +
 
 +
To turn off Paroli, use the Illume top bar: click the bar when running Paroli and click on the red X to shut down Paroli.
 +
 
 +
To kill it from command line:
 +
pkill paroli
 +
 
 +
To turn of the whole phone, hold the power button down for 10 seconds. It will not give you a visual feedback, it just starts shutting down.
 +
 
 +
===How do I change the audio profile?===
  
 
* When not on call, short pressing of AUX changes between audio profiles (default / silent).
 
* When not on call, short pressing of AUX changes between audio profiles (default / silent).
 
* When on call, it changes the speaker volume (20-40-60-80-100%). Using level over 80 might cause some echo.
 
* When on call, it changes the speaker volume (20-40-60-80-100%). Using level over 80 might cause some echo.
  
 +
===How do I close an application?===
 +
When illume or paroli-serenity theme is activated (see above), clicking the top bar will show you 3 icons. The one in the right (the big X) closes the current app.
  
''' Where are the messages folder? Drafts, sent etc.?
+
===How to I turn on the keyboards?===
 +
In the top up menu, there is is a "qwerty" icon. Same to close it.
  
 +
===Where are the messages folder? Drafts, sent etc.?===
  
'''How do I lock the screen, without going to suspend?
+
The messages will be saved to /home/root/.paroli
  
 +
===How do I lock the screen, without going to suspend?===
  
''' How do i set the alarm?
+
Sorry, not implemented yet.
  
 +
===How do i set the alarm?===
  
''' How do I contribute? '''
+
Sorry, not implemented yet.
  
 +
===How do I change the background image?===
 +
 +
For a detailed (step-by-step) instruction with example images, please see this page:
 +
[[Paroli-background|Change the background image]]
 +
 +
===How do I contribute?===
  
 
See [[Om 2009 get active#Paroli phone software|Paroli section on Om2009 "get active" page]].
 
See [[Om 2009 get active#Paroli phone software|Paroli section on Om2009 "get active" page]].
 +
 +
===Is there a way to import my contacts into Paroli's adressbook?===
 +
 +
Yes, Ingvaldur Sigurjonsson made a script allowing to import *.vcf files. See [[vcf2paroli]].
  
 
== Known issues ==
 
== Known issues ==
Line 100: Line 175:
  
 
[[Category:Paroli]]
 
[[Category:Paroli]]
 +
[[Category:ApplicationsElementary]]

Latest revision as of 15:05, 15 February 2010

Paroli Screenshot

Contents

[edit] What is Paroli

Paroli a phone application for the Openmoko phones, that can be used for ....


[edit] History

Originally it was planned to be released with Om2009 distribution but as OM2009 developement slowed down, Paroli was also compiled for SHR

Paroli is based on top of the FSO framework and enables the use of it via a core and several services.

For more information please visit Paroli website

If you are interested in helping out with paroli, contribute code or test or or or ... Let us know! Send a mail to Mirko and/or visit #paroli IRC channel!

[edit] Important links

[edit] Stuff that works

Paroli actually makes FR a simple, very working phone!!

  • ability to turn off PIN check & change pin! (The first distro that does it ?)
  • Connecting to WLAN (with WPA, WPA2, WEP)
  • suspend & resume
  • etc etc

[edit] Installation / download

[edit] Paroli on SHR unstable

If you want to try and run paroli in SHR unstable RFN. Flash the latest shr-unstable image from http://shr.bearstech.com/shr-unstable/images/om-gta02/.

The image from 08-08-09 has a minor problem with opkg. to fix it

opkg-cl update
opkg-cl upgrade

then install paroli

opkg install paroli

Fix the conf files that the paroli installer messes with ( I hope to fix the recipe in the next couple of days. )

cp /etc/old_frameworkd.conf /etc/frameworkd.conf
cp /etc/freesmartphone/oevents/old_rules.yaml /etc/freesmartphone/oevents/rules.yaml

now if you want to disable the shr phone apps without removing them comment all of the lines out in

/etc/X11/Xsession.d/89notifier and /etc/X11/Xsession.d/80ophonekitd

if you want the bind-home to ease upgrades add this line to fstab.

/media/card/bind-home   /home/root     none        bind                   0  0

You should now have a functional paroli on SHR setup. Once you have a working setup it might be better not to run opkg upgrades but only upgrade specific packages when needed.

[edit] Paroli on OM2009

To install the Om2009 distribution download the uImage and fso-paroli-image from http://downloads.openmoko.org/distro/testing/NeoFreerunner/

[edit] Only the package

In order to get the package from unstable you'll need to adjust the configuration of opkg:

echo src/gz openmoko-unstable-armv4t http://downloads.openmoko.org/repository/unstable/armv4t > /etc/opkg/om-unstable.conf

Then do an opkg-update and opkg install paroli.

This should get you the newest version.

[edit] Download

Download paroli from http://downloads.freesmartphone.org/fso-milestone5/feeds//armv4t/paroli_0.2.1+gitr7a2...442-r0_armv4t.ipk

or from http://downloads.openmoko.org/distro/experimental/

[edit] Getting the sources

git clone http://git.paroli-project.org/paroli.git/

[edit] FAQ/Tips

[edit] What's in the main menu?

  • Call-Log is the phone log. It'll show your dialled, answered and missed calls.
    • To SMS a contact from Call-Log slide the number to the right to expose "Msg"; push this button to compose a new message.
  • SMS is the place to send & read messages
    • Slide existing SMS to the right to expose Re: to Reply.
  • Dialer is the dialer
  • People is the phone book
    • To call someone, enter the People list, click on the contact, and click on the number displayed
    • To SMS someone, enter the People list, and slide the contact's name to the right. A "Msg" button will be exposed, which you can press to start a text message.

[edit] What's beyond the main menu?

Check "how do I change the theme" below. By default, the display is set to 'paroli' which gives Paroli a full window, but you can change the theme so that you can access other applications outside Paroli using Illume.

[edit] How do I get to settings?

Go to the home-screen (the one with the big clock) and hold the AUX-button pressed for 2 seconds.


[edit] How do i get gprs to work?

Simpy click on Status in Settings - gprs, it toggles from unregistered to active.

[edit] How do I change the theme (Illume / Paroli / Paroli-serenity)?

Open settings, click on "display" and then hit "profile". This will change the profile to the next: after some rumbling on the screen you will have the new theme activated.

  • paroli = Paroli fullscreen
  • illume = Paroli windowed, Illume bar on top
  • paroli-serenity = Paroli windowed, black Illume bar on top

To change to paroli-serenity on command line, run:

DISPLAY=:0 mdbus org.enlightenment.wm.service /org/enlightenment/wm/RemoteObject org.enlightenment.wm.Profile.Set paroli-serenity

[edit] How do I shut it down?

To turn off Paroli, use the Illume top bar: click the bar when running Paroli and click on the red X to shut down Paroli.

To kill it from command line:

pkill paroli

To turn of the whole phone, hold the power button down for 10 seconds. It will not give you a visual feedback, it just starts shutting down.

[edit] How do I change the audio profile?

  • When not on call, short pressing of AUX changes between audio profiles (default / silent).
  • When on call, it changes the speaker volume (20-40-60-80-100%). Using level over 80 might cause some echo.

[edit] How do I close an application?

When illume or paroli-serenity theme is activated (see above), clicking the top bar will show you 3 icons. The one in the right (the big X) closes the current app.

[edit] How to I turn on the keyboards?

In the top up menu, there is is a "qwerty" icon. Same to close it.

[edit] Where are the messages folder? Drafts, sent etc.?

The messages will be saved to /home/root/.paroli

[edit] How do I lock the screen, without going to suspend?

Sorry, not implemented yet.

[edit] How do i set the alarm?

Sorry, not implemented yet.

[edit] How do I change the background image?

For a detailed (step-by-step) instruction with example images, please see this page: Change the background image

[edit] How do I contribute?

See Paroli section on Om2009 "get active" page.

[edit] Is there a way to import my contacts into Paroli's adressbook?

Yes, Ingvaldur Sigurjonsson made a script allowing to import *.vcf files. See vcf2paroli.

[edit] Known issues

See wiki page paroli-issues for the list of known issues and vital feature requests.

Bug tracker is available at http://www.paroli-project.org/trac

Personal tools
Paroli Screenshot

Paroli is a new approach to application development on the Openmoko phones. It is actually able, in combination with Om2009 distribution to make Freerunner work as a simple phone. It's based on top of the FSO framework and enables the use of it via a core and several services.

For more information please visit Paroli website

If you are interested in helping out with paroli, contribute code or test or or or ... Let us know! Send a mail to Mirko and/or visit #paroli IRC channel!

Stuff that works

Paroli actually makes FR a simple, very working phone!!

  • ability to turn off PIN check & change pin! (The first distro that does it ?)
  • Connecting to WLAN (with WPA, WPA2, WEP)
  • suspend & resume
  • etc etc

Installation / download

Full distro

To install the Om2009 distribution download the uImage and fso-paroli-image from http://downloads.openmoko.org/distro/testing/NeoFreerunner/

Only the package

In order to get the package from unstable you'll need to adjust the configuration of opkg:

echo src/gz openmoko-unstable-armv4t http://downloads.openmoko.org/repository/unstable/armv4t > /etc/opkg/om-unstable.conf

Then do an opkg-update and opkg install paroli.

This should get you the newest version.

Download

Download paroli from http://downloads.freesmartphone.org/fso-milestone5/feeds//armv4t/paroli_0.2.1+gitr7a2...442-r0_armv4t.ipk

or from http://downloads.openmoko.org/distro/experimental/

Getting the sources

git clone http://git.paroli-project.org/paroli.git/

FAQ

What's in the main menu?

  • Call-Log is the phone log. It'll show your dialled, answered and missed calls.
    • To SMS a contact from Call-Log slide the number to the right to expose "Msg"; push this button to compose a new message.
  • SMS is the place to send & read messages
    • Slide existing SMS to the right to expose Re: to Reply.
  • Dialer is the dialer
  • People is the phone book
    • To call someone, enter the People list, click on the contact, and click on the number displayed
    • To SMS someone, enter the People list, and slide the contact's name to the right. A "Msg" button will be exposed, which you can press to start a text message.


How do I get to settings?

Go to the home-screen (the one with the big clock) and hold the AUX-button pressed for 2 seconds.

How do I get Illume?

Open settings, click on "display" and then hit "profile" (once) and be patient, after some rumbling on the screen you will have the standard illume look with paroli in windowed mode. It may be necessary to reboot or wait a while before this will work.

How do I shut it down?

Hold the power button down for 10 seconds. It will not give you a visual feedback, it just starts shutting down.

How do I change the audio profile

  • When not on call, short pressing of AUX changes between audio profiles (default / silent).
  • When on call, it changes the speaker volume (20-40-60-80-100%). Using level over 80 might cause some echo.


Where are the messages folder? Drafts, sent etc.?


How do I lock the screen, without going to suspend?


How do i set the alarm?


How do I contribute?


See Paroli section on Om2009 "get active" page.

Known issues

See wiki page paroli-issues for the list of known issues and vital feature requests.

Bug tracker is available at http://www.paroli-project.org/trac