Skip to content
Upcoming events list application for Django.
Python HTML
Branch: develop
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.


Django Events

A simple upcoming events calendar for Django.

TravisCI Build Status

Installation via PIP

$ pip install -e git://

Installation from Source

$ git clone git://
$ cd django-events
$ python install


Setup the Project For the Application

Add to the INSTALLED_APPS tuple in the project's settings file:


In the project's file add:

from django.conf.urls import include
url(r'^events/', include('events.urls', namespace='events')),

A list of upcoming events can now be linked to:

<a href="{% url 'events:events_list' %}">Events</a>

The RSS feed of upcoming events can now be referred to in the <head> of your HTML templates:

<link rel="feed alternate" type="application/rss+xml" title="Events" href="{% url 'events:events_feed' %}" />

Configure the Templates

By default the templates contain only the bare necessities. To override the default templates, create a directory called events in your templates directory and copy the templates from the project into that directory in order to make adjustments to them. If you're using VirtualEnv, cd to the root of the Django project and execute the following command:

$ cp -r $VIRTUAL_ENV/src/django-events/events/templates/events templates/events


$ python test

With TOX

First, install Tox, then run the tests. This will test against the Django versions specified in the environments specified in the tox.ini file

$ pip install tox
$ tox
You can’t perform that action at this time.