heybuddy : a simple client


Heybuddy is a supposedly light, feature free, client licensed under GNU GPL v3.


Heybuddy is written in the Python language and has the following requirements:

  • Python
  • PyGTK (some distributions package it under the name pygtk2, some under just pygtk)
  • GTK
  • Python-gtkspell (optional)

ENABLING SPELL CHECK: Spell checking is supported if Aspell and the optional Python-gtkspell module are installed.

ENABLING NOTIFICATIONS: sending notifications is supported if the python-notifiy module is installed. Some sort of notification display application will need to be installed to view the notifications that heybuddy sends.


In the Accounts tab, enter your user name and password. Heybuddy will start pulling your dents and you can start sending dents.

At the bottom of the Heybuddy window is the text area. To send a dent, simply type your message and hit return.

CTRL+u: set focus on the 'update status' field
CTRL+l: clear and set focus on the 'update status' field
CTRL+w: closes the window when in 'run as tray app' mode
CTRL+q: quit


The Dents tab will show your personal time line. Here you will see your dents, and the dents of people or groups you follow.

The Mentions tab will show dents with your @username in them.

The Directs tab will display dents sent to you that are for your eyes only. To reply to a direct dent simply click the direct button.

To initiate a direct dent, start by clicking on the users name. This will bring you to the User Tab where you'll find a Direct Button. Clicking the direct button will bring you to the Directs Tab and you should now see "Direct Message To User" above the input field. Enter your message and the dent will be sent privately.

Clicking on Context in any dent will bring you to the Context tab. The whole conversation that dent belongs to will be pulled in, starting with the most recent, and finishing with the earliest dent of the conversation.

The Filters tab allows you to filter out messages by Tags, Groups, or Users. If a word is added to the Tag, Group, or User filter, Heybuddy will not display Dents containing that tag, group, or user.
For Example:

  • Suppose someone you follow is excited about their new vuvuzela and they constantly post about it and tag their posts with #vuvuzela. Entering "vuvuzela" in the Tag Filter will block dents marked with #vuvuzela from displaying in your "Dents" tab
  • Suppose the same person dents to the !vuvuzela group. Entering "vuvuzela" into the Group Filter will block dents marked !vuvuzela.

Remember, do not include the leading !, #, or @ in filters, they are already implied by which filter section you're using.

Clicking on a user's name will open up the User tab. You will then see recent dents by that user. There is also a check box if you want to follow, or stop following the user.

Clicking on a group tag inside a dent will open the Group tab. You can then see all dents for that group as well as the option to join/leave the group.

Manage your account and set some options. The default link color may not work well with your theme. To change it, type the name of the color you would rather use in the Link Color window. Heybuddy will start using that color for future dents.

About See some information about Heybuddy.

Thank You

Heybuddy wouldn't have been possible without users, testers, and bug reporters. Thank you one and all.