Unrestricted-system-ui

From Maemo Wiki
Revision as of 13:28, 16 June 2012 by imported>mohammad7410
Jump to navigationJump to search

unrestricted-system-ui is a modified system-ui package that allows developers and users to load plugins the Harmattan status menu.

How to install

To install unrestricted-system-ui you will need to have Inception or an open mode kernel installed.

N9 Users

Inception method

<source lang="bash"> wget http://mohammadag.xceleo.org/public/Harmattan/system-ui_1.2.24-2+0m7_armel.deb /usr/sbin/incept system-ui_1.2.24-2+0m7_armel.deb #enter root pass </source>

Open mode method

<source lang="bash"> devel-su #enter pass wget http://mohammadag.xceleo.org/public/Harmattan/system-ui_1.2.24-2+0m7_armel.deb export AEGIS_FIXED_ORIGIN=com.nokia.maemo dpkg -i system-ui_1.2.24-2+0m7_armel.deb </source>

N950 Users

Inception method

<source lang="bash"> wget http://mohammadag.xceleo.org/public/Harmattan/system-ui_1.2.23-1+0m7_armel.deb /usr/sbin/incept system-ui_1.2.23-1+0m7_armel.deb #enter root pass </source>

Open mode method

<source lang="bash"> devel-su #enter pass wget http://mohammadag.xceleo.org/public/Harmattan/system-ui_1.2.23-1+0m7_armel.deb export AEGIS_FIXED_ORIGIN=com.nokia.maemo dpkg -i system-ui_1.2.23-1+0m7_armel.deb </source>


Removing the alarms plugin

Nokia seem to have included an unfinished applet that opens the clock app, to hide it, you may move the .desktop file <source lang="bash"> devel-su #etner root pass mv /usr/share/meegotouch/applicationextensions/statusindicatormenu-alarms.desktop /usr/share/meegotouch/applicationextensions/statusindicatormenu-alarms.disabled </source>

To make it visible again: <source lang="bash"> devel-su #etner root pass mv /usr/share/meegotouch/applicationextensions/statusindicatormenu-alarms.disabled /usr/share/meegotouch/applicationextensions/statusindicatormenu-alarms.desktop </source>

Plugins

Here is a list of plugins currently available for unrestricted-system-ui:

Developers

Developers who plan to make status menu plugins should have unrestricted-system-ui in their debian/control Depends: line, this is to prevent user confusion and make it easier for the developer to support the user.

Plugins need to be installed in /usr/lib/meegotouch/applicationextensions/
.desktop files for the plugins need to be installed in /usr/share/meegotouch/applicationextensions

Please follow this naming scheme so it's easier for the user to distinguish plugins.
For the lib: libstatusindicatormenu-foobar.so
For the desktop file: statusindicatormenu-foobar.desktop
where foobar can be replaced with anything.

Here's a sample .desktop file <source lang="ini"> [Desktop Entry] Type=X-MeeGoApplicationExtension Name=Foo Bar Status menu plugin

[X-MeeGoApplicationExtension] Interface=com.meego.core.MStatusIndicatorMenuExtensionInterface/1.0 Extension=libstatusindicatormenu-foobar.so </source>

Restarting the status menu

At certain times, you may want to restart the status menu. Please be aware that restarting it successively may result in a reboot (by dsme/watchdog). You can restart the applet as user or root, the method to do that differs for each user.

As root

<source lang="bash"> /sbin/stop xsession/sysuid /sbin/start xsession/sysuid </source>

As user

<source lang="bash> killall sysuid </source>