This page is being migrated to official  SHR User Manual. This manual then will be also available on website. Please don't enhance this page anymore, rather include your stuff into the user manual.

How to customize your SHR

You have installed SHR, and now want to customize it. Graphical interface is available (click on "settings"). If you want to have a very finr customisation,you need to modify configuration files using a text editor (nano for example)

Customize the Ringtone

If you want you can personalize the noise that your FR must do for incoming calls or messages.

Click on Setting -> profile -> ring tone Or, Shortly, you have to modify /etc/freesmartphone/opreferences/conf/phone/default.yaml use .ogg or .sid and the default place is /usr/share/sounds/ you can find some at  RingTone

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

NOTE: it's used a ! not a | to construct the gstreamer pipe command.


You can define a short ringtone, repetead many time, or a long one, repeated 1 time

File: /etc/freesmartphone/opreferences/conf/phone/default.yaml

ring-volume # Ring Volume control 0 (mini) to ? maxi)
ring-length # min time for ringtone. Must be greater than the duration of you ringtone
ring-loop # define the number of loop of ringtone to play
ring-tone: "ringtone_ringnroll.ogg" # .ogg example
ring-tone: "Arkanoid_PSID.sid" # .sid example, use default tune
ring-tone: "Arkanoid_PSID.sid;tune=2" # .sid example, plays the second tune of that

Message alert

The same as above, but with message- instead of ring- as parameters! :)

Sound Control

Up to now, there is no graphical interface to control the sound (In fact, there is non official one:, not tested with SHR, but should work)

Mic and HP

The first idea is to use alsamixer; bad idea! There are 94 controls, and your modifications will be lost at the next reboot.Finding documentation is not easy. Here is my understanding: Scenarios are used for each case. In the current unstable branch they are located in /usr/share/shr/scenarii. In older versions they can be found in /usr/share/openmoko/scenarios/ instead.

  • capturehandset.state
  • gsmheadset.state
  • headset.state
  • voip-handset.state
  • gsmhandset.state
  • gsmspeakerout.state
  • stereoout.state

Each file is a set of value for the 94 parameters. I have identified some:

  • Control 48: internal mic of the tel (set to 2 or 3)
  • Control 4 : internal speaker (set from 110 to 120)
  • Control 49: headset mic
  • Control 3 : headset speaker

External links:

Global parameters

You can find them in /etc/frameworkd.conf

Power management

Click on Settings → Power Or:

You can adjust parameters in

/etc/freesmartphone/oevents/rules.yaml /etc/freesmartphone/opreferences/conf/profiles/default.yaml


GPS is not started automaticly at boot. You can to switch it ON/OFF manually: Setting -> GPS You can also check in this menu the status of your GPS (sattelites number, fix or not, ..) GPS is started automaticly when you start TangoGPS or any other GPS software

Command line methods:

method one (the simplest)

  cd /etc/init.d/
  fso-gpsd start

method two

you need to modify the file /etc/init.d/fso-gpsd. Replace the line

start-stop-daemon --start /usr/sbin/fso-gpsd -S localhost:gpsd -P /var/run/${NAME}.pid


start-stop-daemon --start --pidfile /var/run/${NAME}.pid --exec /usr/sbin/fso-gpsd -- -S localhost:gpsd -P /var/run/${NAME}.pid

and then you can start fso-gpsd by

/etc/init.d/fso-gpsd start

method 3 using a GUI


and configure it to start/stop fso-gps using method 2


Wifi works well, using WEP or WPA. Use mofi to connect to a network

Audio playback

Use intone! It is great! I recommend you to save your audio files on the SD card. The easyest solution is to use i.e konqueror on your main computeur, and open a tab on your phone


Video playback

Use intone video (SHR unstable only, sometimes broken due to libs changes). You need to encode your video first:

mencoder video-file -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=300 -vf scale=320:240,eq2=1.2:0.5:-.025,rotate=2 -oac mp3lame -lameopts br=64:cbr -o video-file-FR.avi

You can use a GUI to transcode your video:

Then transfer it on your SD card using sftp, and play it with intone video!

On demand GPRS

Known issues

As all "testing" version, there are some minor problems.

Receiving a call when already on line: the first call is swiched off, and you can not answer the new one. To fix yet

Wifi connection: on open network, it is not easy to get a connection