Skip to content


Switch branches/tags

Latest commit


Git stats


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

HTML seating plan for council meetings Münster

This repository reads council member information from oparl and generates a HTML from it. Sadly, the seating information is not part of oparl and needs to be entered manually.

How does it work?

  • The script will read all board members of a committee via OParl API interface and then write the member list to the file config-members.json, if the file does not exist.
  • If the file exists, then it will read the seating information from the field seat of every member and then render the committee seating plan to the file index.html


    # Step 1: On the first run, the file config-members.json will be generated:

    # Step 2: Manually enter the seating information
    # Now you can open the file `config-members.json`
    # and fill out all the seating information in the fields `seat`.

    # Step 3: Run again to generate the index.html

Local development instructions

It is easier to fill out the seating information if you get "live feedback". That is why you should do the following:

  1. Open shellwindow #1 to watch config files for changes and run our python-script to regenerate the Rats-Sitzplan:

    # Watch for file changes and run generateSitzplan
    #   "-f" => File to watch (can be repeated)
    #   "-c" => Command to execute on file change
    inotify-hookable -f config-members.json -f -c 'python3'
    # Alternative version:
    #   "-w" => Directory to watch ("dot" = current dir)
    #   "-i" => File patterns to ignore (we ignore html files, because they will be generated, which triggers a recursive call)
    inotify-hookable -w . -i *.html config-members.json -f -c 'python3'
  2. Open Shellwindow #2 to serve the HTML:

        # Run http server
        python3 -m http.server 8000
  3. Open the file config-members.json in your favourite editor (e.g. VSCode) and enter the seating information

  4. Point your webbrowser to localhost:8000 and reload from time to time

Pre 2020 version

We have an old version of this script that basically does exactly the same. The difference is that it uses gatsby.js instead of vanilla python. You can find the old version in the directory "2019".