Author: NicoEchaniz (

django-live is a little application packaged for Django that adds comet(push) based chat capabilities to your project.

The current features are: - public chat rooms - guests allowed - public chat rooms for registered users - live help -> similar to PHPLive or HumanClick (only the chat functionality implemented so far)


You need orbited>=0.7.11beta2 [0] installed and Morbid properly configured.



You need to set up your orbited.cfg file to allow access to your STOMP broker port. You could add, for example (that's the standard port): [access] * -> localhost:61613

if you are accessing the orbited server through a public domain, you will need to change this to something like: * ->

To configure Morbid you may uncomment the stomp line in the orbited.cfg file to have it run automatically. You will also need to change the default orbited port if you will be running Django's web server on port 8000.

[listen] http://:9000 stomp://:61613 stomp.cfg


In your project you will need to add these settings (use your own values):

ORBITED_HOST = "localhost" # (use the domain name you used for orbited access). defaults to localhost ORBITED_PORT = "9000" # defaults to 9000 STOMP_PORT = "61613" # defaults to 61613

STOMP_RESTQ_URL = "/live/restq/"

Beware that the restq URL takes into account the domain set for the Site object obtained from django's get_current_site. So you MUST set that value correctly for Morbid to work.

This last setting must correspond to the setting in your stomp.cfg file. See below.

You will also need to add 'live' to your INSTALLED_APPS

And edit your project's to include live.urls. For example, you could add this line:

(r'live/', include('live.urls')),

If you do not use 'live/' as the "mount point" for django-live urls you will need to update this accordingly.


You need to create a stomp.cfg file telling Morbid where to access django-live RestQ

If you are accessing django on localhost port 8000 and you used 'live/' as your django-live "mount point" in your urls file, you need to add this line to your stomp.cfg file.

restq = http://localhost:8000/live/restq/

Don't forget to edit the corresponding Site in your database and set it's domain value accordingly.

Modify it as needed, to reflect your setup.


Orbited will have to be running in order to use django-live. You normally run it from your project path (where your orbited.cfg and stomp.cfg files live) like so:

$ orbited --config orbited.cfg

The following URL examples assume you are running the django web server on the standard port, you should strip the ":8000" part if you are serving your app on port 80 (from apache or any other server).

Asuming you have used the sample config from above, you may access the diferent features like this:

Open or join the default "public" chat room: localhost:8000/live

Open or join a named public chat room: localhost:8000/live/public/room_name

Open or join a named chat room for logged in users only: localhost:8000/live/chat/room_name

The generated channel names will be visible to the manager, who will then be able to asist the guests by clicking on each channel link.

Monitor what channels are open using: localhost:8000/live/manage


If you want to see how django-live works, you may run the included demo django project. Just open a terminal in the demo folder and run: $ orbited --config orbited.cfg then open a second terminal in the same location and run # ./ runserver

Now browse through the URLs described in the previous section.

Embedding in your website

django-live expects a live/base.html template to exist so you can override this template in your own project/app to inegrate the chat functionality.


django-live uses lettuce, selenium and Firefox for testing.

With these dependencies installed you can run the tests from the demo/ folder with the command

$ ./ harvest ../live/features

You should have no open Firefox processes when running the tests.

That's it so far.

Feel free to contact me with suggestions