| Classes | Functions | DevRef | Qt API | Qtopia Documentation |

## Qtopia - Filesystem standards

Qtopia software is installed in the `/opt/Qtopia` directory of the target system. Within this directory, applications must follow the file placement standards described in this document.

appname | this is the application's executable filename.
language | this is the ISO639 langauge code (e.g. "de" for German).

/opt/Qtopia/apps/category/appname.desktop

The category must be one of the following:

1. Settings if the software configures functionality which has an ongoing effect on the user's environment. Such software never creates Documents.
2. Games if the software is solely for amusement purposes.
3. Applications for all other software.

These categories have been chosen because it is very easy for the user to differentiate between them.

To install software in other categories would create confusion. For example, you should not attempt to categorize your software as a "Utility", as it is difficult for people to differentiate this categorization from the Settings and Applications categories (it falls somewhere in between).

/opt/Qtopia/bin/appname

This is the executable program of the software. Note that it is not appropriate to use the same executable with arguments to modify it's behaviour, since only one instance of each application will be run (additional attempts to run the application merely raise the previous instance).

/opt/Qtopia/pics/appname/...

Any image files the application needs to use should either be standard built-in images, or be files in this application-specific directory. See the Resource class for an explanation of how to access these files.

/opt/Qtopia/sounds/appname/...

Any sound files the application needs to use should either be standard built-in sounds, or be files in this application-specific directory. See the Resource class for an explanation of how to access these files.

/opt/Qtopia/i18n/language/appname.qm

These files are translations of the software (see Internationalization).

/opt/Qtopia/help/html/appname-suffixes.html

These files are the English online documentation of the software (the -suffixes is optional). Note that on-line documentation can refer to images under the `/opt/Qtopia/pics` directory, so you can refer to icons and other images explicitly without duplicating the files.

/opt/Qtopia/help/language/html/appname-suffixes.html

These files are the online documentation of the software (the -suffixes is optional), in the language specified.

/opt/Qtopia/lib/appname/...

Applications may put files in this directory as required.

/opt/Qtopia/plugins/applets

Taskbar applets are placed in this directory.

/opt/Qtopia/plugins/codecs

Mediaplayer codecs are placed in this directory.

/opt/Qtopia/plugins/fontfactories

Font factory extensions are placed in this directory.

/opt/Qtopia/plugins/inputmethods

Input Method plugins are placed in this directory.

/opt/Qtopia/plugins/network

Network setup modules are placed in this directory.