Skip to main content

Get live stream metadata from the various Australian parliaments.

Project description


This is the Python backend for legistream.

Install with pip:

pip install legistream-backend

View project on PyPI:


This package uses different modules to get live stream data from the various Australian parliaments.

Currently supported parliaments:

  • Australian Capital Territory
  • Federal
  • New South Wales
  • Northern Territory
  • Queensland
  • South Australia
  • Tasmania
  • Victoria
  • Western Australia


  1. Install poetry:

    pip3 install poetry
  2. Install/update dependencies with poetry:

    poetry update

Install ffmpeg:


sudo apt install ffmpeg


Install with brew:

brew install ffmpeg


Official Windows builds of ffmpeg can be found here

Print out stream URLs:

Every parliament module returns data the same way, Victoria is used here only for example purposes.

The stream_urls property can be used to return streams as a dict:

from legistream_backend.vic import Stream


Each URL can be returned individually by using the [house]_stream_url property (e.g lower_stream_url)


Check if a parliament's house is live:

Similarly, you can check the status of a live stream with the [house]_is_live boolean property.

    print('The lower house of Victoria is currently live.')
    print('The lower house of Victoria is not currently live.')


  1. Run all scripts using poetry:

    poetry run python3 [file].py
  2. The South Australia stream extractor uses code adapted from the streamlink ustreamtv implementation.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

legistream-backend-1.4.17-2.tar.gz (15.0 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page