View source for Unrestricted-system-ui

[http://talk.maemo.org/showthread.php?p=1214016#post1214016 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 [https://endno.de/~itsnotabigtruck/inception/ 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 #enter 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 #enter 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:<br>
*[http://talk.maemo.org/showthread.php?p=1214014#post1214014 Brightness applet]<br>
*[http://talk.maemo.org/showthread.php?t=85165 Hacky Brightness Controller]<br>
*[http://talk.maemo.org/showthread.php?t=84725 MT-Toggles | A toggles platform ]<br>
*[http://talk.maemo.org/showthread.php?t=84912 Quick Status Updater]<br>
*[http://talk.maemo.org/showthread.php?p=1237566#post1237566 Music Controls | A player controls platform]<br>
*[http://talk.maemo.org/showthread.php?t=85163 PresenceX | A online/offline platform]<br>

== 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.<br><br>

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

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

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><br>

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.<br>
The file is /etc/status-menu-items-order.conf<br>
Items that aren't in the file will be loaded in alphabatical order.<br>
After modifying the file with your favorite text editor, you'll need to restart the status menu (see below)<br><br>

.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>