django-chatterbox 0.0.8

Django Chatterbox: Social listening made easy

Django Chatterbox is an Apache2 Licensed Social aggregation tool written with modularity in mind.

Aggregating content from multiple social networks is not so much fun. First you have to handle OAuth, then acquiring keys, managing keys, writing api’s to get data out of each social network, and then once you have it all, each social activity looks different.

This is a pain…a huge pain.

Enter Django Chatterbox. Chatterbox handles all of the oauth, keys, job creation, api’s, response iteration, and normalizing for you. All you have to provide is a social network key/secret, and Django Chatterbox does the rest.

Installation

Install using pip…

pip install django-chatterbox

Add ‘chatterbox’ to your INSTALLED_APPS setting.

INSTALLED_APPS = (

    'chatterbox',
)

Append urls to urls.py

urlpatterns = patterns(
    (r'^chatterbox/', include('chatterbox.urls', namespace="chatterbox")),
)

EXAMPLE TIME!!

Video demo here.

or:

• Go to instagram: https://instagram.com/developer/clients/manage/ and register an App

• Once you have the app created, go here: /admin/chatterbox/client/add/

• Fill out all Client model info using key/secret from instagram.com

• Once the Model is created, click on it in the admin. Should look like this:

  

• Select the permissions you require (most likely just read permissions)

• Click ‘get authorization’

• Follow the prompts redirecting you back to the admin

• You now have a key model added to the admin

• Next lets create a job, go here: /admin/chatterbox/job/add/

• Select Instagram, Instagram tag search, highlight your key, add a search term

• You now have everything you need to run a job. Lets execute it!

./manage.py shell
from chatterbox.models import Job
jobs = Job.objects.all()
job = jobs[0]
job.run()
# you will see...lots of stuff happen :)

How does it work?

Chatterbox comes with a few built in models and features. Here is a quick run down of what you all get…