Unrestricted-system-ui

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.

PR1.3

N9 Users

Inception method

<source lang="bash"> wget http://mohammadag.xceleo.org/public/Harmattan/system-ui_1.3.2-1+0m8_armel.deb /usr/sbin/incept system-ui_1.3.2-1+0m8_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.3.2-1+0m8_armel.deb export AEGIS_FIXED_ORIGIN=com.nokia.maemo dpkg -i system-ui_1.3.2-1+0m8_armel.deb </source>

N950 Users

As of the last edit, PR1.3 is not available for the N950.

PR1.2

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:

• Brightness applet
  
• MT-Toggles | A toggles platform
  
• Quick Status Updater
  
• Music Controls | A player controls platform
  

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>

You will need to restart the status menu in postinst and postrm. Refer to the section below (as root) for how to do that.

Rearranging status menu plugins

As of the latest version, unrestricted-system-ui allows you to rearrange items in the status menu through a config file.
The file is /etc/status-menu-items-order.conf
Items that aren't in the file will be loaded in alphabatical order.
After modifying the file with your favorite text editor, you'll need to restart the status menu (see below)

.desktop file names can be found with <source lang="bash"> for files in $(ls /usr/share/meegotouch/applicationextensions/statusindicatormenu-*desktop); do basename "$files"; done </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>