User:Harriseldon:Choqok: Difference between revisions

From KDE UserBase Wiki
No edit summary
No edit summary
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
ChoqoK
ChoqoK  


ChoqoK is a micro-blogging client for the KDE Desktop. Its features include:
[[File:Choqok_Home_new_message.png|400px]]
* Twitter and status.net integration including Identi.ca
* Twitpic integration
* Multiple simultaneous accounts
* Message search
* KWallet integration


Please see [http://choqok.gnufolks.org/] for a full feature list.
ChoqoK is a micro-blogging client for the KDE Desktop. Its features include:


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


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


ChoqoK supports connecting to Twitter and all sites that are based on status.net. This includes the flagship, Identi.ca, service.
== The Main Screen  ==


Each account, in addition to login credentials, includes an alias. The alias defines the resulting tabs in the main window.
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.  


''Note: At the time of this writing, status.net is defined by it's previous name Laconi.ca.''
Each account contains the following tabs: home; reply; inbox; and outbox.  


=== Home  ===


=== General Settings ===
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.


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.
=== Reply  ===


=== Notifications ===
The reply tab shows messages that were direct to you or in which you were mentioned.


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.
=== Inbox  ===


== The Main Screen ==
The inbox shows messages in the timeline to which you have subscribed. They are in reverse chronological order with the newest first.


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.
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.  


Each account contains the following tabs: home; reply; inbox; and outbox.
=== Outbox  ===


=== Home ===
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.


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.
== Configuring ChoqoK  ==


=== Reply ===
=== Creating an Account  ===


The reply tab shows messages that were direct to you or in which you were mentioned.
ChoqoK supports connecting to Twitter,Identi.ca, and all sites that are based on Status.net.  


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


The inbox shows messages in the timeline to which you have subscribed. They are in reverse chronological order with the newest first.
''Note: At the time of this writing, Status.net is defined by it's previous name Laconi.ca.''


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.
<br>


=== Outbox ===
=== General Settings  ===


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.
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.  


== Creating your First Message ==
=== Notifications  ===


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.
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.  


== Replying to Messages ==
== Creating your First 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.
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.  


Once you choose reply, the recipient is pre-populated in the message section. Type your message and press enter to send it.
== Replying to Messages  ==


== Direct 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.


When creating a message select the "Direct message to" checkbox to make the message private.
Once you choose reply, the recipient is pre-populated in the message section. Type your message and press enter to send it.  


== Details of a conversation ==
== Direct Messages  ==


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.
When creating a message select the "Direct message to" checkbox to make the message private.  


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


== Information about a User ==
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.


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.
If you hover your cursor over a message, the author's bio appears in the tooltip.  


=== Who is this user? ===
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.  
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 ===


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 ===


This option launches the search window showing tweets or dents that were directed at this user. For accounts that are based on status.net, 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 ===


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 ==


=== Quick Message ===
=== 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.  
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.''
''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.


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  ===


=== 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.


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  ===


=== Update Timelines ===
When choqoK is active, pressing F5 will refresh the timelines for all of your accounts.


When choqoK is active, pressing F5 will refresh the timelines for all of your accounts.
=== Insert Now Listening  ===


=== Insert Now Listening ===
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.


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.
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%.  


=== Other keyboard shortcuts ===
=== Other keyboard shortcuts ===


ctrl-F - Launch the find window
ctrl-F - Launch the find window ctrl-N - Toggle notifications ctrl-U - Toggle auto-updating of timelines  
ctrl-N - Toggle notifications
ctrl-U - Toggle auto-updating of timelines


= Links =
= Links =

Latest revision as of 04:00, 5 November 2009

ChoqoK

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.

Note: At the time of this writing, Status.net is defined by it's previous name Laconi.ca.


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 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.

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