Bitly Bot is a utility tool that fetches the Topics that are Trending or are acknowledging sudden bursts of Traffic on Internet in Real Time, using Bitly' Social Data APIs. It outputs the Latest Hot and Bursting Stories along with the Most Popular Story Link associated with a Topic on the command line while giving Growl Notifications on Mac after every 20mins(set by default).
To proceed with the setup you need to have a fair knowledge about Ruby and RubyGems. In my local, I use RVM to control multiple Ruby versions setup.
Clone the repository or download the tar or zip file on your local:
$ git clone https://github.com/ApoorvSaxena/Bitly-Realtime-Topics.git
Environment and Dependencies
You need to install Bundler Gem to install gem dependencies.
$ gem install bundler
Now you need to run Bundler to install required gems on your local.
$ bundle install
After you have generated the Generic Access Token you need to replace the default access token in Config.yml file, present in the Application folder
Bitly-Bot allows you to get notifications when it fetches the latest Trending Topics and associated links from Bitly's Social Data APIs. Currently it provides notifications on Mac OS X using Growl Application.
If you are running Mac OS X, then you can download and install Growl on your Machine, we haven't provided a solution for getting Notifications on Windows or Linux, though you can search for one and contribute in our code.
Now that we have completed our installtion process, we simply need to run our Bitly-Bot as a daemon, which will output Trending and Bursting Topics in our Terminal after every X interval of time and will give Notification Popups on our screen.
$ bundle exec ruby bitly-bot.rb start
Though you would not want Bitly-Bot from running, but considering the case, when you don't want to get Real Time updates from the outside world while working on your machine, then you can run the following command from the Application Directory in any Terminal Window to stop Bitly-Bot
$ ruby bitly-bot.rb stop
You might want to delay the notifications from Bitly after every 20mins to the time that suits your comfort. To customize the delay you need to edit the delay parameter in config.yml from 20 to any value(measured in minutes).