ChoqoK/Using ChoqoK: Difference between revisions

From KDE UserBase Wiki
m (Typo)
(Removed an outdated comment.)
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Template:I18n/Language Navigation Bar|ChoqoK/Using ChoqoK}}
<languages />
[[File:Choqok_Home_new_message.png|400px]]
<translate>


ChoqoK is a micro-blogging client for the KDE Desktop. Its features include:
<!--T:1-->
{|class="vertical-centered"
|[[Image:Choqok_Home_new_message.png|center|400px]]||'''Choqok is a micro-blogging client for the KDE Desktop.'''
|}


<!--T:2-->
Its features include:
<!--T:3-->
*Twitter and Status.net integration including Identi.ca  
*Twitter and Status.net integration including Identi.ca  
*Twitpic integration  
*Twitpic integration  
*Multiple simultaneous accounts  
*Multiple simultaneous accounts  
*Message search  
*Message search  
*KWallet integration
*'''KWallet''' integration


<!--T:4-->
Please see [http://choqok.gnufolks.org/ this site] for a full feature list.  
Please see [http://choqok.gnufolks.org/ this site] for a full feature list.  


== The Main Screen  ==
== The Main Screen  == <!--T:5-->


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.  
<!--T:6-->
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: home; reply; inbox; and outbox.  
<!--T:7-->
Each account contains the following tabs: <menuchoice>Home</menuchoice>, <menuchoice>Reply</menuchoice>, <menuchoice>Inbox</menuchoice> and <menuchoice>Outbox</menuchoice>.  


=== Home  ===
=== Home  === <!--T:8-->


The home 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.  
<!--T:9-->
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  ===
=== Reply  === <!--T:10-->


The reply tab shows messages that were direct to you or in which you were mentioned.  
<!--T:11-->
The <menuchoice>Reply</menuchoice> tab shows messages that were direct to you or in which you were mentioned.  


=== Inbox  ===
=== Inbox  === <!--T:12-->


The inbox shows messages in the timeline to which you have subscribed. They are in reverse chronological order with the newest first.  
<!--T:13-->
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.  
<!--T:14-->
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  ===
=== Outbox  === <!--T:15-->


The outbox 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]] for details on creating a private message.  
<!--T:16-->
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 ==
== Configuring Choqok == <!--T:17-->


=== Creating an Account  ===
=== Creating an Account  === <!--T:18-->


ChoqoK supports connecting to Twitter,Identi.ca, and all sites that are based on Status.net.  
<!--T:19-->
'''Choqok''' supports connecting to Twitter, Identi.ca, and all sites that are based on Status.net.  


<!--T:20-->
Each account, in addition to login credentials, includes an alias. The alias defines the resulting tabs in the main window.  
Each account, in addition to login credentials, includes an alias. The alias defines the resulting tabs in the main window.  


''Note: At the time of this writing, Status.net is defined by it's previous name Laconi.ca.''
=== General Settings  === <!--T:23-->


<br>  
<!--T:24-->
 
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.
=== 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  === <!--T:25-->


=== Notifications  ===
<!--T:26-->
'''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.


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  == <!--T:27-->


== Creating your First Message  ==
<!--T:28-->
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.


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 enter. If the message is successfully posted, it appears in your inbox.
== Replying to Messages  == <!--T:29-->


== Replying to Messages  ==
<!--T:30-->
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.


When reading a message in the timeline, you can click on the reply button. This button appears as you hover over the avatar for the creator of that message.  
<!--T:31-->
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.  


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


== Direct Messages  ==
== Direct Messages  == <!--T:32-->


When creating a message select the "Direct message to" checkbox to make the message private.  
<!--T:33-->
When creating a message select the <menuchoice> Direct message to</menuchoice> checkbox to make the message private.  


== Details of a conversation  ==
== Details of a conversation  == <!--T:34-->


<!--T:35-->
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.  
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.  


<!--T:36-->
If you hover your cursor over a message, the author's bio appears in the tooltip.  
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 "Show Conversation" button located in the bottom right of the conversation.  
<!--T:37-->
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  ==
== Information about a User  == <!--T:38-->


<!--T:39-->
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.  
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?  ===
=== Who is this user?  === <!--T:40-->


<!--T:41-->
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.  
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  ===
=== From this user  === <!--T:42-->


<!--T:43-->
This option launches the search window showing tweets or dents created by this user.  
This option launches the search window showing tweets or dents created by this user.  


=== Replies to this user  ===
=== Replies to this user  === <!--T:44-->


<!--T:45-->
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.  
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  ===
=== Including this user  === <!--T:46-->


<!--T:47-->
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.  
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  ==
== Keyboard Shortcuts  == <!--T:48-->


=== Quick Message  ===
=== Quick Message  === <!--T:49-->


To create a quick message, you can use ctrl-T. This will launch a small window in which you can type your message.  
<!--T:50-->
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: If the window does not appear, you can use the KDE global shortcut ctrl-alt-a to bring the choqoK window to the foreground and display the message window.''
<!--T:51-->
{{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 Meta-Ctrl-T. On most computers, the meta key has the Windows logo. On computers manufactured by Apple, this is the option key.  
<!--T:52-->
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  ===
=== Mark All Read  === <!--T:53-->


When choqoK is active, you can use ctrl-r to mark all of the messages as read. You can also close the choqoK window via the close button. This will not actually exit choqoK; instead it will minimize it to the tray.  
<!--T:54-->
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  ===
=== Update Timelines  === <!--T:55-->


When choqoK is active, pressing F5 will refresh the timelines for all of your accounts.  
<!--T:56-->
When '''Choqok''' is active, pressing <keycap>F5</keycap> will refresh the timelines for all of your accounts.  


=== Insert Now Listening  ===
=== Insert Now Listening  === <!--T:57-->


ChoqoK provides integration with Amorok. Pressing ctrl-L when choqoK is active will insert information about the current track playing in Amorok. The exact information posted is configured in the general settings.  
<!--T:58-->
'''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 "Currently listening to&nbsp;%title% by&nbsp;%artist% on&nbsp;%album% [Amarok]." The words surround by&nbsp;% represent fields taken from the currently playing track. Possible fields include&nbsp;%title%,&nbsp;%album%,&nbsp;%artist%,&nbsp;%year%,&nbsp;%genre%, and&nbsp;%track%.  
<!--T:59-->
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  ===
=== Other keyboard shortcuts  === <!--T:60-->


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


= Links =
== Links == <!--T:62-->


<!--T:63-->
[[Category:Internet]]
[[Category:Internet]]
</translate>

Latest revision as of 14:19, 24 April 2013

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 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: Home, Reply, Inbox and Outbox.

Home

The Home 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 Reply tab shows messages that were direct to you or in which you were mentioned.

Inbox

The Inbox 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 !, 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 Outbox 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 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 Enter. 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 Reply button. This button appears as you hover over the avatar for the creator of that message.

Once you choose Reply, the recipient is pre-populated in the message section. Type your message and press Enter to send it.

Direct Messages

When creating a message select the Direct message to 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 Show Conversation 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 Ctrl + T. This will launch a small window in which you can type your message.

Tip

If the window does not appear, you can use the KDE global shortcut Ctrl + Alt + A 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 Meta + Ctrl + T. On most computers, the Meta key has the Windows logo. On computers manufactured by Apple, this is the Option key.

Mark All Read

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

Update Timelines

When Choqok is active, pressing F5 will refresh the timelines for all of your accounts.

Insert Now Listening

Choqok provides integration with Amarok. Pressing Ctrl + L 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

Currently listening to %title% by %artist% on %album% [Amarok].

The words surround by "%" represent fields taken from the currently playing track. Possible fields include %title%, %album%, %artist%, %year%, %genre%, and ;%track%.

Other keyboard shortcuts

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

Links