Export translations

Settings

Group

Language

Format

Export for off-line translation

Export in native format

{|class="vertical-centered"
|[[Image:Choqok_Home_new_message.png|center|400px]]||'''Choqok is a micro-blogging client for the KDE Desktop.'''
|}

Its features include:

*Twitter and Status.net integration including Identi.ca 
*Twitpic integration 
*Multiple simultaneous accounts 
*Message search 
*'''KWallet''' integration

Please see [http://choqok.gnufolks.org/ this site] for a full feature list.

== The Main Screen  ==

The main screen of '''Choqok''' provides easy access to your accounts and messages. Each account, denoted by its alias, has a tab. When new messages are received, the unread count appears in the account tab.

Each account contains the following tabs: <menuchoice>Home</menuchoice>, <menuchoice>Reply</menuchoice>, <menuchoice>Inbox</menuchoice> and <menuchoice>Outbox</menuchoice>.

=== Home  ===

The <menuchoice>Home</menuchoice> tab contains all of the messages to which you are subscribed. Each message in the timeline includes the message, avatar, time sent (relative to now), and information on the micro-blogging client used.

=== Reply  ===

The <menuchoice>Reply</menuchoice> tab shows messages that were direct to you or in which you were mentioned.

=== Inbox  ===

The <menuchoice>Inbox</menuchoice> shows messages in the timeline to which you have subscribed. They are in reverse chronological order with the newest first.

When reading a message you can click on tags, denoted by #, groups, denoted by&nbsp;!, or users, denoted by @. If you select a group or tag, the search window will open with ''tweets'' or ''dents'' for this group or about this topic. If you select a user, you can choose for what to search. The exact options depend on the capabilities of the network. '''Twitter''' supports one additional for tweets including this user.

=== Outbox  ===

The <menuchoice>Outbox</menuchoice> is arranged in reverse chronological and shows the private messages that you have sent. Private messages are sent directly to a specific user. See [[#Direct Messages|Direct Messages]] for details on creating a private message.

== Configuring Choqok  ==

=== Creating an Account  ===

'''Choqok''' supports connecting to Twitter, Identi.ca, and all sites that are based on Status.net.

Each account, in addition to login credentials, includes an alias. The alias defines the resulting tabs in the main window.

=== General Settings  ===

The general settings provides access to common settings. Key settings include the update interval, default 10 minutes, and the number of new messages retrieved per account, default 20.

=== Notifications  ===

'''Choqok''' integrates well with desktops supporting both '''knotify''' (KDE) and '''libnotify''' (Gnome, XFCE). You can also group new notifications. Please note that when starting '''Choqok''', you may receive more than 20 notifications if you have more than 1 account or your configuration allows for more messages. This may fill your screen depending on your resolution.

== Creating your First Message  ==

Begin typing your message in the message area. As you type a message the remaining characters will countdown toward 0 from 140. When you have completed your message, press <keycap>Enter</keycap>. If the message is successfully posted, it appears in your inbox.

== Replying to Messages  ==

When reading a message in the timeline, you can click on the <menuchoice>Reply</menuchoice> button. This button appears as you hover over the avatar for the creator of that message.

Once you choose <menuchoice>Reply</menuchoice>, the recipient is pre-populated in the message section. Type your message and press <keycap>Enter</keycap> to send it. 
<span id="Direct Messages"></span>
== Direct Messages  ==

When creating a message select the <menuchoice> Direct message to</menuchoice> checkbox to make the message private.

== Details of a conversation  ==

Each conversation contains an avatar at the far left and information about the user in the bottom right. This information includes the author's handle, how long ago the message was sent, and the client the author used to create the message.

If you hover your cursor over a message, the author's bio appears in the tooltip.

For Identi.ca, you can see the full conversation by clicking on the <menuchoice>Show Conversation</menuchoice> button located in the bottom right of the conversation.

== Information about a User  ==

When you click on the author's handle in a conversation or a user mentioned in the message, you can retrieve information about the user from the popup menu.

=== Who is this user?  ===

This option is only available when clicking on the author's handle. It will show a popup containing the user's avatar, full name, location web site, and bio. You may subscribe to this user as well by clicking the add icon in the upper right.

=== From this user  ===

This option launches the search window showing tweets or dents created by this user.

=== Replies to this user  ===

This option launches the search window showing tweets or dents that were directed at this user. For Identi.ca, this will also emulate the including this user feature of the Twitter network.

=== Including this user  ===

This option is only available with users on the Twitter network. It launches the search window showing any tweet that contains this user, but is not from this user.

== Keyboard Shortcuts  ==

=== Quick Message  ===

To create a quick message, you can use <keycap>Ctrl + T</keycap>. This will launch a small window in which you can type your message.

{{Tip|1= If the window does not appear, you can use the KDE global shortcut <keycap>Ctrl + Alt + A</keycap> to bring the '''Choqok''' window to the foreground and display the message window.}}

If '''Choqok''' is not in the foreground, i.e. minimized to the system tray, you can use <keycap>Meta + Ctrl + T</keycap>. On most computers, the <keycap>Meta</keycap> key has the Windows logo. On computers manufactured by Apple, this is the <keycap>Option</keycap> key.

=== Mark All Read  ===

When '''Choqok''' is active, you can use <keycap>Ctrl + R</keycap> to mark all of the messages as read. You can also close the '''Choqok''' window via the <menuchoice>Close</menuchoice> button. This will not actually exit '''Choqok''': instead it will minimize it to the tray.

=== Update Timelines  ===

When '''Choqok''' is active, pressing <keycap>F5</keycap> will refresh the timelines for all of your accounts.

=== Insert Now Listening  ===

'''Choqok''' provides integration with [[Special:myLanguage/Amarok|Amarok]]. Pressing <keycap>Ctrl + L</keycap> when '''Choqok''' is active will insert information about the current track playing in '''Amarok'''. The exact information posted is configured in the general settings.

The default now listening message is <blockquote>Currently listening to&nbsp;%title% by&nbsp;%artist% on&nbsp;%album% [Amarok].</blockquote> The words surround by "%" represent fields taken from the currently playing track. Possible fields include %title%,&nbsp;%album%,&nbsp;%artist%,&nbsp;%year%,&nbsp;%genre%, and ;%track%.

=== Other keyboard shortcuts  ===

<keycap>Ctrl + F</keycap> - Launch the find window, <keycap>Ctrl + N</keycap> - Toggle notifications, <keycap>Ctrl + U</keycap> - Toggle auto-updating of timelines.

== Links ==

[[Category:Internet]]