Running X/Qt and X apps using jumbo package

From OESF

X/Qt jumbo pack

Installing X/Qt

Installing X/Qt using the jumbo package is relatively simple. It is installed just like any other package, however, due to its size, make sure you have at least 40MB of free disk space to install the xqt jumbo package.

The X/Qt jumbo package [xqt-gtk-jumbo_4.3-0.6_arm.ipk] installs a complete X server for Qtopia as well as GTK libraries, and it comes with a very lightweight window manager, which means you only get a very minimal X menu and no fancy desktop icons on your X screen. The X/Qt jumbo package is compatible with the Sharp ROM as well as Cacko, which is a derivative of the Sharp ROM. The X/Qt jumbo package has been tested on the SL-C3100, SL-C3000, SL-C1000 and SL-C860. Other models might work as well, but have not been explicitly tested.

The X/Qt jumbo package is composed of the following packages:

   * xqt-fonts-misc [xqt-fonts-misc_4.3.0-3_all.ipk]
   * xqt-fonts-100dpi [xqt-fonts-100dpi-iso8859-1_4.3.0-3_all.ipk]
   * xqt-fonts-75dpi [xqt-fonts-75dpi-iso8859-1_4.3.0-3_all.ipk]
   * xqt-server [xqt-server_1.9.0_arm.ipk]
   * xbase-etc [xbase-etc_4.3.0-3_all.ipk]
   * zlib - [zlib_1.2.2-1_arm.ipk]
   * xlibs [xlibs_4.3.0-3_arm.ipk]
   * xbase-client [xbase-clients_4.3.0-3_arm.ipk]
   * gdk-pixbuf [gdk-pixbuf_0.22.0-2_arm.ipk]
   * glib [glib_1.2.10-0vl3_arm.ipk]
   * glib-additional [glib-additional_1.2.10-2_arm.ipk]
   * glibc-locale-ja-eucjp [glibc-locale-ja-eucjp_2.2.2-1_arm.ipk]
   * glibc-locale-ja-utf8 [glibc-locale-ja-utf8_2.2.2-1_arm.ipk]
   * glibc-gconv-ja [glibc-gconv-ja_2.2.2-1_arm.ipk]
   * glib2 [glib2_2.4.7_arm.ipk]
   * libgcc1 [libgcc1-zaurus_3.2.2-0_arm.ipk]
   * freetype [freetype_2.1.5-1_arm.ipk]
   * fontconfig [fontconfig_2.2.1-1_arm.ipk]
   * fontconfig-etc [fontconfig-etc_2.2.1-1_all.ipk]
   * xqt-fonts-encodings [xqt-fonts-encodings_4.3.0-3_all.ipk]
   * atk [atk_1.6.1_arm.ipk]
   * gtk [gtk_1.2.10.1_arm.ipk]
   * gtk2 [gtk2_2.4.13_arm.ipk]
   * libpng3 [libpng3_1.2.4-1_arm.ipk]
   * libtiff [libtiff3.6.1-1_arm.ipk]
   * pango [pango_1.4.1_arm.ipk]
   * blackbox [blackbox_0.65.0-2_arm.ipk]
   * rxvt [rxvt_2.6.4-1_arm.ipk]
   * xqtclip [xqtclip_0.0.2_arm.ipk]
   * xqt-debian-scripts [xqt-debian-scripts_0.4_arm.ipk] 

The X/Qt jumbo package pre-configures all the contained packages so that once it is installed, it is ready to use on the C3x00 and C1000. Other models require the keys to be remapped first. You can either use xev to determine the key assigments and create your own .xmodmaprc file or get a pre-made one and place it into /home/zaurus

Once X/Qt is installed, you will get additional icons on your desktop, however, on some models, you will need to restart Qtopia or reboot your Zaurus in order for them to show up. You will get a new X/Qt tab with several placeholder icons. Use the StartX icon to start X-windows. Do not use the X/Qt icon, but do not remove it either. It is required to display the X/Qt icon on your Qt taskbar when X is running. The other icons are only placeholders and do not do anything until you actually install those applications. Once you install those applications, the icons will be able to launch them. You can also start X from the command line using the xlauncher command.

The blackbox window manager taskbar is at the bottom of the screen, hidden behind the Qt taskbar. You will need to use X control to change X to fullscreen in order to see it. X control can be activated by pressing the menu button which allows you to switch to fullscreen and/or shutdown X. Holding down the Fn key while tapping with the stylus will get you the blackbox wm control menu.

You can use xlauncher to start X applications. Just run xlauncher with the application's executable as the argument and xlauncher will start the application you specified. If X is already running, the application will just appear inside X, but if X has not been started yet, it will start X first before starting the application.

xlauncher will also enable swap if a swapfile exists and is not enabled yet (you really should create a swapfile for running X applications). xlauncher can also be used to allow your X application to be launched from your Qt desktop.

Also, you should install sudo if you don't have it installed already (Cacko has it installed by default). xlauncher can be run as root if sudo is not available.

X applications

There are several X/Qt applications that you can install and use once you have X/Qt. There are some on the X/Qt feeds, and some pdaXrom applications such as Firefox will also work. However, the packages for the Kathrin releases are incompatible with some of the Sharp libraries and thus will not run in X/Qt. Luckily, the source packages are available so someone with time on their hands can always compile a compatible version for Sharp ROM. In addition, you can also install Debian Pocketworkstation with X/Qt. Below are tested applications that can be installed for X/Qt. Also the following applications have icons preconfigured for them on the X/Qt tab. You can also create your own launch icons for X/Qt applications. To do that, do the following:

Get Icon

Qt Desktop Icons are usually png files. You can create your own or download them off the net. If you are lucky, the X app might even have installed one under /usr/share/pixmap

Copy the icon file to /opt/QtPalmtop/pics

Create launch script

Create an executable script that looks like this and place it under /opt/QtPalmtop/bin

#!/bin/sh
xlauncher myapp

Call it runmyapp or something like that.

Create desktop file

Create a file such as myapp.desktop that looks like the following and place it under /opt/QtPalmtop/apps/XQt:

     [Desktop Entry]
     Name = MyApp
     Icon = myapp.png
     Exec = runmyapp
     Comment = My X application
     Type = Application
     HidePrivilege = 1
     Display = 640x480/144dpi,480x640/144dpi

Installing Mozilla Firefox

The Mozilla Firefox package from pdaXrom [firefox_0.9gtk_armv5tel.ipk] works with X/Qt on the C3000. However, other models might have problems running it so I have build a firefox package [firefox_0.9-2_arm.ipk] which hopefully is more compatible and can be run on other models as well as the C3000.

Firefox will fail to run on the first launch, however, it will run fine on subsequent invocations. You can start firefox by either tapping on the Firefox icon on the Qt desktop or launching it from the command line as follows:

• xlauncher firefox

If you have troubles starting firefox after several attempts, start it as the root user.

Installing Mozilla Thunderbird

The Mozilla Thunderbird package from pdaXrom [thunderbird_0.6_armv5tel.ipk] works with X/Qt on the C3000. However, other models might have problems running it.

You can start thunderbird by tapping on the thunderbird icon or launching it from the command line as follows:

• xlauncher thunderbird

Installing AbiWord

The AbiWord package from pdaXrom [abiword_2.0.0_armv5tel.ipk] works with X/Qt on the C3000. However, other models might have problems running it.

You can start abiword by tapping on the abiword icon or launching it from the command line as follows:

• xlauncher abiword

Installing Gimp

The Gimp and related packages from pdaXrom also works under X/Qt. However, you will install several to get Gimp working. You will need to install the following packages:

   * libgimp - [libgimp_1.2.5-2_armv5tel.ipk]
   * xqt-gimp - [xqt-gimp_1.2.5-2_armv5tel.ipk]
   * xqt-gimp-plugins - [xqt-gimp-plugins_1.2.5-1_armv5tel.ipk] 

libgimp might give some errors, but just ignore them. Once you have installed gimp, you can start it by issuing the following command:

• xlauncher gimp

Installing Debian/PocketWorkstation

Debian is too big to be installed with an ipk file. You can either install Debian using the instructions on my Zaurus website, or install my xqt-debian image file which comes pre-installed with Firefox and Thunderbird, and optionally OpenOffice with the add-on debian-openoffice image file. The packages have been optimised in size so that it is possible to install everything on an ext2 formatted SD or CF card of 512MB. The debian docs are in a separate tarball so you can leave them out if you want to save space. OpenOffice binaries are compressed using a cramfs file image so that everything can fit onto 512MB.

To install Debian using the image file, unzip xqt-debian-install.zip and place it into the same directory as the other files. The following files are available:

   * xqt-debian-install.zip (required)
   * zaurus-debian-jumbo-v18-b01.tar.gz (required)
   * zaurus-debian-doc-v18.tar.gz (optional)
   * zaurus-debian-openoffice114.tar.gz (optional) 

The default install location (which has been extensively tested) is /hdd3/debroot. You can specify a different location for the debian root. The install script will by default create a swapfile and pocketworkstation image under /hdd3, but you can change the location by editing the install script and changing the default locations. If you already have a swapfile located somewhere else, simply comment out the SWAPFILE definition. Also, if you have formatted your disk as ext2 and you want to install there instead of creating the loopback filesystem, simply comment out the DEBIMG definition as well.

### default settings section start
# swap filename
SWAPFILE=/hdd3/swapfile
# swap size (in MB)
SWAPSIZE=64
# debian diskimage file
DEBIMG=/hdd3/pocketworkstation
# debian size (in MB)
DEBSIZE=512
# debian tarball
DEBTARBALL=zaurus-debian-jumbo-v18-b01.tar.gz
# debian documentation tarball
DOCTARBALL=zaurus-debian-doc-v18.tar.gz
# openoffice tarball
OOTARBALL=zaurus-debian-openoffice114.tar.gz
### default settings section end

You can increase the swap and pocketworkstation file sizes, but it is not advised to decrease them too much.

From a command line console, do the following:

# su
# ./xqt-debian-install.sh /hdd3/debroot

Once installed, you can start Debian by tapping on the Debian icon on the Qt desktop or use the command line xlauncher debian.

The mouse function is emulated as follows:

   * Tapping on screen = Left Click
   * Fn + Shift + Tapping = Center Click
   * Fn + Tapping = Right Click

If you also extracted the openoffice image file, then OpenOffice will be available in Debian. You can start OpenOffice as follows or launch it from the icevm menu:

• cd /home/zaurus/OpenOffice1.1.4/soffice &

Note: You can add the optional components even after you have installed Debian. Simply place the optional package in the same directory as xqt-debian-install.sh and re-run it again with the same parameters you had used in the previous install.