# &app; Manual V&manrevision;

## Introduction

### What is &app;

&app; is a client for the social networking site Twitter. It lets users view in real time "twitters" or micro-blog posts on the Twitter website as well as publish their own. &app; is written to be as simple to use as possible and to allow users of the GNOME Desktop to keep in touch with friends.

### What is Micro-blogging

Micro-blogging is a form of blogging that allows users to write brief text updates (usually less than 200 characters) and publish them, either to be viewed by anyone or by a restricted group which can be chosen by the user. These messages can be submitted by a variety of means, including text messaging, instant messaging, email, MP3 or the web.

### What is Twitter

Twitter is a free social networking and micro-blogging service that allows users to send "updates" (or "tweets"; text-based posts, up to 140 characters long) to the Twitter website, via short message service (e.g. on a cell phone), instant messaging, or a third-party application such as &app;.

This section uses material from the Wikipedia articles "Micro-blogging" and "Twitter"

## Getting Started

### To Start &app;

You can start &app; in the following ways:

Applications menu

- Choose Internet Twitux .

Command line

- To start &app; from a command line, type `twitux` and then press Return.

### When You Start &app; the First Time

When you start &app; the first time, you will be shown the Twitter Account dialog, so that you can set up your Twitter account credentials.

1. - Enter your Twitter Username.

   - Enter your Twitter Password.

   - Select Show Password if you wish you to have your password visible in the Twitter Account dialog.

### When You Start &app;

When you start &app;, the following window is displayed.

#### &app; Main Window

Shows &app; main window. Contains titlebar, menubar, tweet list, and status icon. Menubar contains Twitter, Settings, View, and Help menus.

twitux-TBL-1 describes the components of a browser window.

### &app; Main Components

Component | Description
Menubar | Contains menus that are used to perform tasks in &app;.
Tweet List | Shows the latest tweets received from Twitter.

## Basic Usage

You can use the &app; application to perform the following tasks:

### Connect to Twitter

To connect to Twitter, choose Twitter Connect from the Menubar.

### Disconnect from Twitter

To disconnect from Twitter, choose Twitter Disconnect from the Menubar.

### Sending A Message

You can send message to Twitter, in the following ways:

- Choose Ctrl N Twitter New Message .

- Right click on &app;'s Notification Area icon, and select New Message.

### Sending A Direct Message

You can send direct message to your friends on Twitter, in the following ways:

- Choose Twitter Send Direct Message .

- Double-click on a tweet in the Tweet List to send a direct message.

## Settings

To configure &app;, choose Settings Preferences . The Preferences dialog contains the following tabbed sections:

### General

General

- - Select the Expand Messages option, to show the expanded message frame.

  - Select the Display notifications when message received option, to be notified when new tweets are received.

  - Select the Sound notification when message received option, to be notified when new tweets are received.

  - Select the Show user names instead real names option, to show friends Twitter user names instead of their real names.

  - Select Connect automatically if you wish to automatically log-in to Twitter when you start up &app;.

Timelines

- - Select the Default Timeline you wish to use from the drop-down list.

  - Select the time interval you wish to Retrieve every from the drop-down list.

### Spell Checking

These setting might not be available if spell checking capabilities were not compiled into &app;.

Languages

- - Select the languages you wish to enable for spell checking

  The list of languages only reflect the languages that have a dictionary installed.

Options

- - Select Enable spell checking, if desired.

## About &app;

&app; was written by Brian Pepple and Daniel Morales. To find more information about &app;, please visit the &app; Developer Page.

To report a bug or make a suggestion regarding this application or this manual, see the Feedback section of the GNOME User Guide.

This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found at this link, or in the file COPYING included with the source code of this program.