My favorites | Sign in
Project Logo
                
Search
for
Updated Jun 14, 2009 by jsippel
Labels: Featured
README  

#general readme file for microblog-purple

Introduction

This is a plug-in for Pidgin to allow for seamless updating and receiving of Twitter messages. While originally built for Pidgin it works for other LibPurple base clients like Adium and Finch. Currently the plug-in works with Twitter only.

So what's the different between this and Twitter IM? The answer is this would be kind of my personal replacement for Twitter IM, since I spent sometimes waiting for the service to come back and don't want to wait anymore. Besides, having it as plug-in give me some liberty to customize it in many ways. Like modifying the message to link to hashtags or twitter user (thanks @chanwit), or the ability to add special command to itself (/refresh, /replies, /etc....). I plan to have this in "Chat mode" instead of normal conversation windows for people who easily annoy with constant incoming messages.

The plug-in is inspired by FacebookChat project

Installation

Linux

For Ubuntu 8.04 Hardy Heron, we have PPA repository.

deb http://ppa.launchpad.net/sugree/ubuntu hardy main
deb-src http://ppa.launchpad.net/sugree/ubuntu hardy main

Simply install pidgin-microblog.

sudo apt-get install pidgin-microblog

Mac

Assuming Adium is already installed, download the "TwitterIM.AdiumLibpurplePlugin.zip" and unpack. Using Finder, click on the "Twitter.AdiumLibpurplePlugin" icon - MacOS will take it from there.

Building the code

Windows build

  1. Follow Building on Windows HOWTO
  2. Download microblog-purple source code, untar and place it in your $HOME.
  3. cd microblog-purple-x.x
  4. Edit global.mak, especially the PIDGIN_TREE_TOP variable to match your pidgin source directory.
  5. make && make install
  6. The built dll (libtwitter.dll) will be installed at <pidgin source dir>/win32-install-dir/plugins. All images will be installed there too. Run the new pidgin from win32-install-dir directory and it'll just work. You can copy the generated libtwitter.dll to your normal Pidgin installation directory. Don't forget to also copy all png images to the correct path.
  7. If you want to build windows installer, type make windist instead.

Linux build

  1. You will need to have libpurple and pidgin headers first. For Ubuntu, these are libpurple-dev and pidgin-dev packages
  2. Download microblog-purple source code and untar it somewhere
  3. cd microblob-purple-x.x && make && make install
  4. The executable will be installed in your pidgin plug-in installation dir, detected from pkg-config command. You can also modify variable and path in global.mak

Mac

  1. Make sure you have XCode installed
  2. Download and build the adium source. This will create several of the Frameworks that are required for the plugin
  3. Download the microblog source, placing it in the same parent directory as the adium source (not necessary, but then all the relative links should work automatically).
  4. Go to Project -> Active Target "TwitterIM" and ensure that all build paths are set appropriately for your computer.
  5. Build plugin
  6. to install, just click on "Products" and then TwitterIM.AdiumLibpurplePlugin.
  7. Please note that this plugin is only built and tested for Intel Macs running MacOS 10.5.x.

Comment by eionrobb, Mar 29, 2009

Good to hear you were inspired by the Facebook Chat prpl :)

Can you add to this readme, a how-to-use? I just spent the last half hour working out that you have to add a new account to use your plugin.

Comment by PhillKenoyer, Apr 03, 2009

x2 on the above. I still can't figure out how to actually use this in Adium. What server name do I use? It keeps asking for a server?

Comment by alovisco, Apr 04, 2009

this is the server: twitter.com ;)

Comment by kdenisb, Apr 06, 2009

I enabled Twitgin in Tools->Plugin But nothing happened.

I think that in same dialog window, I must enter my twitter name, but i can't find it.

/help me

Comment by kousiknandy, Apr 09, 2009

For 64-bit, you may have to edit global.mk to change the libdir lines to: LIBDIR := $(PREFIX)/lib64 so that .so files go in directories purple will look into.

Comment by jicheu, Apr 14, 2009

on adium, I can't figure where the reply link is or how to activate it :(

Comment by greggluhring, Apr 14, 2009

How can this thing have 5 stars if no one can figure out how to use it? wtf?

Comment by stiggley, Apr 20, 2009

Just installed it and its working fine.

Once you have installed it, enable the plugin from the Tools->Plugins menu. Then go to accounts and select 'Manage Accounts' Select 'Add' and then TwitterIM as the procotol then fill in your Twitter details.

Comment by horstp, Apr 21, 2009

Does this plugin work for finch as well? I am having trouble installing it under fedora. Any hints?

Comment by JarlMezentius, Apr 24, 2009

ok... this is listed as a plugin for Adium, The Macintosh only multi-messenger.

There is no Tools menu... WTF?!!

Comment by jelutz77, May 03, 2009

Apparently this won't work on a 64 bit system? It installs under my /usr/lib directory instead of my /usr/lib64 directory where pidgin is installed. When I move it to the correct place, it shows up in the plugins list, but I can't configure the twitter account.

Comment by AlexanderOgilvie, May 03, 2009

Dude this is the greatest plugin! It took me a while to get things sorted out (stiggley's post did it for me in the end) but I finally got it working! Goodbye Twitterific! Hello new improved Adium.

Comment by AlexanderOgilvie, May 04, 2009

Only thing is- Adium cant tell me when i've hit the character limit for a tweet. So tweets get cut short. Can this be fixed somehow?

Comment by diego.chacon, May 04, 2009

work on amd64 systems?

Comment by dancingcrane7, May 06, 2009

Running Adium 1.3.3 on PPC iBook g4 OS 10.5.6, 1.07GHz processor, 1.25 GB memory, 28 GB free space. This plug-in installed 'successfully', (I've even tried uninstalling and dl'ing again 4 times.)

I restarted adium, and there is no microblog-twitter optiom under add account.

Comment by ma...@ukr.net, May 06, 2009

И кто на Adium смог подключить twitter, чего то я не пойму как его активировать?

Comment by ma...@ukr.net, May 06, 2009

или я дурак или у меня, что то не так. Вот у меня нет нечего нового после добавления данного расширения: http://clck.ru/7-v. В Adium(1.3.4b3) само расширение установлено: http://clck.ru/7-w .

Comment by jeffrey.g.gomberg, May 16, 2009

I don't know how AlexanderOgilvie? was able to use Stiggley's post since there is no "Tools" menu option in the Mac version of Adium. Plugins are located under Adium - Xtra's Manager - Plugins and there are no configuration options for the plugin, nor any Twitter related appearances in the Adium - Preferences - Accounts list. Would the application author kindly post specific detailed instructions?

Comment by john.souter, May 17, 2009

Clear instructions for adding microblog-purple on Ubuntu Jaunty are here: http://sugree.com/project/microblog-purple

Comment by telejester, Jun 06, 2009

Fedora 10 instructions:

Prerequisite

yum install pidgin-devel 

Build

make
sudo make install
Comment by Travelingraggyman, Jun 18, 2009

At this time after working correctly for a while twitter plug in locks up and crashes pidgin on my laptop. which is has gotten my to finding somewhere to try to get help advice or pluck the bird. Have reinstalled many times and still connects then locks up everything.

TravelerinBDFSM@hotmail.com

Comment by dirkhh, Jun 20, 2009

It doesn't appear to show me direct messages to me...

Comment by mich.cook, Jul 08, 2009

@telejester (and other fedora folks) if you don't want to do the work compiling it, just do this:

yum install purple-microblog

i just pulled down 0.2.2-1 from fedora's updates repo.

Comment by absamide, Jul 10, 2009

I managed to catch an image of the Crash that seems to happen to me frequently with Pidgin shortly after it gets a Twitter update.

It is in an OpenOffice? Text document at http://home.comcast.net/~EQ_Edimas/PidginCrash.odt

Hopefully that information will help you sort out what it may be doing. I don't know if I will need to increase the size of the Debug window for Pidgin or not. This is the information that happened right before the application crashed.

My connections go through a Proxy server if it makes any difference.

Comment by haukeedeler, Jul 17, 2009

To avoid the key-Error do:

sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 0CF459B8DF37ED8B

Comment by govvin, Sep 02, 2009

I installed this on 64-bit Ubuntu 9.04 and it appears in the plugins list but I couldn't make it login to Twitter.

Eventually, twitter blocks my account for login errors. I'm using my twitter username. Or am I supposed to use my email address?

Comment by murwiz, Sep 08, 2009

Twitgin has been unusable for me; I have upgraded to the most recent version of Pidgin (Ubuntu 9.04), but as soon as I enable the Twitter account, Pidgin locks up (no X updates, no click response, nothing).

Comment by alerock, Oct 31, 2009

Its ok on my Fedora. Very nice work

Comment by Jeroen.Huttinga, Oct 31, 2009

On a Mac runing Snow Leopard >> it says it installed.... I can see the plugin under Adium>Xtras Manager>Plugins

But I can not add the Titter in Accounts.... What am I doing wrong?

Comment by abennouna, Nov 03, 2009

Same problem here, Snow Leopard 10.6.1. TwitterIM plugin it says it successfully installed, I see the plugin under Adium>Xtras Manager>Plugins

But I can not see any Microblog nor Twitter entry in Accounts types.

Comment by mrpraj, Nov 22, 2009

installed easily and successfully on my debian (lenny) i use twitter and identica more !! thanks very much

Comment by nxqd3051990, Nov 26, 2009

It works fine . Just enable Tools > plugins > check Twitter Then go to manage account ,add your twitter acc :)

Comment by eriksandall, Dec 02 (5 days ago)

I can't enable Twitgin because it doesn't show up in the list of plugins. I downloaded the installer, ran it, launched Pidgin, went to Tools > Plugins... no Twitgin. Halp!

  • Pidgin Portable 2.5.5
  • microblog-purple 0.2.4 for Pidgin Portable_2.5.x
  • Windows XP
Comment by eriksandall, Dec 02 (5 days ago)
I can't enable Twitgin because it doesn't show up in the list of plugins. I downloaded the installer, ran it, launched Pidgin, went to Tools > Plugins... no Twitgin. Halp!

Fixed. Installed version 0.2.2.


Sign in to add a comment
Hosted by Google Code