Maemo Wiki Mirror - User contributions [en]

Community SSU/Features

2011-09-19T07:53:24Z

95.221.161.241: Undo revision 45368 by 95.221.161.241 (Talk)

Note: There is a [[CSSU_Features_Configuration_Editor|GUI editor]] for enabling CSSU features. If you use that, you can ignore the editing and applying sections on this page and just refer to the features directly. '''You will still need to re-run the editor after each CSSU update'''.

== camera-ui ==
{{main|Community SSU/Features/Camera UI}}

== hildon-desktop ==

=== Transitions ===

==== 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 <code>transitions.ini</code> 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 <code>/opt/usr/share/themes/[name of the theme you're using]/transitions.ini</code>, 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 the end of this page.

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

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

forcerotation = 1

But this isn't likely to [[Community SSU/Features/Portrait mode|work well for all applications]] - and never will. The [http://talk.maemo.org/showpost.php?p=953421&postcount=969 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

=== Zoom in/out support ===

Use CTRL+SHIFT+S (+) and CTRL+SHIFT+F (-) to zoom in and out.

=== Orientation lock ===

Install status-area-orientationlock-applet to add an applet that locks the landscape/portrait mode until you unlock it.

== Features that are configurable with gconf ==
* Make the FMTX applet always visible
gconftool-2 -s /apps/osso/maemo-statusmenu-fmtx/always_visible -t bool true
* Change the number of rows in the status menu
gconftool-2 -s /apps/osso/hildon-status-menu/view/number_of_rows -t int 6
gconftool-2 -s /apps/osso/hildon-status-menu/view/number_of_rows_portrait -t int 8
* Disable the application menu editor
gconftool-2 -s /apps/osso/hildon-desktop/menu_edit_disabled -t bool true
* Disable rotation
gconftool-2 -s /apps/osso/hildon-desktop/ui_can_rotate -t bool false
* Enable vertical scrolling when in portrait
gconftool-2 -s /apps/osso/hildon-desktop/scroll_vertical -t bool true

This document is up to date as of [[Community_SSU/Changelog#PR_1.3.3.7-10.5| 20.2010.36-maemo16.5]] (note: to find your version see Settings, About Community SSU).

[[Category:Community]]
[[Category:Fremantle]]

Community SSU/Features

2011-09-19T04:39:26Z

95.221.161.241: /* Task switcher layout */

Note: There is a [[CSSU_Features_Configuration_Editor|GUI editor]] for enabling CSSU features. If you use that, you can ignore the editing and applying sections on this page and just refer to the features directly. '''You will still need to re-run the editor after each CSSU update'''.

== camera-ui ==
{{main|Community SSU/Features/Camera UI}}

== hildon-desktop ==

=== Transitions ===

==== 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 <code>transitions.ini</code> 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 <code>/opt/usr/share/themes/[name of the theme you're using]/transitions.ini</code>, 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 the end of this page.

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, 3 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

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

forcerotation = 1

But this isn't likely to [[Community SSU/Features/Portrait mode|work well for all applications]] - and never will. The [http://talk.maemo.org/showpost.php?p=953421&postcount=969 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

=== Zoom in/out support ===

Use CTRL+SHIFT+S (+) and CTRL+SHIFT+F (-) to zoom in and out.

=== Orientation lock ===

Install status-area-orientationlock-applet to add an applet that locks the landscape/portrait mode until you unlock it.

== Features that are configurable with gconf ==
* Make the FMTX applet always visible
gconftool-2 -s /apps/osso/maemo-statusmenu-fmtx/always_visible -t bool true
* Change the number of rows in the status menu
gconftool-2 -s /apps/osso/hildon-status-menu/view/number_of_rows -t int 6
gconftool-2 -s /apps/osso/hildon-status-menu/view/number_of_rows_portrait -t int 8
* Disable the application menu editor
gconftool-2 -s /apps/osso/hildon-desktop/menu_edit_disabled -t bool true
* Disable rotation
gconftool-2 -s /apps/osso/hildon-desktop/ui_can_rotate -t bool false
* Enable vertical scrolling when in portrait
gconftool-2 -s /apps/osso/hildon-desktop/scroll_vertical -t bool true

This document is up to date as of [[Community_SSU/Changelog#PR_1.3.3.7-10.5| 20.2010.36-maemo16.5]] (note: to find your version see Settings, About Community SSU).

[[Category:Community]]
[[Category:Fremantle]]