<chapter><title>Using &opie;</title> <section><title>Running &opie; for the first time</title> <para> If everything was installed as described in the previous section, &opie; should now start up and present a screen to calibrate the touchscreen. Using the stylus, press firmly in the middle of the cross-hairs as they appear on the screen. This usually needs to be done only once, however the screen can be re-calibrated at any time, if needed, by choosing the Calibrate application on the Settings tab. </para> <para> Once the screen has been calibrated, &opie; will now start up. If the opie-login package is installed (which is installed with the default installation), a screen will appear requiring a person to log in before any applications can be accessed. The standard &opie; installation currently requires the user to log in as the 'root' user in order for all functions to work correctly. Refer to the Familiar website (http://familiar.handhelds.org) for the default password for the version installed. </para> <para> Once the correct password has been entered, &opie; should now be running. When rebooted however, &opie; will start automatically. To install and remove applications, the "Packages" application (located on the Settings tab) or the command line ipkg application can be used. There are several task-opie packages which allow the installation of whole categories (e.g. games, PIM, settings, etc.) of software at once. It also might be helpful to install either opie-embeddedkonsole or opie-console first to allow access a command line from within &opie;. </para> </section> <section><title>Getting Around</title> <para> Now that &opie; is installed and running, it is time to start using it. When &opie; is started (after logging in), the following will be visible: the "Launcher" from which all of the applications can be started, and the "Taskbar" along the bottom, where all running applications can be accessed, select an input method, and interact with the installed applets. </para> <para> Getting around in &opie; is very easy. Using the stylus, simply click on whatever icon, button or control desired. The main difference between using the stylus and using a mouse is that there is not an intuitive way to "right click" with the stylus. However in &opie;, by pressing and holding the stylus down on the screen for approximately one second (i.e. commonly referred to as "click and hold") a right mouse button click is generated. This allows the user to perform common actions such as display context sensitive menus. </para> <para> Also included in several &opie; applications is context sensitive help. If there is a icon with a question mark on the left side of the application's title bar, then this option is available. Clicking on this icon will display instructions on using this feature. Click and hold the icon, until the window title changes to "What's this..." and then click on a part of the application window to display the context sensitive help. </para> </section> <section><title>Launcher</title> <para> The Launcher is where applications can be started, and is similar in concept to the desktop found in most computer graphical user interfaces. When no other applications are running, it is visible, occupying most of the screen. </para> <para> Along the top of the Launcher is a series of tabs which function as categories for all installed applications. By default, there are the following tabs: PIM, Applications and Settings. If any games are installed, there will also appear a Games tab. To launch an application, click once on the application icon or name. The icon will darken and an hour glass will appear on the taskbar at the bottom of the screen to indicate that the application is launching. Most applications take 1 or 2 seconds to start. </para> <para> There is also a tab to the far right named Documents. It contains a listing of the documents found on the handheld device, allowing easy access. Documents are organized by document type and category. At the bottom of the Document tab are 2 selection boxes which allow the list of docuemnts to be filtered by these criteria. For instructions on adding and removing documents from this tab, see the <xref linkend="adddoc">. </para> <para> The Launcher Settings application on the Settings tab allows each tab's appearance to be customized. Items that can be configured include background color/image, font, icon size and more. See the Launcher Settings section for more information. </para> </section> <section><title>Taskbar</title> <para> The Taskbar is the small, horizontal section which appears at the bottom of the screen, below the Launcher. It is almost always visible while applications are running. The Taskbar provides the following functions (from left to right): </para> <para> 1. "O" menu - provides a listing of all installed applications, allowing them to be started if Launcher is not visible. It also provides an options to display Launcher if there are applications running, power off the handheld device and log out of &opie;. </para> <para> 2. Input methods - allows the selection of an input method. Each input method has its own, unique icon, and the current one selected is shown on the Taskbar. Click on the icon to display or hide the input method. If more than one method is installed, a small upward pointing arrow is shown to the right of the icon. Click on this arrow to select a different input method. </para> <para> 3. Running applications - if any applications are running, their icon will appear immediately to the right of the input method icon. Clicking on an icon will bring that application to the front so it can be viewed. When the application is exited, the icon will disappear from this area. </para> <para> 4. Applets - applets are "mini" applications which appear on the right side of the Taskbar. Some applets provide quick access to information (e.g. PC cards installed, wireless nework, etc.), while others provide frequently used functions (e.g. notepad, voice memo recorder). Clicking on an applet's icon usually provides a menu or window to access its features. </para> <para> 5. Clock - in reality just another applet, displays the current time. Clicking on the clock displays a dialog box which allows the time to be manually updated or syncronized over the Internet using the NTP protocol. </para> </section> <section><title>Dialogs</title> <para> In &opie;, dialogs, as well as some applications, have a button labeled "Ok" on the right side of the window title bar, in addition to the normal "x". For dialogs, the "Ok" button will apply your changes and close the window, while the "x" will cancel them before closing the window (for people used to most desktop GUI's the "Ok" and "x" behave like the "Ok" and "Cancel" buttons you would normally see in the bottom right of the dialog window). </para> <para> For applications that have an "Ok" button as well as the "x" button that all applications have, the "Ok" button will usually save the current file and then close the application, while the "x" button will close the application without saving. </para> </section> </chapter>