defines the QX-settings for the application. E.g. navit needs the GPS-daemon to be started and the auto-dim function of the display is disabled. These settings can be defined for the applications individually. The file contain profile records like the following for <tt>tangogps</tt> and <tt>navit</tt>:

+

defines the QX-settings for the application. E.g. navit needs the GPS-daemon to be started and the auto-dim function of the display is disabled. These settings can be defined for the applications individually. The file contains profile records like the following for <tt>tangogps</tt> and <tt>navit</tt>:

[tangogps]

[tangogps]

Line 59:

Line 59:

rotate=false

rotate=false

wm=true

wm=true

+

{{Note|You do not need a profile definition for the application to be launched in QX. Just a desktop-definition file in the folder:

+

/usr/share/applications

+

}}

===Add to QX-Favourites===

===Add to QX-Favourites===

+

The following explainations show the internal structure of the QX application management. It is helpful to create installation scripts for QX.

+

You have installed or programmed an application with the name <tt>myapp</tt>. Test the application in the QX-terminal if it works properly. Now we add this application <tt>myapp</tt> to the application list in <tt>favourites.conf</tt>. We do this e.g. with vi:

You have installed or programmed an application with the name <tt>myapp</tt>. Test the application in the QX-terminal if it works properly. Now we add this application <tt>myapp</tt> to the application list in <tt>favourites.conf</tt>. We do this e.g. with vi:

# vi /opt/qtmoko/etc/qx/favourites.conf

# vi /opt/qtmoko/etc/qx/favourites.conf

Line 69:

Line 74:

list=navit, tangogps, myapp

list=navit, tangogps, myapp

−

add lines press ESC and :w for "write to file" and ":q" for "quit VI".

+

Add <tt>myapp</tt> press ESC and :w for "write to file" and ":q" for "quit VI".

+

{{Note|You can use programs for myapp (e.g. a shell script with xdialog), that have a desktop-definition file in the directory:

+

/usr/share/applications

+

If you want to use your own scripts in QX with an icon, create a desktop-definition file first (see <tt>synccal.desktop</tt> as an example below) and save this file in <tt>/usr/share/applications</tt>.

+

}}

+

Now we have to add a profile record for <tt>myapp</tt> in file <tt>profiles.conf</tt>. We do this e.g. with vi:

Now we have to add a profile record for <tt>myapp</tt> in file <tt>profiles.conf</tt>. We do this e.g. with vi:

# vi /opt/qtmoko/etc/qx/profiles.conf

# vi /opt/qtmoko/etc/qx/profiles.conf

Line 85:

Line 95:

Then press "ESC" and ":w" for "write to file" and ":q" for "quit VI".

Then press "ESC" and ":w" for "write to file" and ":q" for "quit VI".

+

+

===Listed Favourites===

+

The available applications for the favourites in QX are defined in the directory:

+

/usr/share/applications

+

====Example desktop-definiton file for navit====

+

The files have the extension <tt>.desktop</tt> and have the following structure (e.g. <tt>navit.desktop</tt> is defined like this:

+

<pre>

+

[Desktop Entry]

+

Version=1.0

+

Name=Navit

+

Name[de]=Navit

+

Name[fr]=Navit

+

Comment=The open source vector based navigation program with routing engine

+

Comment[de]=Ein vektorbasiertes Navigationsprogramm

+

Comment[fr]=Le logiciel opensource de navigation vectorielle

+

Exec=navit

+

Icon=navit

+

StartupNotify=true

+

Terminal=false

+

Type=Application

+

Categories=GTK;Utility;Geography;

+

GenericName=Navit

+

GenericName[de]=Navit

+

</pre>

+

You can define the

+

* Name,

+

* Comment and

+

* Generic Name

+

for differnent languages. The main variable is <tt>Exec=...</tt>, because it defines the command executed, when you click on the icon in QX.

As an example we want to use the shellscript of [http://mossroy.free.fr/ics2qtcal/ Mossroy] for syncing an iCal-file into the Qt-Calendar (see [http://wiki.openmoko.org/wiki/QtMoko#Install_Script QtMoko ics2qtcal Installation]]). We have a working script

+

/usr/local/bin/synccal

+

that performs an import of in iCal-file in the Qt-calendar. We create for <tt>synccal</tt> a desktop-definition file, that is visible in QX via <tt>vi</tt>.

+

vi /usr/share/applications/synccal.desktop

+

We call the desktop-definition file <tt>synccal.desktop</tt> and enter the following definitions:

[[Image:QX_SyncCal_Launch.png|250px|thumb|Use QX-Menu for launch the new Application SyncCal]]

+

!

+

[[Image:QX_SyncCal_Info.png|250px|thumb|The Info in QX shows the setting in synccal.desktop]]

+

|-

+

|}

+

+

===Icons for the QX-Application===

+

If you want to have a special icon for your new application see free e.g. [http://www.100000freecliparts.com/clipart/Icons/index.html 100000 Free Clipart] and store the icons in the following directory with the name <tt>synccal.png</tt>.

+

<pre>

+

/usr/share/pixmaps/synccal.png

+

</pre>

+

The name is defined by the definition:

+

Icon=synccal

+

in the file <tt>synccal.desktop</tt>. If the icon is not in the image format PNG, you can install ImageMagick and convert the file:

+

# apt-get install imagemagick

+

# cd /usr/share/pixmaps/

+

# convert synccal.gif synccal.png

+

# rm synccal.gif

===Remove QX-Favorites===

===Remove QX-Favorites===

Line 91:

Line 188:

You do not need to remove the application profile for your application in <tt>profiles.conf</tt>.

You do not need to remove the application profile for your application in <tt>profiles.conf</tt>.

+

If you want to remove an application not only from the favourites list and from the list of available application in [[QX]] then remove the desktop-definition file in the folder:

+

/usr/share/applications

[[Category:Qt based distributions]]

[[Category:Qt based distributions]]

Latest revision as of 19:18, 29 November 2010

QX is a X-Server that runs under Qt Extended. Especially in the distribution QtMoko it is used to run applications like:

QX is the X-Server in QtMoko you can add favorites to the QX-Menu too by manual editing the files in:

/opt/qtmoko/etc/qx

The file

favourites.conf

detemines the list of application you will see after starting QX. The file looks like this:

[Apps]
list=navit, tangogps

The applicationsnames must exist and need an entry in the profiles.conf file.
The file

profiles.conf

defines the QX-settings for the application. E.g. navit needs the GPS-daemon to be started and the auto-dim function of the display is disabled. These settings can be defined for the applications individually. The file contains profile records like the following for tangogps and navit:

The following explainations show the internal structure of the QX application management. It is helpful to create installation scripts for QX.

You have installed or programmed an application with the name myapp. Test the application in the QX-terminal if it works properly. Now we add this application myapp to the application list in favourites.conf. We do this e.g. with vi:

# vi /opt/qtmoko/etc/qx/favourites.conf

The file look like this (press "I" for switching to INSERT mode):

[Apps]
list=navit, tangogps, myapp

Add myapp press ESC and :w for "write to file" and ":q" for "quit VI".

NOTE: You can use programs for myapp (e.g. a shell script with xdialog), that have a desktop-definition file in the directory:

/usr/share/applications

If you want to use your own scripts in QX with an icon, create a desktop-definition file first (see synccal.desktop as an example below) and save this file in /usr/share/applications.

Now we have to add a profile record for myapp in file profiles.conf. We do this e.g. with vi:

# vi /opt/qtmoko/etc/qx/profiles.conf

The file is depended on your settings could look like this and e.g. the following lines (press "I" for switching to INSERT mode):

Click on the white Paper Icon on the bottom left to open the context menu of the QX application.

Select "Launch" to start application

With the AUX-Button you can exit the X-Server environment without quitting the application.

Screenshots

Use QX-Menu-Button at bottom left

Select Launch to start Navit in QX

In Settings you can change the launch settings of the selected application

with Favourites you can select the predefined applications you can add to your favourites menu.

QX Favorites

Favorites in QX with Linphone-icon added

QX is the X-Server in QtMoko you can add favorites to the QX-Menu too by manual editing the files in:

/opt/qtmoko/etc/qx

The file

favourites.conf

detemines the list of application you will see after starting QX. The file looks like this:

[Apps]
list=navit, tangogps

The applicationsnames must exist and need an entry in the profiles.conf file.
The file

profiles.conf

defines the QX-settings for the application. E.g. navit needs the GPS-daemon to be started and the auto-dim function of the display is disabled. These settings can be defined for the applications individually. The file contain profile records like the following for tangogps and navit:

Add to QX-Favourites

You have installed or programmed an application with the name myapp. Test the application in the QX-terminal if it works properly. Now we add this application myapp to the application list in favourites.conf. We do this e.g. with vi:

# vi /opt/qtmoko/etc/qx/favourites.conf

The file look like this (press "I" for switching to INSERT mode):

[Apps]
list=navit, tangogps, myapp

add lines press ESC and :w for "write to file" and ":q" for "quit VI".
Now we have to add a profile record for myapp in file profiles.conf. We do this e.g. with vi:

# vi /opt/qtmoko/etc/qx/profiles.conf

The file is depended on your settings could look like this and e.g. the following lines (press "I" for switching to INSERT mode):