Skip to main content

Easy scheduling for regular film nights

Project description


Simplify film selection for regular film nights. Participants can:

  • Add films
  • Vote for films
  • Declare absences
  • See the schedule which takes into account votes and absences

Admins can set the schedule of film nights.

This is a simple WSGI Web Application. The back-end is Django, and the front-end is dynamic HTML served by Django (no JavaScript is used).


  1. poetry install to set-up the virtualenv (one-off)
  2. poetry run ./src/vote4film/ migrate to set-up the local DB (one-off)
  3. poetry run ./src/vote4film/ runserver_plus
  4. make fix, make check and make test before committing


Pull requests are welcome :)


This application is published on PyPi.

  1. Ensure you have configured the PyPi repository with Poetry (one-off)
  2. Add the release notes in this
  3. poetry version minor to bump the major/minor/patch version
  4. poetry publish --build to release

To publish to the test repository:

  1. Ensure you have configured the Test PyPi repository with Poetry (one-off)
  2. poetry publish --build -r testpypi to upload to the test repository


Unfortunately, I will not provide detailed guidance for production deployment.

Some general tips:

  • Create a virtualenv, e.g. in ~/virtualenv
  • Install with pip install vote4film[postgres]
  • Write the configuration at ~/.config/vote4film/local.env
  • Use Postgres as the database
  • Use Nginx/uWSGI to to serve the site (with HTTPS)
  • Run Django management commands using ./virtualenv/bin/manage




v1.2.3 - 2020-02-01

  • Redirect to upcoming schedule after voting for every film
  • Fix HTTP 500 error when on schedule page without registering for the event

v1.2.2 - 2019-12-05

  • Fix HTTP 500 error when adding a film that was already added (again)
  • Highlight calender and vote links when there is a user action to take
  • Pick the oldest added film for upcoming when scores are a draw

v1.2.1 - 2019-11-21

  • Remove "film is not available" from the voting page
  • Remove "vote for this film" from the voting page
  • Fix the upcoming page asking absent users to register on calender

v1.2.0 - 2019-11-21

  • Fix ranking films with zero votes as number one
  • Hide upcoming film until the user has registered for the next event
  • Clarify what will happen when adding a film by giving the user more choices
  • Fix HTTP 500 error when adding a film that was already added
  • Hide a film's votes from the user until they have voted

v1.1.0 - 2019/11/16

  • Show the register of present/absent users for upcoming films
  • Fix not highlighting films that are not available to be watched
  • Fix parsing of "Not Rated" age ratings resulting in an error

v1.0.9 - 2019/11/13

  • Actually let's not be too dumb about packaging

v1.0.8 - 2019/11/13

  • Rename management command from vote4film to manage
  • Stop trying to be smart about packaging

v1.0.7 - 2019/11/13

  • The same fixes as v1.0.6 but for real this time

v1.0.6 - 2019/11/13

  • Fix url patterns for internal apps in installed environment
  • Fix missing template files in PyPi package (so typical!)

v1.0.5 - 2019/11/12

  • Add optional postgres support, e.g. pip install vote4film[postgres]

v1.0.4 - 2019/11/12

  • Fix bug loading config from XDG config home (sigh)
  • Fix django-extensions being missed from dependencies

v1.0.3 - 2019/11/12

  • Fix config sub-directory used in XDG config home

v1.0.2 - 2019/11/12

  • Load configuration from XDG config home

v1.0.1 - 2019/11/10

  • First release of Vote4Film

Project details

Download files

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

Files for vote4film, version 1.2.3
Filename, size File type Python version Upload date Hashes
Filename, size vote4film-1.2.3-py3-none-any.whl (47.1 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size vote4film-1.2.3.tar.gz (35.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page