Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

Merge pull request #58 from mdamt/master

Merge mdamt/blankon-panel
  • Loading branch information...
2 parents 689b48b + 6c3edb1 commit 4be0341011ea4aa58d78d165f794f9232b51a3f2 Mohammad Anwari committed
Showing with 40 additions and 0 deletions.
  1. +40 −0
@@ -0,0 +1,40 @@
+# Hacking Manokwari
+## Use local system
+Instead of installing the "system" directory in the system, it is a good idea to hack your own "system", ie. just do the hacking inside
+system/ directory instead of /usr/share/manokwari/system, so no sudo required.
+Do this by giving --enable-devel
+This way, Manokwari will find system directory from your current directory source tree.
+## Speed up hack-compile-run time
+Because the nature of Manokwari as desktop shell, it's cumbersome to logout and login again to run Manokwari.
+There's a few tricks to make sure you won't waste your time waiting Manokwari to run.
+### Use virtual machine
+After a complete installation of the desktop, you can do this:
+- mount (eg. using sshfs) your current source directory in your virtual machine. Make sure you have the EXACT full path to the system directory.
+ Meaning that if your source code in your development machine is in /home/you/src/manokwari, then in your virtual machine, you must
+ /home/you/src/manokwari as well. Otherwise the system/ will not be found.
+- Then you can just run manokwari from src/ directly inside your virtual machine
+- If you're able to access your virtual machine using ssh, you can have 2 tab setups in your console, one inside your own computer,
+ and the other is on your virtual machine. You compile in one tab, and switch to another to run. Win.
+### Run in nested X server
+If you want to touch only the HTML side, you can just use a nested X server, eg. Xephyr.
+This may give some warnings as Manokwari will fail to register itself as desktop or panel component in GNOME session.
+This is because your desktop in your main X server already register for those capabilities.
+You can do the following:
+- export DISPLAY to whatever your nested X server display number is
+- Run manokwari as usual
+### Run without GNOME session
+With this you will lose GNOME session capabilities, eg. you can't logout, shutdown, testing different screen sizes, etc.
+But you can quickly run Manokwari in this way.
+- Stop all desktop managers (gdm, lightdm, etc)
+- Run X manually
+- Run Manokwari inside the X you just started

0 comments on commit 4be0341

Please sign in to comment.
Something went wrong with that request. Please try again.