CSSU Features Configuration Editor

(General: added link)
(Usage info: added screenshots)
Line 26: Line 26:
  * Choose the options you would like to have (for info on the options look in the [[Community SSU/Features]] page).
  * Choose the options you would like to have (for info on the options look in the [[Community SSU/Features]] page).
  * Press the "Update" button.
  * Press the "Update" button.
 +
[[Image:CSSUfeaturesConfiguration_main1.png|300px]]
 +
[[Image:CSSUfeaturesConfiguration_main2.png|300px]]
===Other options===
===Other options===
  * The "Current" button sets the current options the system is using in the options (which are shown also in the startup of the application)
  * The "Current" button sets the current options the system is using in the options (which are shown also in the startup of the application)
  * The "Default" button sets the values in UI equal to those shipped with the Community SSU.
  * The "Default" button sets the values in UI equal to those shipped with the Community SSU.
 +
 +
[[Image:CSSUfeaturesConfiguration_current.png|300px]]
 +
[[Image:CSSUfeaturesConfiguration_default.png|300px]]
  '''''Note''''': Neither of those buttons propagate any changes to the system. They will only set the UI elements. The options visible in the UI will be applied only after pressing the "Update" button.  
  '''''Note''''': Neither of those buttons propagate any changes to the system. They will only set the UI elements. The options visible in the UI will be applied only after pressing the "Update" button.  
Line 38: Line 43:
  * Open the menu.  
  * Open the menu.  
  * Choose the "Restore Defaults" option.  
  * Choose the "Restore Defaults" option.  
 +
 +
[[Image:CSSUfeaturesConfiguration_restore.png|300px]]
  '''''Note''''': This will restore to the shipped version of the transitions.ini and will not have any effect on the similar file in <code>/etc/hildon/theme/</code> that might be used by theming.
  '''''Note''''': This will restore to the shipped version of the transitions.ini and will not have any effect on the similar file in <code>/etc/hildon/theme/</code> that might be used by theming.
Line 44: Line 51:
  * Some of the options get immediately active as soon as you press the "Update" button.  
  * Some of the options get immediately active as soon as you press the "Update" button.  
  * Others need the hildon-desktop to be restarted. For those a menu option is available "Restart hildon-destop".
  * Others need the hildon-desktop to be restarted. For those a menu option is available "Restart hildon-destop".
 +
 +
[[Image:CSSUfeaturesConfiguration_update.png|300px]]
==Issues & TODO==
==Issues & TODO==

Revision as of 21:50, 21 March 2011

The CSSU Features Configuration Editor is a user interface to the configuration of several parameters enabled by the Community SSU updates.

It has been built using the PyQt libraries and the Python language.

It provides the ability to change a number of parameters in the transitions.ini configuration file. The options are shown in the Community SSU/Features wiki page. Additional information on the usage, settings and implications could be found below.

Contents

Installation

The application is hosted in the Extras repositories. Its status can be seen at the packages page The project is also hosted in Maemo Garage

Dependencies

The application depends to the following packages:

  • python2.5
  • python2.5-qt4-gui
  • python2.5-qt4-core
  • python2.5-qt4-maemo5

Usage info

General

The operation of the application is simple:

* Choose the options you would like to have (for info on the options look in the Community SSU/Features page).
* Press the "Update" button.

Other options

* The "Current" button sets the current options the system is using in the options (which are shown also in the startup of the application)
* The "Default" button sets the values in UI equal to those shipped with the Community SSU.

Note: Neither of those buttons propagate any changes to the system. They will only set the UI elements. The options visible in the UI will be applied only after pressing the "Update" button. 

Restoring to Default

If for some reason you have messed up and you want to restore the default transitions.ini file:

* Open the menu. 
* Choose the "Restore Defaults" option. 

Note: This will restore to the shipped version of the transitions.ini and will not have any effect on the similar file in /etc/hildon/theme/ that might be used by theming.

Applying changes

* Some of the options get immediately active as soon as you press the "Update" button. 
* Others need the hildon-desktop to be restarted. For those a menu option is available "Restart hildon-destop".

Issues & TODO

  • It only edits transitions.ini located under /usr/share/hildon-desktop/. Thus, will fail if you have more transitions.ini files (e.g. using the theme-customizer). fixed in version #0.3-1
  • Current button is not yet implemented. fixed in version #1.0-1
  • The application when it opens shows the default options - in a future update will show the system's current options. fixed in version #1.0-1
  • BLOCKER: In the "parallax" field the values need to be float, i.e. "2.0" and not "2", otherwise the GUI fails to open. fixed in version #1.1-1
  • MINOR: if "tactile" package is installed and disable option if it's not. fixed in version #1.2-1
  • MINOR: The application should reside in the Settings under Personalisation. At the moment it is in the applications.

Versions

1.6-1

Availability: Extras-devel

Changes:

  • Added a dynamic button in the application menu to add/remove the entry in the Power Key menu.
  • Added a postrm script to remove settings made by the application when uninstalled.
  • Added new entries in the update script.

1.5-1

Changes:

  • Added code in the postinstall to compile the python code.
  • Removed the menu button for restarting hildon-desktop (crashes other Qt apps).
  • Added menu button for rebooting the device.
  • Added note for option that requires reboot.
  • Several UI modifications for usability.
  • Modified icon.

1.3-1

Availability: Extras-testing If you find it fulfils the QA criteria vote here

Changes:

  • Fix for the application freeze when restarting hildon-desktop.

1.2-1

Changes:

  • Added a menu button for restarting hildon-desktop (e.g. needed for blurless update).
  • Added check if the Community SSU is installed.
  • Added check if the transitions.ini file used has all new features available.
  • Added check if the tactile package is installed and enable/disable accordingly the selection.

1.1-1

Changes:

  • Corrections in the postinstall script.
  • Fix in configuration readout for case where string could be read as integer.
  • Modified the way the app starts, it's name in the window and application menu.

1.0-1

Changes:

  • Implemented the CURRENT button. Additionally when app opens shows the current values.
  • Added rotation support in the About panel (does not need forced rotation).
  • Added better banner messages for actions taken.
  • Several GUI beautifications.

0.4-1

Changes:

  • Removed desktop file from the hildon-control-panel. It doesn't work yet.
  • Added messages for which configuration file will be used.

0.3-1

Changes:

  • Implemented the DEFAULT button to revert all values in the GUI back to system's defaults.
  • If an update is requested, the system checks if a transitions.ini file exists in /etc/hildon/theme/ (used by theming) and updates that too.
  • Update in the sudoers file to accept the new command for the additional update.

0.2-1

Changes:

  • Some small beautifications in the GUI.

0.1-1

Changes:

  • Initial version.

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 only.

Disclaimer

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.