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 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 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 Google Code and follow the 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:

kill $(ps -ef | grep 5000 | grep xscreensaver | cut -c10-15).

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:

kill $(ps -ef | grep 5000 | grep webtop-wallpaper | cut -c10-15)

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:

sudo apt-get install nano

Also useful the text-mode file manager Midnight Commander :

sudo apt-get install mc

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

No we can edit the config files:

sudo nano /osh/usr/local/bin/start-oshwt-1.sh

and comment out xscreensaver line.

sudo nano /osh/usr/local/bin/start-oshwt-2.sh

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 :

sudo apt-get install cvs
sudo apt-get install openssh-client

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 :

sudo apt-get install gcc

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.

sudo apt-get install autoconf 

Also installs automake, autotools-dev and m4.

sudo apt-get install libtool

Also for some reason compilation won't work without floating point library:

sudo apt-get install libmpfr-dev

Useful libraries for AfterStep:

sudo apt-get install libfreetype6-dev
sudo apt-get install zlib1g-dev

Naturally, we need Xorg devel libraries :

sudo apt-get install xorg-dev

More useful stuff :

sudo apt-get install x11-utils
sudo apt-get install nedit

Useful links

• Webtop analysis

• Webtop Packages that can/can't be upgraded and apps that work

• Webtop startup scripts

• More startup scripts info

• Manually launching webtop