View source for AfterStep in Android WebTop

== Setting up WebTop environment ==

=== Prerequisites ===
You have to have your phone rooted and SU installed. There are number of exploits and tools available depending on the phone.

Naturally you should already have either [http://www.amazon.com/gp/product/B004LWYYZ0/ref=oh_details_o03_s00_i00 Motorola HD Multimedia Dock] or whatever webtop capable dock comes with your phone. Good idea to plug it into hdmi capable display and have keyboard+mouse attached to it.

=== webtop2sd ===
It is recommended that you do not modify the WebTop environment in phone's own flash, but instead create a partition on SD card and use webtop2sd utility to copy phone's WebTop. webtop2sd will then mount this partition ontop of the phone's own stuff and if it get's screwed up you'll be able to go back to the blank slate and use your phone's WebTop again.

Get webtop2sd and instructions [http://forum.xda-developers.com/showthread.php?t=1119555 here].

In my experience running webtop configurator to install lxterminal did not work the first time. I had to reboot the phone one more time, and upon running webtop configurator again - lxterminal installed fine.

=== webtopscripts ===

Package management is horribly broken in webtop due to manufacturers doing weird things to it, and possibly breaking it on purpose.
To fix stuff, so that apt-get works again - use webtopscripts. Download from [http://code.google.com/p/webtopscripts/downloads/detail?name=webtopscripts-1.7.tar&can=2&q= Google Code] and follow the [http://code.google.com/p/webtopscripts/wiki/install_and_run instructions].  Setup script walks through all of the fixes - there is no need to run individual scripts.

After this you get Ubuntu Jaunty in more or less usable state. Time to install packages and tweak.


=== Basic tweaks ===
The first thing you want to do is disable (or possibly re-configure) xscreensaver. By default it will show nasty looking day-glo colored waves on the screen in colors that hurt eyes like acid. Open LXTerminal - (there should be a button for it on the dock at the bottom of the screen) and run:
 <code>kill $(ps -ef | grep 5000 | grep xscreensaver | cut -c10-15)</code>.

Another good thing to kill is webtop-wallpaper. Its a desktop window layered underneath everything else and displaying wallpaper and maybe icons? Anyway this stuff is bad. Kill it:
 <code>kill $(ps -ef | grep 5000 | grep webtop-wallpaper | cut -c10-15)</code>

This changes have effect only temporarily until webtop shutsdown, which is either when phone runs out of memory and garbadge collection kicks in or when it's powered off. '''Note that undocking the phone preserves your session!'''

For more permanent solution - we need to edit startup scripts, but first we need something to edit those with - my personal low tech favorite - nano:
 <code>sudo apt-get install nano</code>
Also useful the text-mode file manager Midnight Commander :
 <code>sudo apt-get install mc</code>

Both nano and mc are great in large measure because they don't depend on other packages.

No we can edit the config files: 
 <code>sudo nano /osh/usr/local/bin/start-oshwt-1.sh</code>
and comment out xscreensaver line.
 <code>sudo nano /osh/usr/local/bin/start-oshwt-2.sh</code>
and comment out webtop-walpaper line.

With annoyances taken care of we can now start with with the useful stuff.

=== Getting the AfterStep ===
AfterStep package in Jaunty is old and broken in webtop environment, therefore it is recommended to install AfterStep from the source code. Naturally we need some tools : 
 <code>sudo apt-get install cvs</code>
 <code>sudo apt-get install openssh-client</code>
Strictly speaking ssh client is not required unless you want write access to CVS repository, but it's still useful to have around.

=== Compilation ===
==== Prerequisites ====
Naturally, to be able to compile AfterStep we need the compiler :

 <code>sudo apt-get install gcc</code>
That will install gcc 4.3 and binutils. 
Suggested packages : gcc-multilib, manpages-dev, autoconf, libtool, and if you want to do some debugging - gdb.

 <code>sudo apt-get install autoconf</code> 
Also installs automake, autotools-dev and m4.

 <code>sudo apt-get install libtool</code>

Also for some reason compilation won't work without floating point library: 
 <code>sudo apt-get install libmpfr-dev</code>

Useful libraries for AfterStep:
 <code>sudo apt-get install libfreetype6-dev</code>
 <code>sudo apt-get install zlib1g-dev</code>

Naturally, we need Xorg devel libraries : 
 <code>sudo apt-get install xorg-dev</code>

More useful stuff : 
 <code>sudo apt-get install x11-utils</code>
 <code>sudo apt-get install nedit</code>

== Useful links ==
* [http://sites.google.com/site/androidnothize/nebtop/webtop Webtop analysis]

* [http://forum.xda-developers.com/archive/index.php/t-1012684.html Webtop Packages that can/can't be upgraded and apps that work]

* [http://forum.xda-developers.com/showthread.php?p=17418400 Webtop startup scripts]

* [http://www.flightinstrument.net/home/scripts More startup scripts info]

* [http://forum.xda-developers.com/archive/index.php/t-969195.html Manually launching webtop]