Community SSU/Features/hildon-desktop

(New page: Please note this page is currently under construction. The scope of this wiki is to provide information on editing all parameters in transistions.ini and the contains of usr/share/hildon-d...)
Line 7: Line 7:
This wiki covers manual editing of the transistions.ini file and requires knowledge of [[Terminal]].
This wiki covers manual editing of the transistions.ini file and requires knowledge of [[Terminal]].
-
For GUI editing of  
+
 
 +
For GUI editing of transitions please see CSSU Features Configuration and Theme Customizer applications.

Revision as of 09:37, 27 May 2012

Please note this page is currently under construction. The scope of this wiki is to provide information on editing all parameters in transistions.ini and the contains of usr/share/hildon-desktop

Contents

Community SSU Features of hildon-desktop

Transitions

This wiki covers manual editing of the transistions.ini file and requires knowledge of Terminal.

For GUI editing of transitions please see CSSU Features Configuration and Theme Customizer applications.


Editing transitions.ini

To enable the CSSU features you have to edit a file (I use leafpad, but any editor works). After any CSSU update you have to do redo the edit or restore the backed up file (read below).

The file to edit is transitions.ini and is in:

/usr/share/hildon-desktop/

So the command is:

leafpad /usr/share/hildon-desktop/transitions.ini

If you use a theme that has a custom transitions.ini file, it will override the one above, so check in /opt/usr/share/themes/[name of the theme you're using]/transitions.ini, if changing the transitions.ini file in the above path doesn't work.

The CSSU tweaks have to be turned on at the end of the file one by one, where there is also a bit more documentation about them.

If you don't see an option there, you need to update the CSSU install (via the application manager). You can check which version you have using System, Settings, About Community SSU.

After an update to the CSSU, the old transitions are backed up in /usr/share/hildon-desktop/transitions.ini.old, so you can restore them easily. However, if there have been two or more updates since you last did this, the .old one wont contain your changes. There is a bug logged to improve this behaviour. You can restore this saved copy using

mv /usr/share/hildon-desktop/transitions.ini.old /usr/share/hildon-desktop/transitions.ini

To apply the changes, see below.

thp_tweaks

Most features go under the [thp_tweaks] section present in transitions.ini at the bottom of the file after a CSSU update. However, if you use your own transitions.ini files (for example from MaeModder), this section will not be present and you must add it.

[thp_tweaks]

Entries under other sections have this indicated. Add them at the end of that section instead.

Applying the changes to transitions.ini

Some of these changes (taskswitcher, zaxisrotation, forcerotation) apply as soon as you save the file, while others (blurless) require you to restart hildon-desktop. You can do so by turning the phone off and on again, or running as root:

killall hildon-desktop

This will kill the hildon-desktop process, and it will be automatically restarted with the changed settings loaded and applied. Be sure not to "killall hildon-desktop" too often in a row (like several times in one minute), or the system will restart (nothing dangerous, though - just an annoyance).

Blurless

If you want to enable a blurless effect for the background when switching apps, you have to edit it like this

blurless = 1

Task switcher layout

and for the task switcher layout you can choose 1, 2 columns or the default

taskswitcher = 2

More details and some demo videos of these features are here : http://thpmaemo.blogspot.com/2011/02/community-ssu-features-to-look-forward.html

Rotation effect

For the alternative rotation effect (spin in place rather than flip), set

zaxisrotation = 1

forcedrotation

The point of forcerotation is to make it easier to identify the apps which are:

  • Closed source but work well. A "white-list" will be developed and included in a future CSSU so that these rotate out-of-the-box.
  • Open source but work well. These will have the appropriate flags added to their source in the git repos.
  • Open source but nearly work. These will have the appropriate flags and changes added to their source in the git repos.

You can force all apps to (try to) autorotate with

forcerotation = 1

This isn't likely to work well for all applications - and never will. The point of forced rotation is to make it easier to identify the apps which are:

  • Closed source but work well. A "white-list" will be developed and included in a future CSSU so that these rotate out-of-the-box.
  • Open source but work well. These will have the appropriate flags added to their source in the git repos.
  • Open source but nearly work. These will have the appropriate flags and changes added to their source in the git repos.


Therefore, unless an app falls into one of the above categories, please do not raise bugs in the CSSU.


Zoom effect

Zoom press just does a quick little zoom out and back in again with you touch certain things, such as an icon on the home screen or the main top menu in applications.

[home]
zoom_on_press = 0

Home screen parallax amount

parallax is when you scroll across desktops and the icons scroll faster than the background, making the icons appear closer. a larger number in the transition.ini file for parallax and the faster the icons will move.

[home]
parallax = 2

Blacklist

Blacklist is a feature provided in Community SSU, that allows individiual applications to be blocked from rotating. This feature is to be used in conjunction with forcerotatation also provided as part of Community SSU Currently the only way to edit the blacklist is manually via a text editor from Terminal, unlike many of the features above.

Editing the Blacklist

In the default transistions.ini an example is provided. To add an application to the list

blacklist = appname1 appname2

Application

A list of application names are provided below to make it easier to add applications to the list.


http://talk.maemo.org/showthread.php?t=76377

   mediaplayer The stock media player
   osso-xterm xTerminal
   image-viewer Image viewer
   camera-ui Camera
   Calendar Calendar
   nokia-maps Nokia Maps
   osso_calculator Calculator
   osso-browser Stock Browser
   conky Conky..
   qtlockscreen Qt Lockscreen by sakya
   someplayer SomePlayer
   worldclock Clock
   controlpanel Settings
   rtcom-call-ui Phone
   active-desktop-sp
   advanced-clock-plugin
   angrybirds
   angrybirds-levelpack1
   angrybirds-levelpack2
   angrybirds-levelpack3
   angrybirds-levelpack4
   apmefo
   applock
   autodisconnect
   bounce
   Bless900
   AlmostTI
   cal-home-widget
   callerx
   callerxui
   cell-modem-ui
   cfmradio
   chaosandmayhem
   clean900
   com-ea-app-monopoly
   com-ea-app-sims
   com-gameloft-app-asphalt5
   com-gameloft-app-blades
   com-gameloft-app-driver
   com-gameloft-app-hawx
   com-gameloft-app-nova
   com-gameloft-app-realsoccer2010
   com-gameloft-app-xletsgolf
   com-glu-app-clockwork
   com-glu-app-ghero5
   community-ssu-enabler
   conky-n900 Conky..
   conkylayoutswitcher
   connectnow-home-widget
   cpumem-applet
   cssufeatures
   custom-operator-name-widget
   decoders-support
   diskusage
   docstogo
   drnoksnes SNES Emulator
   es-no2-basketmania
   evopedia
   extcalllog
   fapman
   fillmore
   flashlight-applet
   flashlight-extra-gtk
   fm-boost
   friendlyfm
   guitar-chords
   harmattan-icons-pack
   headphoned
   hostmode-gui
   kernel-power-flasher
   kernel-power-settings
   kmplayer KMPlayer
   leafpad
   led-pattern-editor
   libqtm-bearer
   libqtm-contacts
   libqtm-location
   libqtm-messaging
   libqtm-multimedia
   libqtm-publishsubscribe
   libqtm-sensors
   libqtm-serviceframework
   libqtm-systeminfo
   libqtm-versit
   lowbatled
   livewp Non rotating Live Wallpaper
   mc Midnight Commander
   maemoblocks
   osso-chess-ui
   osso-mahjong
   osso-lmarbles
   gnuchess
   mp-fremantle-community-pr
   n900-fmrx-enabler
   neverball
   neverputt
   nhouse
   njurassic
   offscr-discs
   offscr-fifteen
   ogg-support
   openssh
   openssh-client
   openssh-server
   opera-mobile
   personal-ip-address
   picodrive SEGA MEga Drive Emulator
   preenv Preenv (Need to be tested)
   qcpufreq QCPUFrequency
   qtquickcompat
   queen-beecon
   quick-launch
   quickpanorama-pro
   recorder
   rootsh
   simple-brightness-applet
   spbbrainevolution
   spin
   stellarium-mobile
   tangram
   tar-gnu
   theme-customizer
   timedsilencer
   ttf-droid
   tutorial-home-applet
   vgb GBC Emulator
   vgba GBA Emulator
   worldtv99
   zenbound