legistream (legistream-site)

Legistream is the easiest way to stream Australian parliaments live. Legistream bypasses the need to use the often slow and outdated state/territory parliament websites, streamlining the experience. Legistream also bypasses the need to use a Flash player on both the NT and QLD websites, offering a more secure viewing option for people interested in those jurisdictions.

Legistream uses our Python package legistream-backend to gather stream URLs and metadata from the parliament sites.

• We also plan to integrate Aus-Bills in some form in the future.

Setup

Install RabbitMQ

You can find instructions for different hosts here.

Virtual Environment

Begin by setting up a virtual environment:

pip3 install virtualenv

virtualenv legistr_venv

Windows

legistr_venv/Scripts/activate

Linux/MacOS

source legistr_venv/bin/activate

You should now be loaded into the virtual environment, and your terminal should look like this:

(legistr_venv) /.../git/legistream-site/ >

Install Dependencies

pip3 install -r requirements.txt

Create secrets.py

In legistream_site/, make a file called secrets.py. Inside it, create these two constants:

ADMIN_PATH = 'your server admin path'
SECRET_KEY = 'your server secret key' # Look at the Django docs for more info

The application will work if you just throw in random garbage, but do not leave ADMIN_PATH blank!

Set DEBUG = True

In legistream_site/settings.py change the line:

DEBUG = False

to

DEBUG = True

Running Legistream

On first run:

python3 manage.py migrate

Start the Celery worker:

celery -A legistream_site worker -l info --pool=solo

Start Celery Beat:

celery -A legistream_site beat -l info

To run the server, use this command:

python3 manage.py runserver

If you get any errors, make sure you've set up your virtual environment correctly and that you've installed all the required dependencies.

You should now be able to access Legistream by going to localhost:8000 in your browser.