seemantk / rupert

IRC interface to the Buffer App API

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

rupert

A cinch bot plugin to interface with BufferApp's API. At the moment, the only two commands it obeys are:

  • !status changes the channel topic to list all the profiles connected to your BufferApp account and some statistics.
  • !post adds to your BufferApp queue. The topic then will automatically refresh with updated account stats & info.

Requirements

To run this, you need to first install cinch and buff:

gem install cinch buff

Since this is all in ruby, I recommend using ruby and gems and all that stuff with rvm.

Pre-Installation

The best way to run this bot is on a small, lightweight irc server listening only on localhost. You can try ngircd: lightweight and really easy to install, configure & run. Connnect to that server with an irc client (pidgin, hexchat, quassel and irssi are popular choices) and create a channel that you will use to interact with Rupert. For example:

/join #bufferapp

Installation

Clone this repository. Follow github's instructions up there.

Configuration

Edit lib/cinch/plugins/rupert.rb and replace YOURKEYHERE with the your Buffer App access token. (Please keep the double-quote marks).

The top-level directory rupert.rb contains the IRC connection information. The following things can be replaced:

  • 127.0.0.1 with your irc server--if you change it, I hope it's on a secure vpn at least.
  • #bufferapp with the name of your irc channel.
  • rupert (c.nick: rupert) with whatever else you want to name the bot.

Running It

From the top-level directory, run

ruby rupert.rb

Ctrl C exits.

I don't know yet how to make this a proper installable cinch plugin, as cinch is just the quick proof of concept.

About

IRC interface to the Buffer App API

License:MIT License


Languages

Language:Ruby 100.0%