comparison README @ 235:bc83dabf9d0e

- updated README to describe 0.8.0. - fixed a minor glitch in prefs.ui.

234:7443fd51a00b

pidgin-twitter-0.7.0


1. What is this?

pidgin-twitter is a Pidgin plugin to help posting and reading micro

    * display user icon (size configurable)
    * translate sender's name and @<username> to link to the user's
      home
    * play sounds for specific senders/recipients
    * show letter counter on the format toolbar

Twitter specific
    * get/post Twitter statuses via API
    * escape pseudo commands like "w"
    * suppress oops message return

Wassr specific
    * Translate #<channel name> to link to the channel
    * eliminate annoying post completion messages

identi.ca specific
    * eliminate annoying echo backed messages.


2. Dependency

This plugin requires Pidgin 2.4.0 or newer, glib-2.14.0 or newer and

4.2.3 Translate channel name to link

This checkbox toggles translation from a channel name to the link to
the channel. This feature is available only for Wassr.

4.3 Icon page

4.3.1 Show icon in conversations

This checkbox toggles show/hide icons for users in conversations.

4.3.2 Icon size

Icon size in conversations can be specified by this spin button.

4.3.3 Enable update

This checkbox toggles update for icons by the specified period. See
below for the period.

4.3.4 Update period

You can specify update period here in two ways. The first is the
number of times showing one particular icon before update. The second
is days before update.

4.4 Sound page

4.4.1 Play sound on a reply to a specified recipient

This checkbox toggles play sound for a specified recipient.

pidgin-twitter can play a sound when an incoming message contains any
recipient name in the recipient list explained bellow.

It is convenient that add your screen name to the recipient list and
turn this feature on so that you can audibly notice each arrival or
message to you.

4.4.2 Recipient list

Recipient list accommodates names of watched recipients. This list is
a enumeration of usernames separated by a letter in ",:;" and spaces.
For example, "foo bar" or "foo,bar" is a valid user list and a list like
"foo, bar" also works.

4.4.3 Sound type

You can specify event type of sound to be played here. The "Pounce
Default" sound is the default sound type because it may not be
disabled by configuration in Pidgin's preferences. You can specify
other sounds, but be aware, you have to enable the event type of sound
which you specified for pidgin-twitter in Pidgin's preferences.

4.4.4 Play sound on a message from a specified sender

This is the same as 4.4.1 except that it is for senders.

4.4.5 Sender list

This is the same as 4.4.2 except that sender list accommodates names
of watched senders.

4.4.6 Sound type

This is the same as 4.4.3 except that it is for senders.

4.5 Utility page

4.5.1 Show text counter

This checkbox toggles letter counter. If it is enabled, a small letter
counter widget will appear on the format bar in a Pidgin conversation
window. This counter keeps track of length of composing string in
character. Each service has its own limit of length for posting
messages; 140 characters in Twitter, 255 characters in Wassr and 140
bytes in identi.ca. If the composing message exceeds the limit, the
displayed number will turn red to notify you the excess.

4.5.2 Escape pseudo command for Twitter

This checkbox toggles escape pseudo command functionality.

A pseudo command is a message composed of leading non Latin string and
trailing an alphabet letter which can be interpreted as a command in

message so that Twitter gives you an error massage.

If this feature is enabled, pidgin-twitter automatically escapes any
pseudo command by prepend ". " at the beginning of a message.

4.5.3 Suppress oops message

This checkbox toggles suppress oops message feature for Twitter
conversation.

This feature may require explanation. If we send a message which is

hard limit in internal representation of characters so that the
messages which does not exceed 140 letters can actually be
accepted. This feature will silently discard *false* oops message in
this situation.

4.5.4 Do not notify incoming message (Windows only)

This checkbox toggles suppression of blinking Pidgin's task bar button
for new incoming message when Pidgin window is not active.

4.5.5 Output log message

This checkbox toggles log messages for debugging. If you have any
trouble, we suggest to enable this feature and report us your problem
with obtained information.

- Translation from channel name to the link to the channel in Wassr
  has been added.
- Disabling notification on message arrival now works for Wassr and
  identi.ca too.

6. Acknowledgments

In the beginning of development, I (yazuuchi) got a number of valuable
feedbacks from nosuke (@konosuke) and mojin (@mojin).

235:bc83dabf9d0e

pidgin-twitter-0.8.0 beta 1


1. What is this?

pidgin-twitter is a Pidgin plugin to help posting and reading micro

    * display user icon (size configurable)
    * translate sender's name and @<username> to link to the user's
      home
    * play sounds for specific senders/recipients
    * show letter counter on the format toolbar
    * filter messages from specified users

Twitter specific
    * get/post Twitter statuses via API
    * escape pseudo commands like "w"
    * suppress oops message return

Wassr specific
    * translate #<channel name> to link to the channel
    * eliminate annoying post completion messages
identi.ca specific
    * translate #<tag> to link to the tag
    * eliminate annoying echo backed messages


2. Dependency

This plugin requires Pidgin 2.4.0 or newer, glib-2.14.0 or newer and

4.2.3 Translate channel name to link

This checkbox toggles translation from a channel name to the link to
the channel. This feature is available only for Wassr.

4.3 Filter page

4.3.1 Apply filter

This checkbox toggles filter functionality. If it is enabled, messages
from the users who reside in "to be filtered list" will be filtered
and be discarded silently.

4.3.2 Exclude reply to me

If it is enabled, messages which contain @<your screen name> will be
excluded from filtering.

4.3.3 Users to be filtered

These lists accommodate users to be filtered. A list is a enumeration
of usernames separated by a letter in ",:;" and spaces.  For example,
"foo bar" or "foo,bar" is a valid user list and a list like "foo, bar"
also works.

4.4 Icon page

4.4.1 Show icon in conversations

This checkbox toggles show/hide icons for users in conversations.

4.4.2 Icon size

Icon size in conversations can be specified by this spin button.

4.4.3 Enable update

This checkbox toggles update for icons by the specified period. See
below for the period.

4.4.4 Update period

You can specify update period here in two ways. The first is the
number of times showing one particular icon before update. The second
is days before update.

4.5 Sound page

4.5.1 Play sound on a reply to a specified recipient

This checkbox toggles play sound for a specified recipient.

pidgin-twitter can play a sound when an incoming message contains any
recipient name in the recipient list explained bellow.

It is convenient that add your screen name to the recipient list and
turn this feature on so that you can audibly notice each arrival or
message to you.

4.5.2 Recipient list

Recipient list accommodates names of watched recipients. This list is
a enumeration of usernames separated by a letter in ",:;" and spaces.
For example, "foo bar" or "foo,bar" is a valid user list and a list like
"foo, bar" also works.

4.5.3 Sound type

You can specify event type of sound to be played here. The "Pounce
Default" sound is the default sound type because it may not be
disabled by configuration in Pidgin's preferences. You can specify
other sounds, but be aware, you have to enable the event type of sound
which you specified for pidgin-twitter in Pidgin's preferences.

4.5.4 Play sound on a message from a specified sender

This is the same as 4.5.1 except that it is for senders.

4.5.5 Sender list

This is the same as 4.5.2 except that sender list accommodates names
of watched senders.

4.5.6 Sound type

This is the same as 4.5.3 except that it is for senders.

4.6 Utility page

4.6.1 Show text counter

This checkbox toggles letter counter. If it is enabled, a small letter
counter widget will appear on the format bar in a Pidgin conversation
window. This counter keeps track of length of composing string in
character. Each service has its own limit of length for posting
messages; 140 characters in Twitter, 255 characters in Wassr and 140
bytes in identi.ca. If the composing message exceeds the limit, the
displayed number will turn red to notify you the excess.

4.6.2 Escape pseudo command for Twitter

This checkbox toggles escape pseudo command functionality.

A pseudo command is a message composed of leading non Latin string and
trailing an alphabet letter which can be interpreted as a command in

message so that Twitter gives you an error massage.

If this feature is enabled, pidgin-twitter automatically escapes any
pseudo command by prepend ". " at the beginning of a message.

4.6.3 Suppress oops message

This checkbox toggles suppress oops message feature for Twitter
conversation.

This feature may require explanation. If we send a message which is

hard limit in internal representation of characters so that the
messages which does not exceed 140 letters can actually be
accepted. This feature will silently discard *false* oops message in
this situation.

4.6.4 Do not notify incoming message (Windows only)

This checkbox toggles suppression of blinking Pidgin's task bar button
for new incoming message when Pidgin window is not active.

4.6.5 Output log message

This checkbox toggles log messages for debugging. If you have any
trouble, we suggest to enable this feature and report us your problem
with obtained information.

- Translation from channel name to the link to the channel in Wassr
  has been added.
- Disabling notification on message arrival now works for Wassr and
  identi.ca too.

0.8.0 beta 1 (September 29 2008)
- Filter functionality has been added.
- Translation from tag name to the link to the tag in identi.ca
  has been added.
- Many improvements and bug fixes.


6. Acknowledgments

In the beginning of development, I (yazuuchi) got a number of valuable
feedbacks from nosuke (@konosuke) and mojin (@mojin).