# The &choqok; Handbook

Mehrdad
Momeny

    mehrdad.momeny@gmail.com

Anne-Marie
Mahfouf

    &Anne-Marie.Mahfouf.mail;

&FDLNotice;
2009-03-25
0.5

&choqok; is a micro-blogging client for KDE (http://choqok.gnufolks.org).

KDE
micro-blogging
client
Twitter
Identi.ca

## Introduction

&choqok; is a micro-blogging client which currently supports Identi.ca/Laconica and Twitter.com services.

Micro-blogging is a form of multimedia blogging that allows users to send brief text updates or micro media such as photos or audio clips and publish them. These can be viewed either by anyone or by a restricted group, which can be decided by the user. These messages can be submitted by a variety of means, including text messaging, instant messaging, email, digital audio or the web.

## Using &choqok;

### Getting Started

In the &choqok; main window there are some timelines allowing you to see what your friends have posted, replies to them and direct messages sent and received from friends. You can also post a new message.

All of this will be available when you configure at least one account in &choqok;.

Here's a screenshot of the &choqok; main window
&choqok; main window

You have one tab per account, on the screenshot you can see a tab with the alias identica and another with the alias twitter.

On top of the tab you can choose to send a direct message to someone who is subscribed to your account. You can send direct messages to other users of the same service, as long as both of you are subscribed to each other. If you leave Direct message to unchecked your message will be posted publicly and all your friends will read it. If you check it, you will then choose a name in the list and the private message will only be posted to this person.

The text area allows you to post your message which must have less than 140 characters. The number of characters left is displayed in green on bottom right under the text area. The color changes to orange when you reach the 30 characters limit then to red when you reach 0. If your message is longer than 140 characters, you'll be asked if you want to post it anyway. If you agree, it'll be posted up to 140 characters.

The Home tab displays the timeline which consists in all posts you and your friends wrote. A post using Identi.ca is called a dent while a post using Twitter is called a tweet.

The Reply tab displays posts that are replies to you.

All the private messages you sent will be displayed in the Outbox tab while the received ones will be displayed in the Inbox tab.

### Searching

You can search through services for something (anything that the service-search api can offer to a client).

This function is available via the Tools Search menu (shortcut: &Ctrl; F) For example you can search for a special word in all users' posts:

&choqok; search feature
&choqok; search feature

### Configuring an Account

Open the &choqok; configuration window via Settings Configure &choqok;... then go to the Accounts tab and click the Add button, the Add a new account window will appear.

Adding an account
Adding an account

Simply enter your desired unique alias, username and password and click the OK button. This will check your credentials and, if everything is okay, your account will be ready to use.

You can configure other accounts subsequently.

### Special Features

- You can disable the timeline updating of &choqok; (the timeline is the list of posts by you and your friends).

- Another special feature is the ability to notify the user about new received posts.

- You can do a quick post by pressing &Ctrl; T to open the quick micro-blog window and write your post: Quick posting dialog Quick posting dialog

  You can post the same text to all accounts at once.

- When new posts are received, &choqok; marks them as unread and shows the number of unread posts in the system tray icon. When the main window is shown and then minimized to system tray it then marks all new messages as read.

## Command Reference

### The Menu Items

#### The File Menu

&Ctrl;T File Quick Post

  Open the quick posting window.

F5 File Update Timelines

  Update timelines.

&Ctrl;R File Mark All As Read

  Mark all messages as read.

File Minimize

  Minimize &choqok; window to tray.

&Ctrl;Q File Quit

  Quit &choqok;.

#### The Tools Menu

&Ctrl;F Tools Search

  Open search window for current account.

#### The Settings Menu

&Ctrl;U Settings Enable Update Timer

  Toggle update timeline timer.

&Ctrl;N Settings Enable Notifications

  Toggle notifications.

Settings Show Statusbar

  Toggle the statusbar.

Settings Configure Shortcuts...

  Configure the keyboard shortcuts used by &choqok;.

Settings Configure Toolbars...

  Configure the items you want to put in the toolbar.

Settings Configure &choqok;...

  Display the &choqok; settings dialog.

In addition &choqok; has the well known Help menu items.

## Credits and Licenses

&choqok; copyright 2008-2009 Mehrdad Momeny (mehrdad.momeny AT gmail.com)

Documentation copyright 2009 Mehrdad Momeny (mehrdad.momeny AT gmail.com)

&underFDL; &underGPL;

## Installation

### How to Obtain &choqok;

&install.intro.documentation;

### Compilation and Installation

&install.compile.documentation;

&documentation.index;